Udostępnij za pośrednictwem

az k8s-extension

  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia k8s dla interfejsu wiersza polecenia platformy Azure (wersja 2.51.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az k8s-extension . Dowiedz się więcej o rozszerzeniach.

Polecenia do zarządzania rozszerzeniami Kubernetes.

Polecenia

Nazwa Opis Typ Stan
az k8s-extension create

Utwórz rozszerzenie klastra Kubernetes, w tym zakup oferty rozszerzenia z witryny Azure Marketplace (tylko usługa AKS). Zapoznaj się z przykładem na końcu, aby zobaczyć, jak utworzyć rozszerzenie lub kupić ofertę rozszerzenia.

 Numer wewnętrzny Ogólna dostępność
az k8s-extension delete

Usuń rozszerzenie Kubernetes.

 Numer wewnętrzny Ogólna dostępność
az k8s-extension extension-types

Polecenia umożliwiające odnajdywanie typów rozszerzeń Kubernetes.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types list

Lista dostępnych typów rozszerzeń klastra dla istniejącego klastra.

 Numer wewnętrzny Podgląd i przestarzałe
az k8s-extension extension-types list-by-cluster

Lista dostępnych typów rozszerzeń klastra dla istniejącego klastra. Właściwości używane do filtrowania obejmują typ klastra (zarządzanego, połączonego itp.), wersję kubernetes, lokalizację klastra.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types list-by-location

Lista dostępnych typów rozszerzeń klastra w regionie.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types list-versions

Lista dostępnych wersji dla typu rozszerzenia klastra dla danego klastra.

 Numer wewnętrzny Podgląd i przestarzałe
az k8s-extension extension-types list-versions-by-cluster

Lista dostępnych wersji dla typu rozszerzenia klastra dla danego klastra. Właściwości używane do filtrowania obejmują typ klastra (zarządzanego, połączonego itp.), wersję kubernetes, lokalizację klastra.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types list-versions-by-location

Lista dostępnych wersji dla wersji typu rozszerzenia klastra w regionie.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types show

Pobieranie właściwości typu rozszerzenia klastra w regionie.

 Numer wewnętrzny Podgląd i przestarzałe
az k8s-extension extension-types show-by-cluster

Pokaż właściwości dla typu rozszerzenia klastra dla istniejącego klastra. Właściwości używane do filtrowania obejmują typ klastra (zarządzanego, połączonego itp.), wersję kubernetes, lokalizację klastra.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types show-by-location

Pokaż właściwości typu rozszerzenia klastra w regionie.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types show-version-by-cluster

Pokaż właściwości skojarzone z wersją typu rozszerzenia klastra dla istniejącego klastra. Właściwości używane do filtrowania obejmują typ klastra (zarządzanego, połączonego itp.), wersję kubernetes, lokalizację klastra.

 Numer wewnętrzny Wersja Preview
az k8s-extension extension-types show-version-by-location

Pokaż właściwości skojarzone z wersją typu rozszerzenia klastra w regionie.

 Numer wewnętrzny Wersja Preview
az k8s-extension list

Wyświetl listę rozszerzeń Kubernetes.

 Numer wewnętrzny Ogólna dostępność
az k8s-extension show

Pokaż rozszerzenie Kubernetes.

 Numer wewnętrzny Ogólna dostępność
az k8s-extension update

Zaktualizuj modyfikowalne właściwości rozszerzenia Kubernetes.

 Numer wewnętrzny Ogólna dostępność

az k8s-extension create

Utwórz rozszerzenie klastra Kubernetes, w tym zakup oferty rozszerzenia z witryny Azure Marketplace (tylko usługa AKS). Zapoznaj się z przykładem na końcu, aby zobaczyć, jak utworzyć rozszerzenie lub kupić ofertę rozszerzenia.

Utwórz rozszerzenie Kubernetes. Dane wyjściowe zawierają wpisy tajne, które należy chronić. Upewnij się, że nie dołączysz tych wpisów tajnych do kontroli źródła. Sprawdź również, czy w dziennikach polecenia lub skryptu nie ma żadnych wpisów tajnych. Aby uzyskać dodatkowe informacje, zobacz 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]

Przykłady

Tworzenie rozszerzenia 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

Tworzenie rozszerzenia platformy Marketplace platformy Kubernetes

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

Parametry wymagane

--cluster-name -c

Nazwa klastra Kubernetes.

--cluster-type -t

