Distribuera och hantera klustertillägg för Azure Kubernetes Service (AKS) (förhandsversion)

  • Artikel
  • 8 minuter för att läsa

Klustertillägg ger en Azure Resource Manager för installation och livscykelhantering av tjänster som Azure Machine Learning (ML) i ett AKS-kluster. Med den här funktionen kan du:

  • Azure Resource Manager-baserad distribution av tillägg, inklusive storskaliga distributioner över AKS-kluster.
  • Livscykelhantering av tillägget (Uppdatera, Ta bort) från Azure Resource Manager.

I den här artikeln får du lära dig mer om:

  • Så här skapar du en tilläggsinstans.
  • Tillgängliga klustertillägg på AKS.
  • Visa, visa, uppdatera och ta bort tilläggsinstanser.

En konceptuell översikt över den här funktionen finns i artikeln Klustertillägg Azure Arc kubernetes.

Viktigt

AKS-förhandsgranskningsfunktioner är tillgängliga via självbetjäning och avanmälning. Förhandsgranskningar tillhandahålls i "i dess omfattning" och "i den omfattning som är tillgänglig", och de är undantagna från serviceavtalen och den begränsade garantin. AKS-förhandsversioner omfattas delvis av kundsupporten baserat på bästa möjliga resultat. Därför är dessa funktioner inte avsedda för produktionsanvändning. Mer information finns i följande supportartiklar:

Förutsättningar

  • En Azure-prenumeration. Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto.
  • Azure CLI version >= 2.16.0 installerat.

Registrera provider för klustertillägg

  1. Ange följande kommandon:

    az provider register --namespace Microsoft.KubernetesConfiguration
az provider register --namespace Microsoft.ContainerService

  2. Övervaka registreringsprocessen. Registreringen kan ta upp till 10 minuter.

    az provider show -n Microsoft.KubernetesConfiguration -o table
az provider show -n Microsoft.ContainerService -o table

    När den har registrerats bör du RegistrationState se att tillståndet för dessa namnområden ändras till Registered .

Registrera AKS-ExtensionManager förhandsgranskningsfunktionerna

Om du vill skapa ett AKS-kluster som kan använda klustertillägg måste du aktivera AKS-ExtensionManager funktionsflaggan för din prenumeration.

Registrera AKS-ExtensionManager funktionsflaggan med kommandot az feature register, som du ser i följande exempel:

az feature register --namespace "Microsoft.ContainerService" --name "AKS-ExtensionManager"

Det tar några minuter för statusen att visa Registrerad. Kontrollera registreringsstatusen med hjälp av kommandot az feature list:

az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/AKS-ExtensionManager')].{Name:name,State:properties.state}"

När du är klar uppdaterar du registreringen av resursprovidern Microsoft.KubernetesConfiguration och Microsoft.ContainerService med hjälp av kommandot az provider register:

az provider register --namespace Microsoft.KubernetesConfiguration
az provider register --namespace Microsoft.ContainerService

Konfigurera Azure CLI-tillägget för klustertillägg

Anteckning

Den lägsta version som stöds för k8s-extension Azure CLI-tillägget är 1.0.0 . Om du är osäker på vilken version du har installerat kan az extension show --name k8s-extension du köra och leta efter fältet version .

Du behöver även k8s-extension Azure CLI-tillägget. Installera detta genom att köra följande kommandon:

az extension add --name k8s-extension

Om tillägget k8s-extension redan är installerat kan du uppdatera det till den senaste versionen med hjälp av följande kommando:

az extension update --name k8s-extension

För närvarande tillgängliga tillägg

Anteckning

Klustertillägg tillhandahåller en plattform för olika tillägg som ska installeras och hanteras i ett AKS-kluster. Om du får problem när du använder något av dessa tillägg öppnar du en supportbiljett med respektive tjänst.

För närvarande är inga tillägg tillgängliga.

Regioner som stöds och Kubernetes-versioner

Klustertillägg kan användas i AKS-kluster i de regioner som anges i Azure Arc kubernetes-regionstöd.

Information om Kubernetes-versioner som stöds finns i motsvarande dokumentation för varje tillägg.

Användning av klustertillägg

Anteckning

