Udostępnij za pośrednictwem

az networkcloud kubernetescluster agentpool

  • Odwołanie

Nuta

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

Zarządzanie pulą agentów klastra Kubernetes.

Polecenia

Nazwa Opis Typ Stan
az networkcloud kubernetescluster agentpool create

Utwórz nową pulę agentów klastra Kubernetes lub zaktualizuj jej właściwości.

 Rozszerzenie Prapremiera
az networkcloud kubernetescluster agentpool delete

Usuń udostępnioną pulę agentów klastra Kubernetes.

 Rozszerzenie Prapremiera
az networkcloud kubernetescluster agentpool list

Wyświetlanie listy pul agentów dla udostępnionego klastra Kubernetes.

 Rozszerzenie Prapremiera
az networkcloud kubernetescluster agentpool show

Pobierz właściwości udostępnionej puli agentów klastra Kubernetes.

 Rozszerzenie Prapremiera
az networkcloud kubernetescluster agentpool update

Zaktualizuj właściwości udostępnionej puli agentów klastra Kubernetes lub zaktualizuj tagi skojarzone z pulą agentów klastra Kubernetes. Aktualizacje właściwości i tagów można wykonywać niezależnie.

 Rozszerzenie Prapremiera
az networkcloud kubernetescluster agentpool wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

 Rozszerzenie GA

az networkcloud kubernetescluster agentpool create

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy referencyjne i pomocy technicznej: https://aka.ms/CLI_refstatus

Utwórz nową pulę agentów klastra Kubernetes lub zaktualizuj jej właściwości.

az networkcloud kubernetescluster agentpool create --agent-pool-name
                                                   --count
                                                   --kc-name
                                                   --mode {NotApplicable, System, User}
                                                   --resource-group
                                                   --vm-sku-name
                                                   [--admin-username]
                                                   [--agent-options]
                                                   [--attached-network-configuration]
                                                   [--availability-zones]
                                                   [--extended-location]
                                                   [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--labels]
                                                   [--location]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--ssh-dest-key-path]
                                                   [--ssh-key-values]
                                                   [--tags]
                                                   [--taints]
                                                   [--upgrade-settings]

Przykłady

Tworzenie lub aktualizowanie puli agentów klastra Kubernetes

az networkcloud kubernetescluster agentpool create --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --admin-username "azureuser" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm' --count 3 --mode "System" --vm-sku-name "NC-XXXXX" --agent-options hugepages-count=96 hugepages-size="1G" --attached-network-configuration l2-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName',pluginType:'DPDK'}]" l3-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName,pluginType:'SRIOV',ipamEnabled:'False'}]" trunked-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName',pluginType:'MACVLAN'}]" --labels="[{key:'kubernetes.label',value:'true'}]" --taints="[{key:'kubernetes.taint',value:'true'}]" --upgrade-settings max-surge="1" --availability-zones="['zone1','zone2']"

Parametry wymagane

--agent-pool-name --name -n

Nazwa puli agentów klastra Kubernetes.

--count

Liczba maszyn wirtualnych korzystających z tej konfiguracji.

--kc-name --kubernetes-cluster-name

Nazwa klastra Kubernetes.

--mode

Wybór sposobu wykorzystania tej puli agentów jako puli systemowej lub puli użytkowników. Pule systemu uruchamiają funkcje i usługi krytyczne dla klastra Kubernetes, a pule użytkowników są przeznaczone dla obciążeń użytkowników. Każdy klaster Kubernetes musi zawierać co najmniej jedną pulę węzłów systemowych z co najmniej jednym węzłem.

Dopuszczalne wartości: NotApplicable, System, User
--resource-group -g

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

--vm-sku-name

Nazwa jednostki SKU maszyny wirtualnej, która określa rozmiar zasobów przydzielonych dla maszyn wirtualnych węzła.

Parametry opcjonalne

--admin-username

Nazwa użytkownika administratora, który zostanie zastosowany do systemów operacyjnych z uruchomionymi węzłami Kubernetes. Jeśli nie zostanie podana, nazwa użytkownika zostanie wybrana przez usługę.

--agent-options

Konfiguracje, które zostaną zastosowane do każdego agenta w tej puli agentów. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--attached-network-configuration

Konfiguracja sieci dołączonych do puli agentów do użycia przez obciążenia uruchomione w tym klastrze Kubernetes. Te sieci są dodatkiem do sieci połączonych w konfiguracji sieci dołączonej do klastra Kubernetes. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--availability-zones

Lista stref dostępności klastra chmury sieciowej używanej do aprowizacji węzłów w tej puli agentów. Jeśli nie zostanie określony, zostaną użyte wszystkie strefy dostępności. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--extended-location

Rozszerzona lokalizacja klastra skojarzonego z zasobem. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--generate-ssh-keys

W razie braku wygeneruj pliki kluczy publicznych i prywatnych SSH. Klucze będą przechowywane w obszarze "~/.ssh".

Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--labels

Etykiety zastosowane do węzłów w tej puli agentów. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--location -l

Lokalizacja geograficzna, w której znajduje się zasób, gdy nie zostanie określony, zostanie użyta lokalizacja grupy zasobów.

--no-wait

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

Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--ssh-dest-key-path

Lista ścieżek rozdzielanych spacjami do kluczy publicznych SSH. Można podać ścieżkę pliku lub katalog. Jeśli zostanie podany katalog, spróbuje załadować wszystkie znalezione klucze publiczne (pub). Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--ssh-key-values

