Condividi tramite

az networkcloud kubernetescluster agentpool

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione networkcloud per l'interfaccia della riga di comando di Azure (versione 2.51.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az networkcloud kubernetescluster agentpool . Altre informazioni sulle estensioni.

Il gruppo di comandi 'az networkcloud' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire il pool di agenti del cluster Kubernetes.

Comandi

Nome Descrizione Tipo Stato
az networkcloud kubernetescluster agentpool create

Creare un nuovo pool di agenti del cluster Kubernetes o aggiornare le proprietà di quella esistente.

 Estensione Anteprima
az networkcloud kubernetescluster agentpool delete

Eliminare il pool di agenti del cluster Kubernetes fornito.

 Estensione Anteprima
az networkcloud kubernetescluster agentpool list

Elencare i pool di agenti per il cluster Kubernetes fornito.

 Estensione Anteprima
az networkcloud kubernetescluster agentpool show

Ottenere le proprietà del pool di agenti del cluster Kubernetes fornito.

 Estensione Anteprima
az networkcloud kubernetescluster agentpool update

Aggiornare le proprietà del pool di agenti del cluster Kubernetes specificato oppure aggiornare i tag associati al pool di agenti del cluster Kubernetes. Le proprietà e gli aggiornamenti dei tag possono essere eseguiti in modo indipendente.

 Estensione Anteprima
az networkcloud kubernetescluster agentpool wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

 Estensione Anteprima

az networkcloud kubernetescluster agentpool create

Anteprima

Il gruppo di comandi 'az networkcloud' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare un nuovo pool di agenti del cluster Kubernetes o aggiornare le proprietà di quella esistente.

az networkcloud kubernetescluster agentpool create --agent-pool-name
                                                   --count
                                                   --kubernetes-cluster-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]

Esempio

Creare o aggiornare il pool di agenti del cluster 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']"

Parametri necessari

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

Nome del pool di agenti del cluster Kubernetes.

--count

Numero di macchine virtuali che usano questa configurazione.

--kubernetes-cluster-name

Nome del cluster Kubernetes.

--mode

Selezione della modalità di utilizzo del pool di agenti, come pool di sistema o pool di utenti. I pool di sistema eseguono le funzionalità e i servizi critici per il cluster Kubernetes, mentre i pool di utenti sono dedicati ai carichi di lavoro degli utenti. Ogni cluster Kubernetes deve contenere almeno un pool di nodi di sistema con almeno un nodo.

valori accettati: NotApplicable, System, User
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--vm-sku-name

Nome dello SKU della macchina virtuale che determina le dimensioni delle risorse allocate per le macchine virtuali del nodo.

Parametri facoltativi

--admin-username

Nome utente per l'amministratore che verrà applicato ai sistemi operativi che eseguono nodi Kubernetes. Se non viene specificato, verrà scelto un nome utente dal servizio.

--agent-options

Configurazioni che verranno applicate a ogni agente nel pool di agenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--attached-network-configuration

La configurazione delle reti collegate al pool di agenti per l'uso da parte dei carichi di lavoro eseguiti in questo cluster Kubernetes. Queste reti si aggiungono alle reti connesse nella configurazione di rete collegata al cluster Kubernetes. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--availability-zones

Elenco delle zone di disponibilità del cluster Cloud di rete usato per il provisioning dei nodi in questo pool di agenti. Se non specificato, verranno usate tutte le zone di disponibilità. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--extended-location

Posizione estesa del cluster associato alla risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--generate-ssh-keys

Generare i file delle chiavi pubblica e privata SSH se mancanti. Le chiavi verranno archiviate in '~/.ssh'.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--labels

Etichette applicate ai nodi in questo pool di agenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--location -l

Posizione geografica in cui si trova la risorsa Se non specificato, verrà usata la posizione del gruppo di risorse.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--ssh-dest-key-path

Elenco di percorsi separati da spazi per le chiavi pubbliche SSH. È possibile specificare un percorso di file o una directory. Se viene specificata una directory, tenterà di caricare tutte le chiavi pubbliche (.pub) trovate. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--ssh-key-values

Elenco di chiavi pubbliche SSH separate da spazi. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--tags

Tag di risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--taints

I taints applicati ai nodi in questo pool di agenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--upgrade-settings

Configurazione del pool di agenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az networkcloud kubernetescluster agentpool delete

Anteprima

Il gruppo di comandi 'az networkcloud' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare il pool di agenti del cluster Kubernetes fornito.

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

Esempio

Eliminare il pool di agenti del cluster Kubernetes

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

Parametri facoltativi

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

Nome del pool di agenti del cluster Kubernetes.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--kubernetes-cluster-name

Nome del cluster Kubernetes.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az networkcloud kubernetescluster agentpool list

Anteprima

Il gruppo di comandi 'az networkcloud' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare i pool di agenti per il cluster Kubernetes fornito.

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

Esempio

Elencare i pool di agenti del cluster Kubernetes

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

Parametri necessari

--kubernetes-cluster-name

Nome del cluster Kubernetes.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az networkcloud kubernetescluster agentpool show

Anteprima

Il gruppo di comandi 'az networkcloud' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere le proprietà del pool di agenti del cluster Kubernetes fornito.

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

Esempio

Ottenere il pool di agenti del cluster Kubernetes

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

Parametri facoltativi

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

Nome del pool di agenti del cluster Kubernetes.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--kubernetes-cluster-name

Nome del cluster Kubernetes.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az networkcloud kubernetescluster agentpool update

Anteprima

Il gruppo di comandi 'az networkcloud' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare le proprietà del pool di agenti del cluster Kubernetes specificato oppure aggiornare i tag associati al pool di agenti del cluster Kubernetes. Le proprietà e gli aggiornamenti dei tag possono essere eseguiti in modo indipendente.

az networkcloud kubernetescluster agentpool update [--agent-pool-name]
                                                   [--count]
                                                   [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--ids]
                                                   [--kubernetes-cluster-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]

Esempio

Pool di agenti patch del cluster Kubernetes

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

Aggiornare le credenziali di amministratore del pool di agenti

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

Parametri facoltativi

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

Nome del pool di agenti del cluster Kubernetes.

--count

Numero di macchine virtuali che usano questa configurazione.

--generate-ssh-keys

Generare i file delle chiavi pubblica e privata SSH se mancanti. Le chiavi verranno archiviate in '~/.ssh'.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--kubernetes-cluster-name

Nome del cluster Kubernetes.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--ssh-dest-key-path

Elenco di percorsi separati da spazi per le chiavi pubbliche SSH. È possibile specificare un percorso di file o una directory. Se viene specificata una directory, tenterà di caricare tutte le chiavi pubbliche (.pub) trovate. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--ssh-key-values

Elenco di chiavi pubbliche SSH separate da spazi. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Tag delle risorse di Azure che sostituiranno quelli esistenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--upgrade-settings

Configurazione del pool di agenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az networkcloud kubernetescluster agentpool wait

Anteprima

Il gruppo di comandi 'az networkcloud' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

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

Parametri facoltativi

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

Nome del pool di agenti del cluster Kubernetes.

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

valore predefinito: False
--exists

Attendere che la risorsa esista.

valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

valore predefinito: 30
--kubernetes-cluster-name

Nome del cluster Kubernetes.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.