Określ klastry arc lub klastry zarządzane usługi AKS lub urządzenia arc albo aprowizowaneClusters.

akceptowane wartości: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Nazwa typu rozszerzenia.

--name -n

Nazwa wystąpienia rozszerzenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

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

Automatycznie uaktualnij wersję pomocniczą wystąpienia rozszerzenia.

akceptowane wartości: false, true
--cluster-resource-provider --cluster-rp

Nazwa dostawcy zasobów klastra dla tego typu klastra (wymagana dla aprowizacjiClusters).

--config --configuration-settings

Konfiguracja Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Nie należy tego używać w przypadku wpisów tajnych, ponieważ ta wartość jest zwracana w odpowiedzi.

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

Ścieżka pliku JSON dla ustawień konfiguracji.

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

Konfiguracja Chronione Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Tylko klucz jest zwracany w odpowiedzi, wartość nie jest.

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

Ścieżka pliku JSON dla ustawień chronionych przez konfigurację.

--config-settings
Przestarzałe

Opcja "--config-settings" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--configuration-settings".

Konfiguracja Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Nie należy tego używać w przypadku wpisów tajnych, ponieważ ta wartość jest zwracana w odpowiedzi.

--configuration-protected-settings
Przestarzałe

Opcja "--configuration-protected-settings" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj opcji "--config-protected-settings".

Konfiguracja Chronione Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Tylko klucz jest zwracany w odpowiedzi, wartość nie jest.

--configuration-protected-settings-file
Przestarzałe

Opcja "--configuration-protected-settings-file" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--config-protected-file".

Ścieżka pliku JSON dla ustawień chronionych przez konfigurację.

--configuration-settings-file
Przestarzałe

Opcja "--configuration-settings-file" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--config-settings-file".

Ścieżka pliku JSON dla ustawień konfiguracji.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--plan-name

Nazwa planu odnosi się do identyfikatora planu rozszerzenia pobieranego z portalu Marketplace w obszarze Informacje o użyciu i obsługa techniczna.

--plan-product

Produkt planu odnosi się do identyfikatora produktu rozszerzenia pobieranego z portalu Marketplace w obszarze Informacje o użyciu i obsługa techniczna. Przykładem jest nazwa używanej oferty niezależnego dostawcy oprogramowania.

--plan-publisher

Wydawca planu odwołuje się do identyfikatora wydawcy rozszerzenia pobieranego z portalu Marketplace w obszarze Informacje o użyciu i obsługa techniczna.

--release-namespace

Określ przestrzeń nazw, aby zainstalować wydanie rozszerzenia.

--release-train

Określ pociąg wydania dla typu rozszerzenia.

--scope

Określ zakres rozszerzenia.

akceptowane wartości: cluster, namespace
--target-namespace

Określ docelową przestrzeń nazw do zainstalowania dla wystąpienia rozszerzenia. Ten parametr jest wymagany, jeśli zakres rozszerzenia jest ustawiony na "przestrzeń nazw".

--version

Określ wersję do zainstalowania dla wystąpienia rozszerzenia, jeśli opcja --auto-upgrade-minor-version nie jest włączona.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az k8s-extension delete

Usuń rozszerzenie Kubernetes.

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

Przykłady

Usuwanie istniejącego rozszerzenia Kubernetes

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

Parametry wymagane

--cluster-name -c

Nazwa klastra Kubernetes.

--cluster-type -t

Określ klastry arc lub klastry zarządzane usługi AKS lub urządzenia arc albo aprowizowaneClusters.

akceptowane wartości: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nazwa wystąpienia rozszerzenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

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

Nazwa dostawcy zasobów klastra dla tego typu klastra (wymagana dla aprowizacjiClusters).

--force

Określ, czy wymusić usunięcie rozszerzenia z klastra.

wartość domyślna: False
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--yes -y

Ignoruj monity o potwierdzenie.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az k8s-extension list

Wyświetl listę rozszerzeń Kubernetes.

Wyświetl listę wszystkich rozszerzeń Kubernetes w klastrze, w tym ich właściwości. Dane wyjściowe zawierają wpisy tajne, które należy chronić. Upewnij się, że nie dołączysz tych wpisów tajnych do kontroli źródła. Sprawdź również, czy w dziennikach polecenia lub skryptu nie ma żadnych wpisów tajnych. Aby uzyskać dodatkowe informacje, zobacz http://aka.ms/clisecrets.

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

Przykłady

Wyświetlanie listy wszystkich rozszerzeń Kubernetes w klastrze

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