Lista kluczy publicznych SSH rozdzielonych spacjami. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--tags

Tagi zasobów. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--taints

Defekty zastosowane do węzłów w tej puli agentów. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--upgrade-settings

Konfiguracja puli agentów. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

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.

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

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool delete

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy referencyjne i pomocy technicznej: https://aka.ms/CLI_refstatus

Usuń udostępnioną pulę agentów klastra Kubernetes.

az networkcloud kubernetescluster agentpool delete [--agent-pool-name]
                                                   [--ids]
                                                   [--kc-name]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--yes]

Przykłady

Usuwanie puli agentów klastra Kubernetes

az networkcloud kubernetescluster agentpool delete --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parametry opcjonalne

--agent-pool-name --name -n

Nazwa puli agentów klastra Kubernetes.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--kc-name --kubernetes-cluster-name

Nazwa klastra Kubernetes.

--no-wait

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

Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--yes -y

Nie monituj o potwierdzenie.

Domyślna wartość: 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.

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

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool list

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy referencyjne i pomocy technicznej: https://aka.ms/CLI_refstatus

Wyświetlanie listy pul agentów dla udostępnionego klastra Kubernetes.

az networkcloud kubernetescluster agentpool list --kc-name
                                                 --resource-group
                                                 [--max-items]
                                                 [--next-token]

Przykłady

Wyświetlanie listy pul agentów klastra Kubernetes

az networkcloud kubernetescluster agentpool list --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parametry wymagane

--kc-name --kubernetes-cluster-name

Nazwa klastra Kubernetes.

--resource-group -g

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

Parametry opcjonalne

--max-items

Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token argumentu kolejnego polecenia.

--next-token

Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.

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.

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

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool show

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy referencyjne i pomocy technicznej: https://aka.ms/CLI_refstatus

Pobierz właściwości udostępnionej puli agentów klastra Kubernetes.

az networkcloud kubernetescluster agentpool show [--agent-pool-name]
                                                 [--ids]
                                                 [--kc-name]
                                                 [--resource-group]
                                                 [--subscription]

Przykłady

Pobieranie puli agentów klastra Kubernetes

az networkcloud kubernetescluster agentpool show --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parametry opcjonalne

--agent-pool-name --name -n

Nazwa puli agentów klastra Kubernetes.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--kc-name --kubernetes-cluster-name

Nazwa klastra Kubernetes.

--resource-group -g

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

--subscription

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

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.

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

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool update

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy referencyjne i pomocy technicznej: https://aka.ms/CLI_refstatus

Zaktualizuj właściwości udostępnionej puli agentów klastra Kubernetes lub zaktualizuj tagi skojarzone z pulą agentów klastra Kubernetes. Aktualizacje właściwości i tagów można wykonywać niezależnie.

az networkcloud kubernetescluster agentpool update [--agent-pool-name]
                                                   [--count]
                                                   [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--ids]
                                                   [--kc-name]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--resource-group]
                                                   [--ssh-dest-key-path]
                                                   [--ssh-key-values]
                                                   [--subscription]
                                                   [--tags]
                                                   [--upgrade-settings]

Przykłady

Pula agentów poprawek klastra Kubernetes

az networkcloud kubernetescluster agentpool update --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --count 3 --upgrade-settings max-surge="1"

Aktualizowanie poświadczeń administratora puli agentów

az networkcloud kubernetescluster agentpool update --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm'

Parametry opcjonalne

--agent-pool-name --name -n

Nazwa puli agentów klastra Kubernetes.

--count

Liczba maszyn wirtualnych korzystających z tej konfiguracji.

--generate-ssh-keys

W razie braku wygeneruj pliki kluczy publicznych i prywatnych SSH. Klucze będą przechowywane w obszarze "~/.ssh".

Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--kc-name --kubernetes-cluster-name

Nazwa klastra Kubernetes.

--no-wait

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

Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--ssh-dest-key-path

Lista ścieżek rozdzielanych spacjami do kluczy publicznych SSH. Można podać ścieżkę pliku lub katalog. Jeśli zostanie podany katalog, spróbuje załadować wszystkie znalezione klucze publiczne (pub). Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--ssh-key-values

Lista kluczy publicznych SSH rozdzielonych spacjami. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--subscription

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

--tags

Tagi zasobów platformy Azure, które zastąpią istniejące. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--upgrade-settings

Konfiguracja puli agentów. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

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.

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

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

az networkcloud kubernetescluster agentpool wait [--agent-pool-name]
                                                 [--created]
                                                 [--custom]
                                                 [--deleted]
                                                 [--exists]
                                                 [--ids]
                                                 [--interval]
                                                 [--kc-name]
                                                 [--resource-group]
                                                 [--subscription]
                                                 [--timeout]
                                                 [--updated]

Parametry opcjonalne

--agent-pool-name --name -n

Nazwa puli agentów klastra Kubernetes.

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

Domyślna wartość: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Poczekaj na usunięcie.

Domyślna wartość: False
--exists

Zaczekaj, aż zasób istnieje.

Domyślna wartość: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--interval

Interwał sondowania w sekundach.

Domyślna wartość: 30
--kc-name --kubernetes-cluster-name

Nazwa klastra Kubernetes.

--resource-group -g

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

--subscription

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

--timeout

Maksymalny czas oczekiwania w sekundach.

Domyślna wartość: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Domyślna wartość: 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.

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

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

--subscription

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

--verbose

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