Dela via

az k8s-extension

  • Referens

Kommentar

Den här referensen är en del av k8s-tilläggstillägget för Azure CLI (version 2.51.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az k8s-extension . Läs mer om tillägg.

Kommandon för att hantera Kubernetes-tillägg.

Kommandon

Name Description Typ Status
az k8s-extension create

Skapa ett Kubernetes-klustertillägg, inklusive att köpa ett tilläggserbjudande från Azure Marketplace (endast AKS). Se exemplet i slutet för att se hur du skapar ett tillägg eller köper ett tilläggserbjudande.

 Anknytning Allmän tillgänglighet
az k8s-extension delete

Ta bort ett Kubernetes-tillägg.

 Anknytning Allmän tillgänglighet
az k8s-extension extension-types

Kommandon för att identifiera Kubernetes-tilläggstyper.

 Anknytning Förhandsgranska
az k8s-extension extension-types list

Lista tillgängliga klustertilläggstyper för ett befintligt kluster.

 Anknytning Förhandsversion och inaktuell
az k8s-extension extension-types list-by-cluster

Lista tillgängliga klustertilläggstyper för ett befintligt kluster. Egenskaperna som används för filtrering är typ av kluster (hanterad, ansluten osv.), kubernetes-version, plats för klustret.

 Anknytning Förhandsgranska
az k8s-extension extension-types list-by-location

Lista tillgängliga klustertilläggstyper i en region.

 Anknytning Förhandsgranska
az k8s-extension extension-types list-versions

Visa en lista över tillgängliga versioner för en klustertilläggstyp för ett visst kluster.

 Anknytning Förhandsversion och inaktuell
az k8s-extension extension-types list-versions-by-cluster

Visa en lista över tillgängliga versioner för en klustertilläggstyp för ett visst kluster. Egenskaperna som används för filtrering är typ av kluster (hanterad, ansluten osv.), kubernetes-version, plats för klustret.

 Anknytning Förhandsgranska
az k8s-extension extension-types list-versions-by-location

Visa en lista över tillgängliga versioner för en klustertilläggstypversion i en region.

 Anknytning Förhandsgranska
az k8s-extension extension-types show

Hämta egenskaper för en typ av klustertillägg i en region.

 Anknytning Förhandsversion och inaktuell
az k8s-extension extension-types show-by-cluster

Visa egenskaper för en klustertilläggstyp för ett befintligt kluster. Egenskaperna som används för filtrering är typ av kluster (hanterad, ansluten osv.), kubernetes-version, plats för klustret.

 Anknytning Förhandsgranska
az k8s-extension extension-types show-by-location

Visa egenskaper för en klustertilläggstyp i en region.

 Anknytning Förhandsgranska
az k8s-extension extension-types show-version-by-cluster

Visa egenskaper som är associerade med en klustertilläggstypversion för ett befintligt kluster. Egenskaperna som används för filtrering är typ av kluster (hanterad, ansluten osv.), kubernetes-version, plats för klustret.

 Anknytning Förhandsgranska
az k8s-extension extension-types show-version-by-location

Visa egenskaper som är associerade med en klustertilläggstypversion i en region.

 Anknytning Förhandsgranska
az k8s-extension list

Lista Kubernetes-tillägg.

 Anknytning Allmän tillgänglighet
az k8s-extension show

Visa ett Kubernetes-tillägg.

 Anknytning Allmän tillgänglighet
az k8s-extension update

Uppdatera föränderliga egenskaper för ett Kubernetes-tillägg.

 Anknytning Allmän tillgänglighet

az k8s-extension create

Skapa ett Kubernetes-klustertillägg, inklusive att köpa ett tilläggserbjudande från Azure Marketplace (endast AKS). Se exemplet i slutet för att se hur du skapar ett tillägg eller köper ett tilläggserbjudande.

Skapa ett Kubernetes-tillägg. Utdata innehåller hemligheter som du måste skydda. Se till att du inte inkluderar dessa hemligheter i källkontrollen. Kontrollera också att inga hemligheter finns i loggarna för ditt kommando eller skript. För ytterligare information, se http://aka.ms/clisecrets.

az k8s-extension create --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --extension-type
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--plan-name]
                        [--plan-product]
                        [--plan-publisher]
                        [--release-namespace]
                        [--release-train]
                        [--scope {cluster, namespace}]
                        [--target-namespace]
                        [--version]

Exempel

Skapa ett Kubernetes-tillägg

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --extension-type microsoft.openservicemesh --scope cluster --release-train stable