Parametry wymagane

--cluster-name -c

Nazwa klastra Kubernetes.

--cluster-type -t

Określ klastry arc lub klastry zarządzane usługi AKS lub urządzenia arc albo aprowizowaneClusters.

akceptowane wartości: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

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

Nazwa dostawcy zasobów klastra dla tego typu klastra (wymagana dla aprowizacjiClusters).

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az k8s-extension show

Pokaż rozszerzenie Kubernetes.

Pokaż rozszerzenie Kubernetes, w tym jego właściwości. Dane wyjściowe zawierają wpisy tajne, które należy chronić. Upewnij się, że nie dołączysz tych wpisów tajnych do kontroli źródła. Sprawdź również, czy w dziennikach polecenia lub skryptu nie ma żadnych wpisów tajnych. Aby uzyskać dodatkowe informacje, zobacz http://aka.ms/clisecrets.

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

Przykłady

Pokaż szczegóły rozszerzenia Kubernetes

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

Parametry wymagane

--cluster-name -c

Nazwa klastra Kubernetes.

--cluster-type -t

Określ klastry arc lub klastry zarządzane usługi AKS lub urządzenia arc albo aprowizowaneClusters.

akceptowane wartości: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nazwa wystąpienia rozszerzenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

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

Nazwa dostawcy zasobów klastra dla tego typu klastra (wymagana dla aprowizacjiClusters).

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az k8s-extension update

Zaktualizuj modyfikowalne właściwości rozszerzenia Kubernetes.

Aby uzyskać informacje o aktualizacji do konfiguracji Ustawienia i ConfigProtected Ustawienia, zapoznaj się z dokumentacją usługi rozszerzenia klastra, aby sprawdzić, czy aktualizacja tych właściwości jest obsługiwana przed zaktualizowaniem tych właściwości. Dane wyjściowe zawierają wpisy tajne, które należy chronić. Upewnij się, że nie dołączysz tych wpisów tajnych do kontroli źródła. Sprawdź również, czy w dziennikach polecenia lub skryptu nie ma żadnych wpisów tajnych. Aby uzyskać dodatkowe informacje, zobacz 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]

Przykłady

Aktualizowanie rozszerzenia 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

Parametry wymagane

--cluster-name -c

Nazwa klastra Kubernetes.

--cluster-type -t

Określ klastry arc lub klastry zarządzane usługi AKS lub urządzenia arc albo aprowizowaneClusters.

akceptowane wartości: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nazwa wystąpienia rozszerzenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

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

Automatycznie uaktualnij wersję pomocniczą wystąpienia rozszerzenia.

akceptowane wartości: false, true
--cluster-resource-provider --cluster-rp

Nazwa dostawcy zasobów klastra dla tego typu klastra (wymagana dla aprowizacjiClusters).

--config --configuration-settings

Konfiguracja Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Nie należy tego używać w przypadku wpisów tajnych, ponieważ ta wartość jest zwracana w odpowiedzi.

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

Ścieżka pliku JSON dla ustawień konfiguracji.

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

Konfiguracja Chronione Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Tylko klucz jest zwracany w odpowiedzi, wartość nie jest.

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

Ścieżka pliku JSON dla ustawień chronionych przez konfigurację.

--config-settings
Przestarzałe

Opcja "--config-settings" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--configuration-settings".

Konfiguracja Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Nie należy tego używać w przypadku wpisów tajnych, ponieważ ta wartość jest zwracana w odpowiedzi.

--configuration-protected-settings
Przestarzałe

Opcja "--configuration-protected-settings" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj opcji "--config-protected-settings".

Konfiguracja Chronione Ustawienia jako para key=value. Powtórz parametr dla każdego ustawienia. Tylko klucz jest zwracany w odpowiedzi, wartość nie jest.

--configuration-protected-settings-file
Przestarzałe

Opcja "--configuration-protected-settings-file" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--config-protected-file".

Ścieżka pliku JSON dla ustawień chronionych przez konfigurację.

--configuration-settings-file
Przestarzałe

Opcja "--configuration-settings-file" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--config-settings-file".

Ścieżka pliku JSON dla ustawień konfiguracji.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--release-train

Określ pociąg wydania dla typu rozszerzenia.

--version

Określ wersję do zainstalowania dla wystąpienia rozszerzenia, jeśli opcja --auto-upgrade-minor-version nie jest włączona.

--yes -y

Ignoruj monity o potwierdzenie.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.