Sdílet prostřednictvím

az k8s-extension

  • Reference

Poznámka:

Tento odkaz je součástí rozšíření k8s pro Azure CLI (verze 2.51.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az k8s-extension . Přečtěte si další informace o rozšířeních.

Příkazy pro správu rozšíření Kubernetes

Příkazy

Name Description Typ Stav
az k8s-extension create

Vytvořte rozšíření clusteru Kubernetes, včetně nákupu nabídky rozšíření z Azure Marketplace (jenom AKS). V příkladu na konci se dozvíte, jak vytvořit rozšíření nebo koupit nabídku rozšíření.

 Rozšíření GA
az k8s-extension delete

Odstranění rozšíření Kubernetes

 Rozšíření GA
az k8s-extension extension-types

Příkazy pro zjišťování typů rozšíření Kubernetes

 Rozšíření Preview
az k8s-extension extension-types list

Seznam dostupných typů rozšíření clusteru pro existující cluster

 Rozšíření Náhled a zastaralé
az k8s-extension extension-types list-by-cluster

Seznam dostupných typů rozšíření clusteru pro existující cluster Mezi vlastnosti použité pro filtrování patří typ clusteru (spravovaný, připojený atd.), verze Kubernetes, umístění clusteru.

 Rozšíření Preview
az k8s-extension extension-types list-by-location

Seznam dostupných typů rozšíření clusteru v oblasti

 Rozšíření Preview
az k8s-extension extension-types list-versions

Uveďte dostupné verze pro typ rozšíření clusteru pro daný cluster.

 Rozšíření Náhled a zastaralé
az k8s-extension extension-types list-versions-by-cluster

Uveďte dostupné verze pro typ rozšíření clusteru pro daný cluster. Mezi vlastnosti použité pro filtrování patří typ clusteru (spravovaný, připojený atd.), verze Kubernetes, umístění clusteru.

 Rozšíření Preview
az k8s-extension extension-types list-versions-by-location

Uveďte dostupné verze pro verze typu rozšíření clusteru v oblasti.

 Rozšíření Preview
az k8s-extension extension-types show

Získání vlastností pro typ rozšíření clusteru v oblasti

 Rozšíření Náhled a zastaralé
az k8s-extension extension-types show-by-cluster

Umožňuje zobrazit vlastnosti pro typ rozšíření clusteru pro existující cluster. Mezi vlastnosti použité pro filtrování patří typ clusteru (spravovaný, připojený atd.), verze Kubernetes, umístění clusteru.

 Rozšíření Preview
az k8s-extension extension-types show-by-location

Umožňuje zobrazit vlastnosti pro typ rozšíření clusteru v oblasti.

 Rozšíření Preview
az k8s-extension extension-types show-version-by-cluster

Zobrazí vlastnosti přidružené k verzi typu rozšíření clusteru pro existující cluster. Mezi vlastnosti použité pro filtrování patří typ clusteru (spravovaný, připojený atd.), verze Kubernetes, umístění clusteru.

 Rozšíření Preview
az k8s-extension extension-types show-version-by-location

Umožňuje zobrazit vlastnosti přidružené k verzi typu rozšíření clusteru v oblasti.

 Rozšíření Preview
az k8s-extension list

Zobrazení seznamu rozšíření Kubernetes

 Rozšíření GA
az k8s-extension show

Zobrazení rozšíření Kubernetes

 Rozšíření GA
az k8s-extension update

Aktualizujte proměnlivé vlastnosti rozšíření Kubernetes.

 Rozšíření GA

az k8s-extension create

Vytvořte rozšíření clusteru Kubernetes, včetně nákupu nabídky rozšíření z Azure Marketplace (jenom AKS). V příkladu na konci se dozvíte, jak vytvořit rozšíření nebo koupit nabídku rozšíření.

Vytvořte rozšíření Kubernetes. Výstup obsahuje tajné kódy, které musíte chránit. Nezapomeňte do správy zdrojového kódu zahrnout tyto tajné kódy. Ověřte také, že v protokolech příkazu nebo skriptu nejsou k dispozici žádné tajné kódy. Další informace najdete v tématu 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]

Příklady

Vytvoření rozšíření Kubernetes

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

Vytvoření rozšíření Kubernetes Marketplace

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

Povinné parametry

--cluster-name -c