Exemplen i den här artikeln är inte fullständiga och är endast avsedda att demonstrera funktioner. En omfattande lista över kommandon och deras parametrar finns i CLI-referensen az k8s-extension.

Skapa en instans av tillägg

Skapa en ny tilläggsinstans med k8s-extension create och skicka värden för de obligatoriska parametrarna. Kommandot nedan skapar en Azure Machine Learning-instans i ditt AKS-kluster:

az k8s-extension create --name aml-compute --extension-type Microsoft.AzureML.Kubernetes --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters --configuration-settings enableInference=True allowInsecureConnections=True

Anteckning

Tjänsten Klustertillägg kan inte behålla känslig information i mer än 48 timmar. Om klustertilläggsagenterna inte har nätverksanslutning på mer än 48 timmar och inte kan avgöra om ett tillägg ska skapas i klustret, övergår tillägget till Failed tillstånd. I tillståndet Failed måste du köra igen för att skapa en ny k8s-extension create tilläggsinstans.

Obligatoriska parametrar

Parameternamn Beskrivning
--name Namnet på tilläggsinstansen
--extension-type Den typ av tillägg som du vill installera i klustret. Exempel: Microsoft.AzureML.Kubernetes
--cluster-name Namnet på det AKS-kluster där tilläggsinstansen måste skapas
--resource-group Resursgruppen som innehåller AKS-klustret
--cluster-type Den klustertyp som tilläggsinstansen måste skapas på. Ange managedClusters när den mappar till AKS-kluster

Valfria parametrar

Parameternamn Beskrivning
--auto-upgrade-minor-version Boolesk egenskap som anger om delversionen av tillägget uppgraderas automatiskt eller inte. Standard: true. Om den här parametern är inställd på true kan du inte ange version parametern eftersom versionen uppdateras dynamiskt. Om det är false inställt på uppgraderas inte tillägget automatiskt även för korrigeringsversioner.
--version Version av tillägget som ska installeras (specifik version som tilläggsinstansen ska fästas på). Får inte anges om auto-upgrade-minor-version har angetts till true .
--configuration-settings Inställningar som kan skickas till tillägget för att styra dess funktioner. De ska skickas som blankstegsavgränsade key=value par efter parameternamnet. Om den här parametern används i kommandot --configuration-settings-file kan inte användas i samma kommando.
--configuration-settings-file Sökvägen till JSON-filen med nyckelvärdepar som ska användas för att skicka konfigurationsinställningar till tillägget. Om den här parametern används i kommandot --configuration-settings kan inte användas i samma kommando.
--configuration-protected-settings De här inställningarna kan inte hämtas med GET API-anrop eller kommandon az k8s-extension show och används därför för att skicka känsliga inställningar. De ska skickas som blankstegsavgränsade key=value par efter parameternamnet. Om den här parametern används i kommandot --configuration-protected-settings-file kan inte användas i samma kommando.
--configuration-protected-settings-file Sökvägen till JSON-filen med nyckelvärdepar som ska användas för att skicka känsliga inställningar till tillägget. Om den här parametern används i kommandot --configuration-protected-settings kan inte användas i samma kommando.
--scope Installationsomfång för tillägget – cluster eller namespace
--release-namespace Den här parametern anger det namnområde inom vilket versionen ska skapas. Den här parametern är endast relevant scope om parametern har angetts till cluster .
--release-train Tilläggsförfattare kan publicera versioner i olika versionsfördrågor, Stable Preview till exempel , osv. Om den här parametern inte anges uttryckligen Stable används som standard. Den här parametern kan inte användas när autoUpgradeMinorVersion parametern är inställd på false .
--target-namespace Den här parametern anger det namnområde inom vilket versionen kommer att skapas. Behörigheten för det systemkonto som skapats för den här tilläggsinstansen begränsas till det här namnområdet. Den här parametern är bara relevant scope om parametern har angetts till namespace .

Visa information om en tilläggsinstans

Visa information om en installerad tilläggsinstans med k8s-extension show och skicka värden för de obligatoriska parametrarna:

az k8s-extension show --name azureml --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Visa en lista över alla tillägg som är installerade i klustret

