Distribuera och hantera klustertillägg med hjälp av Azure CLI

Du kan skapa tilläggsinstanser i ett AKS-kluster, ange obligatoriska och valfria parametrar, inklusive alternativ som rör uppdateringar och konfigurationer. Du kan också visa, lista, uppdatera och ta bort tilläggsinstanser.

Läs om klustertillägg innan du börjar.

Note

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

Prerequisites

  • Ett Azure-abonnemang. Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto.

  • Resursprovidrar Microsoft.ContainerService och Microsoft.KubernetesConfiguration måste vara registrerade i din prenumeration. Om du vill registrera dessa leverantörer kör du följande kommando:

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

  • Ett AKS-kluster. Klustret måste ha skapats med en hanterad identitet eftersom klustertillägg inte fungerar med tjänsthuvudnamnsbaserade kluster. För nya kluster som skapats med az aks createkonfigureras den hanterade identiteten som standard. För befintliga tjänsthuvudnamnsbaserade kluster växlar du till att hantera identitet genom att köra az aks update med --enable-managed-identity flaggan. Mer information finns i Använda hanterad identitet.

  • Azure CLI version >= 2.16.0 är installerad. Vi rekommenderar att du använder den senaste versionen.

  • Den senaste versionen av k8s-extension Azure CLI-tilläggen. Installera tillägget genom att köra följande kommando:

    az extension add --name k8s-extension

    Om tillägget redan är installerat kontrollerar du att du kör den senaste versionen med hjälp av följande kommando:

    az extension update --name k8s-extension

Skapa tilläggsinstans

Skapa en ny tilläggsinstans med k8s-extension createoch skicka in värden för de obligatoriska parametrarna. Det här exempelkommandot skapar en Azure Machine Learning-tilläggsinstans i AKS-klustret:

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

Det här exempelkommandot skapar ett Kubernetes-exempelprogram (publicerat på Marketplace) i ditt AKS-kluster:

az k8s-extension create --name voteapp --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters --plan-name testPlanID --plan-product testOfferID --plan-publisher testPublisherID --configuration-settings title=VoteAnimal value1=Cats value2=Dogs

Note

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. När du är i Failed tillståndet måste du köra k8s-extension create igen för att skapa en ny tilläggsinstans.

Obligatoriska parametrar

Parameternamn Beskrivning
--name Namn på tilläggsinstansen
--extension-type Den typ av tillägg som du vill installera i klustret. Till exempel: Microsoft.AzureML.Kubernetes
--cluster-name Namnet på AKS-klustret 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 det mappar till AKS-kluster

Valfria parametrar