Název clusteru Kubernetes

--cluster-type -t

Zadejte clustery Arc nebo spravované clustery AKS nebo zařízení Arc nebo zřízenéClusters.

Přípustné hodnoty: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Název typu rozšíření.

--name -n

Název instance rozšíření

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Automaticky upgradovat podverzi instance rozšíření.

Přípustné hodnoty: false, true
--cluster-resource-provider --cluster-rp

Název zprostředkovatele prostředků clusteru pro tento typ clusteru (vyžaduje se pro zřízenéClusters).

--config --configuration-settings

Konfigurace Nastavení jako pár klíč=hodnota. Opakujte parametr pro každé nastavení. Nepoužívejte tuto hodnotu pro tajné kódy, protože tato hodnota je vrácena v odpovědi.

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

Cesta k souboru JSON pro nastavení konfigurace

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

Configuration Protected Nastavení as key=value pair. Opakujte parametr pro každé nastavení. V odpovědi se vrátí pouze klíč, hodnota není.

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

Cesta k souboru JSON pro nastavení chráněná konfigurací

--config-settings
Zastaralé

Možnost --config-settings je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --configuration-settings.

Konfigurace Nastavení jako pár klíč=hodnota. Opakujte parametr pro každé nastavení. Nepoužívejte tuto hodnotu pro tajné kódy, protože tato hodnota je vrácena v odpovědi.

--configuration-protected-settings
Zastaralé

Možnost --configuration-protected-settings je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --config-protected-settings.

Configuration Protected Nastavení as key=value pair. Opakujte parametr pro každé nastavení. V odpovědi se vrátí pouze klíč, hodnota není.

--configuration-protected-settings-file
Zastaralé

Možnost --configuration-protected-settings-file je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --config-protected-file.

Cesta k souboru JSON pro nastavení chráněná konfigurací

--configuration-settings-file
Zastaralé

Možnost --configuration-settings-file je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --config-settings-file.

Cesta k souboru JSON pro nastavení konfigurace

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--plan-name

Název plánu odkazuje na ID plánu rozšíření, které je převzato z portálu Marketplace v části Informace o využití a podpora.

--plan-product

Produkt plánu odkazuje na ID produktu rozšíření, které je převzato z portálu Marketplace v části Informace o využití a podpora. Příkladem je název použité nabídky nezávislých výrobců softwaru.

--plan-publisher

Vydavatel plánu odkazuje na ID vydavatele rozšíření, které je převzato z portálu Marketplace v části Informace o využití a podpora.

--release-namespace

Zadejte obor názvů pro instalaci verze rozšíření.

--release-train

Zadejte trénování vydané verze pro typ rozšíření.

--scope

Zadejte obor rozšíření.

Přípustné hodnoty: cluster, namespace
--target-namespace

Zadejte cílový obor názvů, do který se má nainstalovat instance rozšíření. Tento parametr se vyžaduje, pokud je obor rozšíření nastavený na obor názvů.

--version

Zadejte verzi, která se má nainstalovat pro instanci rozšíření, pokud není povolená podverze --auto-upgrade-minor-version.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az k8s-extension delete

Odstranění rozšíření Kubernetes

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

Příklady

Odstranění existujícího rozšíření Kubernetes

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

Povinné parametry

--cluster-name -c

Název clusteru Kubernetes

--cluster-type -t

Zadejte clustery Arc nebo spravované clustery AKS nebo zařízení Arc nebo zřízenéClusters.

Přípustné hodnoty: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Název instance rozšíření

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Název zprostředkovatele prostředků clusteru pro tento typ clusteru (vyžaduje se pro zřízenéClusters).

--force

Určete, zda se má vynutit odstranění rozšíření z clusteru.

Default value: False
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--yes -y

Ignorovat výzvy k potvrzení

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az k8s-extension list

Zobrazení seznamu rozšíření Kubernetes

Zobrazí seznam všech rozšíření Kubernetes v clusteru, včetně jejich vlastností. Výstup obsahuje tajné kódy, které musíte chránit. Nezapomeňte do správy zdrojového kódu zahrnout tyto tajné kódy. Ověřte také, že v protokolech příkazu nebo skriptu nejsou k dispozici žádné tajné kódy. Další informace najdete v tématu http://aka.ms/clisecrets.

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

Příklady