Skapa ett Kubernetes Marketplace-tillägg

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type managedClusters --name myextension --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --release-train stable --plan-name testplan --plan-product kubernetest_apps_demo_offer --plan-publisher test_test_mix3pptest0011614206850774

Obligatoriska parametrar

--cluster-name -c

Namnet på Kubernetes-klustret.

--cluster-type -t

Ange Arc-kluster eller AKS-hanterade kluster eller Arc-enheter eller provisionedClusters.

accepterade värden: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Namnet på tilläggstypen.

--name -n

Namnet på tilläggsinstansen.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--auto-upgrade --auto-upgrade-minor-version

Uppgradera automatiskt delversionen av tilläggsinstansen.

accepterade värden: false, true
--cluster-resource-provider --cluster-rp

Klusterresursproviderns namn för denna clusterType (krävs för provisionedClusters).

--config --configuration-settings

Konfiguration Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Använd inte detta för hemligheter eftersom det här värdet returneras som svar.

--config-file --config-settings-file

JSON-filsökväg för konfigurationsinställningar.

--config-protected --config-protected-settings

Konfigurationsskyddad Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Endast nyckeln returneras som svar. Värdet är inte det.

--config-protected-file --config-protected-settings-file

JSON-filsökväg för konfigurationsskyddade inställningar.

--config-settings
Inaktuell

Alternativet "--config-settings" har föråldrats och tas bort i en framtida version. Använd "--configuration-settings" i stället.

Konfiguration Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Använd inte detta för hemligheter eftersom det här värdet returneras som svar.

--configuration-protected-settings
Inaktuell

Alternativet "--configuration-protected-settings" har föråldrats och tas bort i en framtida version. Använd "--config-protected-settings" i stället.

Konfigurationsskyddad Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Endast nyckeln returneras som svar. Värdet är inte det.

--configuration-protected-settings-file
Inaktuell

Alternativet "--configuration-protected-settings-file" har blivit inaktuellt och tas bort i en framtida version. Använd "--config-protected-file" i stället.

JSON-filsökväg för konfigurationsskyddade inställningar.

--configuration-settings-file
Inaktuell

Alternativet "--configuration-settings-file" har tagits bort och tas bort i en framtida version. Använd "--config-settings-file" i stället.

JSON-filsökväg för konfigurationsinställningar.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--plan-name

Plannamnet refererar till plan-ID:t för tillägget som tas från Marketplace-portalen under Användningsinformation + Support.

--plan-product

Planprodukten refererar till produkt-ID:t för tillägget som tas från Marketplace-portalen under Användningsinformation + Support. Ett exempel på detta är namnet på det ISV-erbjudande som används.

--plan-publisher

Planutgivaren refererar till utgivarens ID för tillägget som tas från Marketplace-portalen under Användningsinformation + Support.

--release-namespace

Ange namnområdet för att installera tilläggsversionen.

--release-train

Ange versionståget för tilläggstypen.

--scope

Ange tilläggets omfång.

accepterade värden: cluster, namespace
--target-namespace

Ange målnamnområdet som ska installeras för tilläggsinstansen. Den här parametern krävs om tilläggets omfång är inställt på "namnområde".

--version

Ange vilken version som ska installeras för tilläggsinstansen om --auto-upgrade-minor-version inte är aktiverad.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az k8s-extension delete

Ta bort ett Kubernetes-tillägg.

az k8s-extension delete --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--cluster-resource-provider]
                        [--force]
                        [--no-wait]
                        [--yes]

Exempel

Ta bort ett befintligt Kubernetes-tillägg

az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Obligatoriska parametrar

--cluster-name -c

Namnet på Kubernetes-klustret.

--cluster-type -t

Ange Arc-kluster eller AKS-hanterade kluster eller Arc-enheter eller provisionedClusters.

accepterade värden: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Namnet på tilläggsinstansen.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--cluster-resource-provider --cluster-rp

Klusterresursproviderns namn för denna clusterType (krävs för provisionedClusters).

--force

Ange om tillägget ska tas bort från klustret.

standardvärde: False
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--yes -y

Ignorera bekräftelseprompter.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az k8s-extension list

Lista Kubernetes-tillägg.

Visa en lista över alla Kubernetes-tillägg i ett kluster, inklusive deras egenskaper. Utdata innehåller hemligheter som du måste skydda. Se till att du inte inkluderar dessa hemligheter i källkontrollen. Kontrollera också att inga hemligheter finns i loggarna för ditt kommando eller skript. För ytterligare information, se http://aka.ms/clisecrets.

az k8s-extension list --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --resource-group
                      [--cluster-resource-provider]

Exempel