Parameternamn Beskrivning
--auto-upgrade-minor-version Boolesk egenskap som anger om tilläggets delversion uppgraderas automatiskt eller inte. Förvald: true. Om den här parametern är inställd på true kan du inte ange version parametern eftersom versionen uppdateras dynamiskt. Om värdet är inställt falsepå uppgraderas inte tillägget automatiskt även för korrigeringsversioner.
--version Version av tillägget som ska installeras (specifik version för att fästa tilläggsinstansen 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. Skicka värden som key=value-par åtskilda med blanksteg efter parameternamnet. Om den här parametern används i kommandot kan den --configuration-settings-file inte användas i samma kommando.
--configuration-settings-file Sökväg till JSON-filen med nyckelvärdepar som ska användas för att skicka in konfigurationsinställningar till tillägget. Om den här parametern används i kommandot kan den --configuration-settings inte användas i samma kommando.
--configuration-protected-settings De här inställningarna kan inte hämtas med HJÄLP av GET API-anrop eller az k8s-extension show kommandon och används därför för att skicka in känsliga inställningar. Skicka värden som key=value-par åtskilda med blanksteg efter parameternamnet. Om den här parametern används i kommandot kan den --configuration-protected-settings-file inte användas i samma kommando.
--configuration-protected-settings-file Sökväg till JSON-filen med nyckelvärdepar som ska användas för att skicka in känsliga inställningar till tillägget. Om den här parametern används i kommandot kan den --configuration-protected-settings inte användas i samma kommando.
--scope Omfånget för installationen 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 om scope parametern är inställd på cluster.
--release-train Tilläggsförfattare kan publicera versioner i olika versionståg, till exempel Stable, Previewosv. Om den här parametern inte anges explicit Stable används som standard. Den här parametern kan inte användas när --auto-upgrade-minor-version parametern är inställd på false.
--target-namespace Den här parametern anger det namnområde inom vilket versionen ska skapas. Behörigheten för systemkontot som skapats för den här tilläggsinstansen begränsas till det här namnområdet. Den här parametern är bara relevant om parametern scope är inställd på namespace.
--plan-name Plan-ID för tillägget som finns på marketplace-sidan i Azure-portalen under Använd information + support.
--plan-product Product ID för tillägget finns på marketplace-sidan i Azure-portalen under Använd information + support. Ett exempel på detta är namnet på det ISV-erbjudande som används.
--plan-publisher Publisher ID för tillägget som finns på marketplace-sidan i Azure-portalen under Använd information + support.

Visa information om en tilläggsinstans

Om du vill visa information om en för närvarande installerad tilläggsinstans använder du k8s-extension showoch skickar in 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

Om du vill visa en lista över alla tillägg som är installerade i ett kluster använder du k8s-extension listoch skickar in värden för de obligatoriska parametrarna.

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

Uppdatera tilläggsinstans

Note

Se dokumentationen för den specifika tilläggstypen för att förstå de specifika inställningarna i --configuration-settings och --configuration-protected-settings som kan uppdateras. För --configuration-protected-settingsförväntas alla inställningar anges, även om endast en inställning uppdateras. Om någon av dessa inställningar utelämnas betraktas dessa inställningar som föråldrade och borttagna.

Om du vill uppdatera en befintlig tilläggsinstans använder du k8s-extension updateoch skickar in värden för de obligatoriska parametrarna. Följande kommando 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 för uppdatering

Parameternamn Beskrivning
--name Namn på tilläggsinstansen
--extension-type Den typ av tillägg som du vill installera i klustret. Till exempel: Microsoft. AzureML.Kubernetes
--cluster-name Namnet på AKS-klustret 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 det mappar till AKS-kluster

Om du uppdaterar ett Kubernetes-program som anskaffats via Marketplace krävs även följande parametrar:

Parameternamn Beskrivning
--plan-name Plan-ID för tillägget som finns på marketplace-sidan i Azure-portalen under Använd information + support.
--plan-product Product ID för tillägget finns på marketplace-sidan i Azure-portalen under Använd information + support. Ett exempel på detta är namnet på det ISV-erbjudande som används.
--plan-publisher Publisher ID för tillägget som finns på marketplace-sidan i Azure-portalen under Använd information + support.

Valfria parametrar för uppdatering

Parameternamn Beskrivning
--auto-upgrade-minor-version Boolesk egenskap som anger om tilläggets delversion uppgraderas automatiskt eller inte. Förvald: true. Om den här parametern är inställd på true kan du inte ange version parametern eftersom versionen uppdateras dynamiskt. Om värdet är inställt falsepå uppgraderas inte tillägget automatiskt även för korrigeringsversioner.
--version Version av tillägget som ska installeras (specifik version för att fästa tilläggsinstansen 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 skulle ersättas med de angivna värdena. Skicka värden som key=value-par åtskilda med blanksteg efter parameternamnet. Om den här parametern används i kommandot kan den --configuration-settings-file inte användas i samma kommando.
--configuration-settings-file Sökväg till JSON-filen med nyckelvärdepar som ska användas för att skicka in konfigurationsinställningar till tillägget. Om den här parametern används i kommandot kan den --configuration-settings inte användas i samma kommando.
--configuration-protected-settings De här inställningarna kan inte hämtas med HJÄLP av GET API-anrop eller az k8s-extension show kommandon och används därför för att skicka in känsliga inställningar. När du uppdaterar en inställning, ska alla inställningar anges. Om vissa inställningar utelämnas skulle dessa inställningar betraktas som föråldrade och borttagna. Skicka värden som key=value-par åtskilda med blanksteg efter parameterns namn. Om den här parametern används i kommandot kan den --configuration-protected-settings-file inte användas i samma kommando.
--configuration-protected-settings-file Sökväg till JSON-filen med nyckelvärdepar som ska användas för att skicka in känsliga inställningar till tillägget. Om den här parametern används i kommandot kan den --configuration-protected-settings inte användas i samma kommando.
--scope Omfånget för installationen för tillägget – cluster eller namespace
--release-train Tilläggsförfattare kan publicera versioner i olika versionståg, till exempel Stable, Previewosv. Om den här parametern inte anges explicit 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

Om du vill ta bort en tilläggsinstans i ett kluster använder du k8s-extension-deleteoch skickar in värden för de obligatoriska parametrarna.

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

Note

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

Nästa steg

  • Last updated on