Výpis všech rozšíření Kubernetes v clusteru

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

Povinné parametry

--cluster-name -c

Název clusteru Kubernetes

--cluster-type -t

Zadejte clustery Arc nebo spravované clustery AKS nebo zařízení Arc nebo zřízenéClusters.

Přípustné hodnoty: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Název zprostředkovatele prostředků clusteru pro tento typ clusteru (vyžaduje se pro zřízenéClusters).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az k8s-extension show

Zobrazení rozšíření Kubernetes

Zobrazení rozšíření Kubernetes včetně jeho vlastností Výstup obsahuje tajné kódy, které musíte chránit. Nezapomeňte do správy zdrojového kódu zahrnout tyto tajné kódy. Ověřte také, že v protokolech příkazu nebo skriptu nejsou k dispozici žádné tajné kódy. Další informace najdete v tématu http://aka.ms/clisecrets.

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

Příklady

Zobrazení podrobností o rozšíření Kubernetes

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

Povinné parametry

--cluster-name -c

Název clusteru Kubernetes

--cluster-type -t

Zadejte clustery Arc nebo spravované clustery AKS nebo zařízení Arc nebo zřízenéClusters.

Přípustné hodnoty: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Název instance rozšíření

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Název zprostředkovatele prostředků clusteru pro tento typ clusteru (vyžaduje se pro zřízenéClusters).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az k8s-extension update

Aktualizujte proměnlivé vlastnosti rozšíření Kubernetes.

Informace o aktualizaci konfigurace Nastavení a konfiguraceProtected Nastavení naleznete v dokumentaci ke službě rozšíření clusteru a zkontrolujte, zda aktualizace těchto vlastností je podporována před aktualizací těchto vlastností. Výstup obsahuje tajné kódy, které musíte chránit. Nezapomeňte do správy zdrojového kódu zahrnout tyto tajné kódy. Ověřte také, že v protokolech příkazu nebo skriptu nejsou k dispozici žádné tajné kódy. Další informace najdete v tématu 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]

Příklady

Aktualizace rozšíření Kubernetes

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

Povinné parametry

--cluster-name -c

Název clusteru Kubernetes

--cluster-type -t

Zadejte clustery Arc nebo spravované clustery AKS nebo zařízení Arc nebo zřízenéClusters.

Přípustné hodnoty: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Název instance rozšíření

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Automaticky upgradovat podverzi instance rozšíření.

Přípustné hodnoty: false, true
--cluster-resource-provider --cluster-rp

Název zprostředkovatele prostředků clusteru pro tento typ clusteru (vyžaduje se pro zřízenéClusters).

--config --configuration-settings

Konfigurace Nastavení jako pár klíč=hodnota. Opakujte parametr pro každé nastavení. Nepoužívejte tuto hodnotu pro tajné kódy, protože tato hodnota je vrácena v odpovědi.

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

Cesta k souboru JSON pro nastavení konfigurace

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

Configuration Protected Nastavení as key=value pair. Opakujte parametr pro každé nastavení. V odpovědi se vrátí pouze klíč, hodnota není.

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

Cesta k souboru JSON pro nastavení chráněná konfigurací

--config-settings
Zastaralé

Možnost --config-settings je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --configuration-settings.

Konfigurace Nastavení jako pár klíč=hodnota. Opakujte parametr pro každé nastavení. Nepoužívejte tuto hodnotu pro tajné kódy, protože tato hodnota je vrácena v odpovědi.

--configuration-protected-settings
Zastaralé

Možnost --configuration-protected-settings je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --config-protected-settings.

Configuration Protected Nastavení as key=value pair. Opakujte parametr pro každé nastavení. V odpovědi se vrátí pouze klíč, hodnota není.

--configuration-protected-settings-file
Zastaralé

Možnost --configuration-protected-settings-file je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --config-protected-file.

Cesta k souboru JSON pro nastavení chráněná konfigurací

--configuration-settings-file
Zastaralé

Možnost --configuration-settings-file je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --config-settings-file.

Cesta k souboru JSON pro nastavení konfigurace

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--release-train

Zadejte trénování vydané verze pro typ rozšíření.

--version

Zadejte verzi, která se má nainstalovat pro instanci rozšíření, pokud není povolená podverze --auto-upgrade-minor-version.

--yes -y

Ignorovat výzvy k potvrzení

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.