Visa en lista över alla Kubernetes-tillägg i ett kluster

az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

Obligatoriska parametrar

--cluster-name -c

Namnet på Kubernetes-klustret.

--cluster-type -t

Ange Arc-kluster eller AKS-hanterade kluster eller Arc-enheter eller provisionedClusters.

accepterade värden: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--cluster-resource-provider --cluster-rp

Klusterresursproviderns namn för denna clusterType (krävs för provisionedClusters).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az k8s-extension show

Visa ett Kubernetes-tillägg.

Visa ett Kubernetes-tillägg med dess egenskaper. Utdata innehåller hemligheter som du måste skydda. Se till att du inte inkluderar dessa hemligheter i källkontrollen. Kontrollera också att inga hemligheter finns i loggarna för ditt kommando eller skript. För ytterligare information, se http://aka.ms/clisecrets.

az k8s-extension show --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --name
                      --resource-group
                      [--cluster-resource-provider]

Exempel

Visa information om ett Kubernetes-tillägg

az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Obligatoriska parametrar

--cluster-name -c

Namnet på Kubernetes-klustret.

--cluster-type -t

Ange Arc-kluster eller AKS-hanterade kluster eller Arc-enheter eller provisionedClusters.

accepterade värden: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Namnet på tilläggsinstansen.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--cluster-resource-provider --cluster-rp

Klusterresursproviderns namn för denna clusterType (krävs för provisionedClusters).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az k8s-extension update

Uppdatera föränderliga egenskaper för ett Kubernetes-tillägg.

Om du vill uppdatera till Config Inställningar och ConfigProtected Inställningar kan du läsa dokumentationen för klustertilläggstjänsten för att kontrollera att uppdatering av dessa egenskaper stöds innan du uppdaterar dessa egenskaper. Utdata innehåller hemligheter som du måste skydda. Se till att du inte inkluderar dessa hemligheter i källkontrollen. Kontrollera också att inga hemligheter finns i loggarna för ditt kommando eller skript. För ytterligare information, se http://aka.ms/clisecrets.

az k8s-extension update --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--release-train]
                        [--version]
                        [--yes]

Exempel

Uppdatera ett Kubernetes-tillägg

az k8s-extension update --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --auto-upgrade true/false --version extension-version --release-train stable --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file

Obligatoriska parametrar

--cluster-name -c

Namnet på Kubernetes-klustret.

--cluster-type -t

Ange Arc-kluster eller AKS-hanterade kluster eller Arc-enheter eller provisionedClusters.

accepterade värden: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Namnet på tilläggsinstansen.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--auto-upgrade --auto-upgrade-minor-version

Uppgradera automatiskt delversionen av tilläggsinstansen.

accepterade värden: false, true
--cluster-resource-provider --cluster-rp

Klusterresursproviderns namn för denna clusterType (krävs för provisionedClusters).

--config --configuration-settings

Konfiguration Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Använd inte detta för hemligheter eftersom det här värdet returneras som svar.

--config-file --config-settings-file

JSON-filsökväg för konfigurationsinställningar.

--config-protected --config-protected-settings

Konfigurationsskyddad Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Endast nyckeln returneras som svar. Värdet är inte det.

--config-protected-file --config-protected-settings-file

JSON-filsökväg för konfigurationsskyddade inställningar.

--config-settings
Inaktuell

Alternativet "--config-settings" har föråldrats och tas bort i en framtida version. Använd "--configuration-settings" i stället.

Konfiguration Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Använd inte detta för hemligheter eftersom det här värdet returneras som svar.

--configuration-protected-settings
Inaktuell

Alternativet "--configuration-protected-settings" har föråldrats och tas bort i en framtida version. Använd "--config-protected-settings" i stället.

Konfigurationsskyddad Inställningar som nyckel=värdepar. Upprepa parametern för varje inställning. Endast nyckeln returneras som svar. Värdet är inte det.

--configuration-protected-settings-file
Inaktuell

Alternativet "--configuration-protected-settings-file" har blivit inaktuellt och tas bort i en framtida version. Använd "--config-protected-file" i stället.

JSON-filsökväg för konfigurationsskyddade inställningar.

--configuration-settings-file
Inaktuell

Alternativet "--configuration-settings-file" har tagits bort och tas bort i en framtida version. Använd "--config-settings-file" i stället.

JSON-filsökväg för konfigurationsinställningar.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--release-train

Ange versionståget för tilläggstypen.

--version

Ange vilken version som ska installeras för tilläggsinstansen om --auto-upgrade-minor-version inte är aktiverad.

--yes -y

Ignorera bekräftelseprompter.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.