Visa en lista över alla tillägg som är installerade i k8s-extension list ett kluster med och skicka värden för de obligatoriska parametrarna.

az k8s-extension list --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Uppdatera tilläggsinstansen

Anteckning

Läs dokumentationen för tilläggstypen (t.ex. Azure ML) om du vill veta mer om de specifika inställningar under ConfigurationSetting och ConfigurationProtectedSettings som tillåts uppdateras. För ConfigurationProtectedSettings förväntas alla inställningar tillhandahållas under en uppdatering av en enda inställning. Om vissa inställningar utelämnas anses dessa inställningar vara föråldrade och tas bort.

Uppdatera en befintlig tilläggsinstans med k8s-extension update och skicka värden för de obligatoriska parametrarna. Kommandot nedan uppdaterar inställningen för automatisk uppgradering för en Azure Machine Learning-tilläggsinstans:

az k8s-extension update --name azureml --extension-type Microsoft.AzureML.Kubernetes --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Obligatoriska parametrar

Parameternamn Beskrivning
--name Namnet på tilläggsinstansen
--extension-type Den typ av tillägg som du vill installera i klustret. Exempel: Microsoft.AzureML.Kubernetes
--cluster-name Namnet på det AKS-kluster där tilläggsinstansen måste skapas
--resource-group Resursgruppen som innehåller AKS-klustret
--cluster-type Klustertypen som tilläggsinstansen måste skapas på. Ange managedClusters när den mappar till AKS-kluster

Valfria parametrar

Parameternamn Beskrivning
--auto-upgrade-minor-version Boolesk egenskap som anger om delversionen av tillägget ska uppgraderas automatiskt eller inte. Standard: true. Om den här parametern är inställd på true kan du inte ange version parametern eftersom versionen uppdateras dynamiskt. Om det är false inställt på uppgraderas inte tillägget automatiskt ens för korrigeringsversioner.
--version Version av tillägget som ska installeras (specifik version som tilläggsinstansen ska fästas på). Får inte anges om auto-upgrade-minor-version har angetts till true .
--configuration-settings Inställningar som kan skickas till tillägget för att styra dess funktioner. Endast de inställningar som kräver en uppdatering måste anges. De angivna inställningarna ersätts med de angivna värdena. De ska skickas som blankstegsavgränsade key=value par efter parameternamnet. Om den här parametern används i kommandot --configuration-settings-file kan inte användas i samma kommando.
--configuration-settings-file Sökvägen till JSON-filen med nyckel/värde-par som ska användas för att skicka konfigurationsinställningar till tillägget. Om den här parametern används i kommandot --configuration-settings kan inte användas i samma kommando.
--configuration-protected-settings De här inställningarna kan inte hämtas med GET API-anrop eller kommandon az k8s-extension show och används därför för att skicka känsliga inställningar. När du uppdaterar en inställning förväntas alla inställningar tillhandahållas. Om vissa inställningar utelämnas anses dessa inställningar vara föråldrade och tas bort. De ska skickas som blankstegsavgränsade key=value par efter parameternamnet. Om den här parametern används i kommandot --configuration-protected-settings-file kan inte användas i samma kommando.
--configuration-protected-settings-file Sökvägen till JSON-filen med nyckel/värde-par som ska användas för att skicka känsliga inställningar till tillägget. Om den här parametern används i kommandot --configuration-protected-settings kan inte användas i samma kommando.
--scope Installationsomfång för tillägget – cluster eller namespace
--release-train Tilläggsförfattare kan publicera versioner i olika versionsfördrågor, Stable Preview till exempel , osv. Om den här parametern inte anges uttryckligen Stable används som standard. Den här parametern kan inte användas när autoUpgradeMinorVersion parametern är inställd på false .

Ta bort tilläggsinstans

Ta bort en tilläggsinstans i ett kluster k8s-extension delete med och skicka värden för de obligatoriska parametrarna.

az k8s-extension delete --name azureml --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Anteckning

Den Azure-resurs som representerar det här tillägget tas bort omedelbart. Helm-versionen i det kluster som är associerat med det här tillägget tas bara bort när de agenter som körs på Kubernetes-klustret har nätverksanslutning och kan kontakta Azure-tjänster igen för att hämta det önskade tillståndet.