az aks nodepool
Note
Este grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.
Comandos para gerenciar pools de nós no cluster Kubernetes kubernetes.
Comandos
| Nome | Descrição | Tipo | Estado |
|---|---|---|---|
| az aks nodepool add |
Adicione um pool de nós ao cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool add (aks-preview extensão) |
Adicione um pool de nós ao cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool delete |
Exclua o pool de agentes no cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool delete (aks-preview extensão) |
Exclua o pool de agentes no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool delete-machines |
Exclua máquinas específicas em um pool de agentes para um cluster gerenciado. |
Core | disponibilidade geral |
| az aks nodepool delete-machines (aks-preview extensão) |
Exclua máquinas específicas em um pool de agentes para um cluster gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool get-upgrades |
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool get-upgrades (aks-preview extensão) |
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool list |
Listar pools de nós no cluster Kubernetes gerenciado. Para obter a lista de nós no comando de execução |
Core | disponibilidade geral |
| az aks nodepool list (aks-preview extensão) |
Listar pools de nós no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool manual-scale |
Comandos para gerenciar nodepool virtualMachineProfile.scale.manual. |
Núcleo e Extensão | disponibilidade geral |
| az aks nodepool manual-scale add |
Adicione um novo manual a um agentpool de VirtualMachines no cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool manual-scale add (aks-preview extensão) |
Adicione um novo manual a um agentpool de VirtualMachines no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool manual-scale delete |
Exclua um manual existente para um agentpool de VirtualMachines no cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool manual-scale delete (aks-preview extensão) |
Exclua um manual existente para um agentpool de VirtualMachines no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool manual-scale update |
Atualize um manual existente de um agentpool de VirtualMachines no cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool manual-scale update (aks-preview extensão) |
Atualize um manual existente de um agentpool de VirtualMachines no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool operation-abort |
Anule a última operação em execução no pool de nós. |
Core | disponibilidade geral |
| az aks nodepool operation-abort (aks-preview extensão) |
Anule a última operação em execução no pool de nós. |
Extension | disponibilidade geral |
| az aks nodepool scale |
Dimensione o pool de nós em um cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool scale (aks-preview extensão) |
Dimensione o pool de nós em um cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool show |
Mostrar os detalhes de um pool de nós no cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool show (aks-preview extensão) |
Mostrar os detalhes de um pool de nós no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool snapshot |
Comandos para gerenciar instantâneos do pool de nós. |
Núcleo e Extensão | disponibilidade geral |
| az aks nodepool snapshot create |
Crie um instantâneo do pool de nós. |
Core | disponibilidade geral |
| az aks nodepool snapshot create (aks-preview extensão) |
Crie um instantâneo do pool de nós. |
Extension | disponibilidade geral |
| az aks nodepool snapshot delete |
Exclua um instantâneo do pool de nós. |
Core | disponibilidade geral |
| az aks nodepool snapshot delete (aks-preview extensão) |
Exclua um instantâneo do pool de nós. |
Extension | disponibilidade geral |
| az aks nodepool snapshot list |
Listar instantâneos do pool de nós. |
Core | disponibilidade geral |
| az aks nodepool snapshot list (aks-preview extensão) |
Listar instantâneos do pool de nós. |
Extension | disponibilidade geral |
| az aks nodepool snapshot show |
Mostrar os detalhes de um instantâneo do pool de nós. |
Core | disponibilidade geral |
| az aks nodepool snapshot show (aks-preview extensão) |
Mostrar os detalhes de um instantâneo do pool de nós. |
Extension | disponibilidade geral |
| az aks nodepool snapshot update |
Atualize as tags em um instantâneo de um pool de nós. |
Core | disponibilidade geral |
| az aks nodepool snapshot update (aks-preview extensão) |
Atualize as tags em um instantâneo de um pool de nós. |
Extension | disponibilidade geral |
| az aks nodepool snapshot wait |
Aguarde até que um instantâneo do pool de nós atinja o estado desejado. |
Core | disponibilidade geral |
| az aks nodepool start |
Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool start (aks-preview extensão) |
Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool stop |
Pare de executar o pool de agentes no cluster Kubernetes gerenciado. |
Core | disponibilidade geral |
| az aks nodepool stop (aks-preview extensão) |
Pare de executar o pool de agentes no cluster Kubernetes gerenciado. |
Extension | disponibilidade geral |
| az aks nodepool update |
Atualize as propriedades de um pool de nós. |
Core | disponibilidade geral |
| az aks nodepool update (aks-preview extensão) |
Atualize as propriedades de um pool de nós. |
Extension | disponibilidade geral |
| az aks nodepool upgrade |
Atualizar o pool de nós num cluster Kubernetes gerido. |
Core | disponibilidade geral |
| az aks nodepool upgrade (aks-preview extensão) |
Atualizar o pool de nós num cluster Kubernetes gerido. |
Extension | disponibilidade geral |
| az aks nodepool wait |
Aguarde até que um pool de nós atinja o estado desejado. |
Core | disponibilidade geral |
az aks nodepool add
Adicione um pool de nós ao cluster Kubernetes gerenciado.
az aks nodepool add --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--allowed-host-ports]
[--asg-ids]
[--crg-id]
[--disable-windows-outbound-nat]
[--drain-timeout]
[--enable-cluster-autoscaler]
[--enable-encryption-at-host]
[--enable-fips-image]
[--enable-node-public-ip]
[--enable-secure-boot]
[--enable-ultra-ssd]
[--enable-vtpm]
[--eviction-policy {Deallocate, Delete}]
[--gateway-prefix-size]
[--gpu-driver {Install, None}]
[--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
[--host-group-id]
[--if-match]
[--if-none-match]
[--kubelet-config]
[--kubernetes-version]
[--labels]
[--linux-os-config]
[--localdns-config]
[--max-count]
[--max-pods]
[--max-surge]
[--max-unavailable]
[--message-of-the-day]
[--min-count]
[--mode {Gateway, System, User}]
[--no-wait]
[--node-count]
[--node-osdisk-size]
[--node-osdisk-type {Ephemeral, Managed}]
[--node-public-ip-prefix-id]
[--node-public-ip-tags]
[--node-soak-duration]
[--node-taints]
[--node-vm-size]
[--os-sku {AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022}]
[--os-type]
[--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
[--pod-subnet-id]
[--ppg]
[--priority {Regular, Spot}]
[--scale-down-mode {Deallocate, Delete}]
[--snapshot-id]
[--spot-max-price]
[--tags]
[--undrainable-node-behavior]
[--vm-set-type]
[--vm-sizes]
[--vnet-subnet-id]
[--workload-runtime {KataVmIsolation}]
[--zones]
Exemplos
Crie um nodepool em um cluster AKS existente com o sistema operacional efêmero habilitado.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48
Crie um nodepool com EncryptionAtHost habilitado.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host
Crie um pool de nós com UltraSSD ativado.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd
Criar um cluster de pool de nós com uma SKU de sistema operacional específica
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu
Criar um pool de nós com SO habilitado para FIPS
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image
Crie um cluster Kubernetes com um ID de instantâneo.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"
criar um nodepool em um cluster AKS existente com ID de grupo de hosts
az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize
crie um nodepool com uma ID de CRG (Grupo de Reserva de Capacidade).
az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"
Crie um nodepool com o modo de alocação ip definido como "StaticBlock" e usando um ID de sub-rede pod
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu --pod-subnet-id /subscriptions/SubID/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock
criar um nodepool do tipo VirtualMachines
az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --vm-set-type VirtualMachines --vm-sizes "VMSize1,VMSize2" --node-count 3
Cria um nodepool com o KataVmIsolation ativado.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku AzureLinux --vm-size Standard_D4s_v3 --workload-runtime KataVmIsolation --node-count 1
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Pares chave-valor separados por vírgulas para especificar cabeçalhos personalizados.
Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por espaços de intervalos com protocolo, por exemplo.
80/TCP 443/TCP 4000-5000/TCP.
As IDs dos grupos de segurança de aplicativos aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por espaços.
A id crg usada para associar o novo nodepool ao recurso existente do Grupo de Reserva de Capacidade.
Desative o Windows OutboundNAT no pool de nós do agente do Windows.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Quando os nós são drenados quantos minutos para esperar que todos os pods sejam removidos.
Habilite o autoscaler de cluster.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite EncryptionAtHost, o valor padrão é false.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Use o sistema operacional habilitado para FIPS nos nós do agente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o IP público do nó VMSS ou VMs.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite a Inicialização Segura no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS ou VMs.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Ative UltraSSD, o valor padrão é false.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o vTPM no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS ou VMs.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
A política de despejo do pool de nós Spot. Ele só pode ser definido quando --prioridade é Spot.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Delete |
| Valores aceites: | Deallocate, Delete |
O tamanho da correção IPPrefix Pública anexada ao pool de nós do modo Gateway. O pool de nós deve estar no modo Gateway.
Se deseja instalar o driver para o pool de nós da GPU. Os valores possíveis são "Install" ou "None". O padrão é "Instalar".
| Propriedade | Valor |
|---|---|
| Valores aceites: | Install, None |
Perfil de instância de GPU para particionar GPUs Nvidia multi-gpu.
| Propriedade | Valor |
|---|---|
| Valores aceites: | MIG1g, MIG2g, MIG3g, MIG4g, MIG7g |
O ID do grupo de host dedicado totalmente qualificado usado para provisionar o pool de nós do agente.
O valor fornecido será comparado com o ETag do agentpool, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.
Defina como '*' para permitir que um novo agentpool seja criado, mas para impedir a atualização de um agentpool existente. Outros valores serão ignorados.
Caminho para o arquivo JSON contendo configurações de Kubelet para nós de agente. https://aka.ms/aks/custom-node-config.
Versão do Kubernetes a ser usada para criar o cluster, como "1.16.9".
| Propriedade | Valor |
|---|---|
| Valor de: | `az aks get-versions` |
Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels para sintaxe de rótulos.
Caminho para o arquivo JSON contendo configurações do sistema operacional para nós do agente Linux. https://aka.ms/aks/custom-node-config.
Defina o perfil localDNS para um pool de nós com um arquivo de configuração JSON.
Contagem máxima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
O número máximo de pods implantáveis em um nó.
Se não for especificado, os padrões serão baseados no plug-in de rede. 30 para "azure", 110 para "kubenet" ou 250 para "none".
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 5 ou 33%.
O número máximo ou a porcentagem de nós que podem estar simultaneamente indisponíveis durante a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Caminho para um arquivo que contém a mensagem desejada do dia. Válido apenas para nós linux. Será escrito para /etc/motd.
Contagem mínima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
O modo para um pool de nós que define a função primária de um pool de nós. Se definido como "Sistema", o AKS prefere o agendamento de pods do sistema a pools de nós com o modo System. Saiba mais em https://aka.ms/aks/nodepool/mode.
| Propriedade | Valor |
|---|---|
| Valor padrão: | User |
| Valores aceites: | Gateway, System, User |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Número de nós no pool de agentes do Kubernetes. Depois de criar um cluster, você pode alterar o tamanho de seu pool de nós com az aks scale.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 3 |
Tamanho em GiB do disco do SO para cada nó no pool de agentes. Mínimo 30 GiB.
Tipo de disco do SO a ser usado para máquinas em um determinado pool de agentes. O padrão é 'Efêmero' quando possível em conjunto com o tamanho da VM e o tamanho do disco do sistema operacional. Não pode ser alterado para este pool após a criação. ('efémero' ou 'gerido').
| Propriedade | Valor |
|---|---|
| Valores aceites: | Ephemeral, Managed |
ID de prefixo IP público usado para atribuir IPs públicos a nós VMSS ou VMs.
As ipTags dos IPs públicos do nó.
A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.
As manchas do nó para o pool de nós.
Tamanho das máquinas virtuais a serem criadas como nós do Kubernetes. Se o usuário não especificar um, o servidor selecionará um tamanho de VM padrão para ele.
A SKU do sistema operacional do pool de nós do agente. Ubuntu, Ubuntu2204, AzureLinux ou AzureLinux3 para Linux. Windows2019 ou Windows2022 para Windows.
| Propriedade | Valor |
|---|---|
| Valores aceites: | AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022 |
O tipo de SO. Linux ou Windows.
Defina o modo de alocação de ip para saber como os IPs de Pod da Sub-rede de Pod do Azure são alocados aos nós no cluster AKS. A escolha é entre lotes dinâmicos de IPs individuais ou alocação estática de um conjunto de blocos CIDR. Os valores aceites são "DynamicIndividual" ou "StaticBlock".
Usado em conjunto com o plug-in de rede "azure". Requer --pod-subnet-id.
| Propriedade | Valor |
|---|---|
| Valores aceites: | DynamicIndividual, StaticBlock |
O Resource Id de uma sub-rede em uma VNet existente na qual atribuir pods no cluster (requer plug-in de rede azure).
O ID de um PPG.
A prioridade do pool de nós.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Regular |
| Valores aceites: | Regular, Spot |
Descreva como as VMs são adicionadas ou removidas dos pools de nós.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Delete |
| Valores aceites: | Deallocate, Delete |
A ID do instantâneo de origem usada para criar esse pool de nós.
Ele só pode ser definido quando --prioridade é Spot. Especifique o preço máximo que está disposto a pagar em dólares americanos. Os valores possíveis são qualquer valor decimal maior que zero ou -1 que indica o preço padrão a ser up-to sob demanda. Só pode incluir até 5 casas decimais.
| Propriedade | Valor |
|---|---|
| Valor padrão: | nan |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Schedule".
| Propriedade | Valor |
|---|---|
| Valor padrão: | Schedule |
Tipo de conjunto vm do pool de agentes. VirtualMachineScaleSets ou AvailabilitySet ou VirtualMachines. O padrão é 'VirtualMachineScaleSets'.
Lista separada por vírgulas de tamanhos de VM. Válido apenas para o pool de nós VirtualMachines. Se --vm-sizes não for especificado, mas --node-vm-size especificado, o valor de --node-vm-size será usado. Se nenhum deles for especificado, o padrão será Standard_DS2_v2 para Linux ou Standard_D2s_v3 para Windows.
A Id de Recurso de uma sub-rede em uma VNet existente na qual implantar o cluster.
Define o tempo de execução da carga de trabalho.
O Azure fornece um tempo de execução diferente da carga de trabalho para permitir cargas suportadas por Kata nos seus nodepools. Os seguintes valores podem ser especificados:
- "KataVmIsolation" para Kata.
| Propriedade | Valor |
|---|---|
| Valores aceites: | KataVmIsolation |
Zonas de disponibilidade onde os nós do agente serão colocados. Além disso, para instalar nós de agente em mais de uma zona, você precisa passar números de zona separados por espaços em branco. Por exemplo - Para ter todas as 3 zonas, espera-se que você entre em --zones 1 2 3.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool add (aks-preview extensão)
Adicione um pool de nós ao cluster Kubernetes gerenciado.
az aks nodepool add --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--allowed-host-ports]
[--asg-ids]
[--batch-soak-duration]
[--crg-id]
[--disable-windows-outbound-nat]
[--drain-batch-size]
[--drain-timeout]
[--drain-timeout-bg]
[--driver-type {CUDA, GRID}]
[--enable-artifact-streaming]
[--enable-cluster-autoscaler]
[--enable-encryption-at-host]
[--enable-fips-image]
[--enable-node-public-ip]
[--enable-secure-boot]
[--enable-ultra-ssd]
[--enable-vtpm]
[--eviction-policy {Deallocate, Delete}]
[--final-soak-duration]
[--gateway-prefix-size]
[--gpu-driver {Install, None}]
[--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
[--host-group-id]
[--if-match]
[--if-none-match]
[--kubelet-config]
[--kubernetes-version]
[--labels]
[--linux-os-config]
[--localdns-config]
[--max-blocked-nodes]
[--max-count]
[--max-pods]
[--max-surge]
[--max-unavailable]
[--message-of-the-day]
[--min-count]
[--mode {Gateway, Machines, ManagedSystem, System, User}]
[--no-wait]
[--node-count]
[--node-osdisk-size]
[--node-osdisk-type {Ephemeral, Managed}]
[--node-public-ip-prefix-id]
[--node-public-ip-tags]
[--node-soak-duration]
[--node-taints]
[--node-vm-size]
[--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
[--os-type]
[--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
[--pod-subnet-id]
[--ppg]
[--priority {Regular, Spot}]
[--scale-down-mode {Deallocate, Delete}]
[--snapshot-id]
[--spot-max-price]
[--ssh-access {disabled, entraid, localuser}]
[--tags]
[--undrainable-node-behavior]
[--upgrade-strategy {BlueGreen, Rolling}]
[--vm-set-type]
[--vm-sizes]
[--vnet-subnet-id]
[--workload-runtime {KataCcIsolation, KataMshvVmIsolation, KataVmIsolation, OCIContainer, WasmWasi}]
[--zones]
Exemplos
Crie um nodepool em um cluster AKS existente com o sistema operacional efêmero habilitado.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48
Crie um nodepool com EncryptionAtHost habilitado.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host
Criar um nodepool com um os-sku específico
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu
Crie um nodepool que possa executar cargas de trabalho wasm.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --workload-runtime WasmWasi
Crie um cluster Kubernetes com um ID de instantâneo.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"
crie um nodepool com uma ID de CRG (Grupo de Reserva de Capacidade).
az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"
criar um nodepool em um cluster AKS existente com ID de grupo de hosts
az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize
Crie um nodepool com o modo de alocação ip definido como "StaticBlock" e usando um ID de sub-rede pod
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu --pod-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock
Criar um pool de nós do tipo VirtualMachines
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "Standard_D4s_v3,Standard_D8s_v3" --node-count 3
Criar um pool de nós com o modo ManagedSystem
az aks nodepool add -g MyResourceGroup -n managedsystem1 --cluster-name MyManagedCluster --mode ManagedSystem
Criar um pool de nós com estratégia de atualização azul-verde e parâmetros padrão
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --upgrade-strategy BlueGreen
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por vírgulas de intervalos com protocolo, por exemplo. 80/TCP,443/TCP,4000-5000/TCP. Deve usar o tipo de pool de agentes VMSS.
As IDs dos grupos de segurança de aplicativos aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por vírgula. Deve usar o tipo de pool de agentes VMSS.
Tempo de espera (em minutos) depois de drenar um lote de nós antes de prosseguir para o próximo lote. O padrão é 15 minutos. Apenas para atualizações azul-verde.
O crg-id usado para associar o novo nodepool ao recurso de Grupo de Reserva de Capacidade existente. Deve usar o tipo de pool de agentes VMSS.
Desative o Windows OutboundNAT no pool de nós do agente do Windows. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Número ou porcentagem de nós a serem drenados por lote durante atualizações azul-verde. Aceita um número inteiro (por exemplo, «5») ou uma percentagem (por exemplo, «50%»). O padrão é 10%.
Especifica quantos nós drenar em cada lote durante uma atualização azul-verde. Deve ser um valor diferente de zero, seja como um inteiro (por exemplo, '5') ou uma porcentagem (por exemplo, '50%') do total de nós azuis no início da atualização. Os nós fracionários são arredondados para cima. Para obter mais detalhes e práticas recomendadas, consulte https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.
Quando os nós são drenados quantos minutos para esperar que todos os pods sejam removidos.
Tempo limite (em minutos) para remover pods e terminar graciosamente por nó durante atualizações azul-verde. O padrão é 30 minutos.
Tempo máximo (em minutos) para aguardar a remoção do pod e o término gracioso por nó durante as atualizações azul-verde. Honra os orçamentos de interrupção do pod. Se excedida, a atualização falhará. O padrão é 30 minutos.
Especifique o tipo de driver de GPU a ser instalado ao criar pools de agentes do Windows. Os valores válidos são "GRID" e "CUDA". Se não for fornecido, o AKS seleciona o driver com base na compatibilidade do sistema. Esta opção não pode ser alterada depois que o AgentPool tiver sido criado. O padrão é o sistema selecionado.
| Propriedade | Valor |
|---|---|
| Valores aceites: | CUDA, GRID |
Habilite o streaming de artefatos para VirtualMachineScaleSets gerenciados por um pool de nós, para acelerar o início a frio de contêineres em um nó por meio do carregamento de imagens sob demanda. Para usar esse recurso, as imagens de contêiner também devem habilitar o streaming de artefatos no ACR. Se não for especificado, o padrão será false.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o autoscaler de cluster. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite EncryptionAtHost no pool de nós do agente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Use o sistema operacional habilitado para FIPS nos nós do agente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o IP público do nó VMSS. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite a Inicialização Segura no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o UltraSSD no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o vTPM no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
A política de despejo do pool de nós Spot. Ele só pode ser definido quando --prioridade é Spot.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Delete |
| Valores aceites: | Deallocate, Delete |
Tempo de espera (em minutos) depois que todos os nós antigos são drenados antes de removê-los. O padrão é 60 minutos. Apenas para atualizações azul-verde.
O tamanho da correção IPPrefix Pública anexada ao pool de nós do modo Gateway. O pool de nós deve estar no modo Gateway.
Se deseja instalar o driver para o pool de nós da GPU. Os valores possíveis são "Install" ou "None". O padrão é "Instalar".
| Propriedade | Valor |
|---|---|
| Valores aceites: | Install, None |
Perfil de instância de GPU para particionar GPUs Nvidia multi-gpu.
| Propriedade | Valor |
|---|---|
| Valores aceites: | MIG1g, MIG2g, MIG3g, MIG4g, MIG7g |
(PRÉ-VISUALIZAÇÃO) O ID do grupo de host dedicado totalmente qualificado usado para provisionar o pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
O valor fornecido será comparado com o ETag do agentpool, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.
Defina como '*' para permitir que um novo agentpool seja criado, mas para impedir a atualização de um agentpool existente. Outros valores serão ignorados.
Configurações de Kubelet para nós de agente.
Versão do Kubernetes a ser usada para criar o cluster, como "1.7.12" ou "1.8.7".
| Propriedade | Valor |
|---|---|
| Valor de: | `az aks get-versions` |
Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels para sintaxe de rótulos.
Configurações do sistema operacional para nós do agente Linux.
Defina o perfil localDNS para um pool de nós com um arquivo de configuração JSON.
O número máximo ou a porcentagem de nós extras que podem ser bloqueados no pool de agentes durante uma atualização quando o comportamento do nó não drenável é Cordon. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Contagem máxima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
O número máximo de pods implantáveis em um nó.
Se não for especificado, os padrões serão baseados no plug-in de rede. 30 para "azure", 110 para "kubenet" ou 250 para "none".
| Propriedade | Valor |
|---|---|
| Valor padrão: | 0 |
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 5 ou 33%.
O número máximo ou a porcentagem de nós que podem estar simultaneamente indisponíveis durante a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Caminho para um arquivo que contém a mensagem desejada do dia. Válido apenas para nós linux. Será escrito para /etc/motd.
Contagem mínima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
O modo para um pool de nós que define a função primária de um pool de nós. Se definido como "Sistema", o AKS prefere o agendamento de pods do sistema a pools de nós com o modo System. Se definido como "ManagedSystem", todas as outras propriedades, exceto nome e modo, serão redefinidas e gerenciadas pelo AKS. Saiba mais em https://aka.ms/aks/nodepool/mode.
| Propriedade | Valor |
|---|---|
| Valor padrão: | User |
| Valores aceites: | Gateway, Machines, ManagedSystem, System, User |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Número de nós no pool de agentes do Kubernetes. Depois de criar um cluster, você pode alterar o tamanho de seu pool de nós com az aks scale.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 3 |
Tamanho em GiB do disco do SO para cada nó no pool de agentes. Mínimo 30 GiB.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 0 |
Tipo de disco do SO a ser usado para máquinas em um determinado pool de agentes. O padrão é 'Efêmero' quando possível em conjunto com o tamanho da VM e o tamanho do disco do sistema operacional. Não pode ser alterado para este pool após a criação. ('efémero' ou 'gerido').
| Propriedade | Valor |
|---|---|
| Valores aceites: | Ephemeral, Managed |
ID de prefixo IP público usado para atribuir IPs públicos a nós VMSS. Deve usar o tipo de pool de agentes VMSS.
As ipTags dos IPs públicos do nó. Deve usar o tipo de pool de agentes VMSS.
A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.
As manchas do nó para o pool de nós.
Tamanho das máquinas virtuais a serem criadas como nós do Kubernetes. Se o usuário não especificar um, o servidor selecionará um tamanho de VM padrão para ele.
O os-sku do pool de nós do agente. Ubuntu, Ubuntu2204, Ubuntu2404, CBLMariner, AzureLinux, AzureLinux3, AzureLinuxOSGuard, AzureLinux3OSGuard ou Flatcar quando o tipo de sistema operacional é Linux, o padrão é Ubuntu se não estiver definido; Windows2019, Windows2022, Windows2025 ou WindowsAnnual quando o tipo de sistema operacional é Windows, o padrão atual é Windows2022 se não estiver definido.
| Propriedade | Valor |
|---|---|
| Valores aceites: | AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual |
O tipo de SO. Linux ou Windows. Windows ainda não suportado para o tipo de conjunto de VM "VirtualMachines".
Defina o modo de alocação de ip para saber como os IPs de Pod da Sub-rede de Pod do Azure são alocados aos nós no cluster AKS. A escolha é entre lotes dinâmicos de IPs individuais ou alocação estática de um conjunto de blocos CIDR. Os valores aceites são "DynamicIndividual" ou "StaticBlock".
Usado em conjunto com o plug-in de rede "azure". Requer --pod-subnet-id.
| Propriedade | Valor |
|---|---|
| Valores aceites: | DynamicIndividual, StaticBlock |
A ID de uma sub-rede em uma VNet existente na qual atribuir pods no cluster (requer plug-in de rede azure).
O ID de um PPG. Deve usar o tipo de pool de agentes VMSS.
A prioridade do pool de nós.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Regular |
| Valores aceites: | Regular, Spot |
Descreve como as VMs são adicionadas ou removidas dos pools de nós.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Delete |
| Valores aceites: | Deallocate, Delete |
A ID do instantâneo de origem usada para criar esse pool de nós. Deve usar o tipo de pool de agentes VMSS.
Ele só pode ser definido quando --prioridade é Spot. Especifique o preço máximo que está disposto a pagar em dólares americanos. Os valores possíveis são qualquer valor decimal maior que zero ou -1 que indica o preço padrão a ser up-to sob demanda. Só pode incluir até 5 casas decimais.
| Propriedade | Valor |
|---|---|
| Valor padrão: | nan |
Configure a configuração SSH para o pool de nós. Use "disabled" para desativar o acesso SSH, "localuser" para habilitar o acesso SSH usando a chave privada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | localuser |
| Valores aceites: | disabled, entraid, localuser |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Schedule".
Estratégia de atualização para o pool de nós. Os valores permitidos são "Rolling" ou "BlueGreen". O padrão é "Rolling".
| Propriedade | Valor |
|---|---|
| Valores aceites: | BlueGreen, Rolling |
Tipo de conjunto vm do pool de agentes. VirtualMachineScaleSets, AvailabilitySet ou VirtualMachines(Preview).
Lista de tamanhos separados por vírgula. Deve usar o tipo de pool de agentes VirtualMachines.
A ID de uma sub-rede em uma VNet existente na qual implantar o cluster.
Determina o tipo de carga de trabalho que um nó pode executar. O padrão é OCIContainer.
| Propriedade | Valor |
|---|---|
| Valor padrão: | OCIContainer |
| Valores aceites: | KataCcIsolation, KataMshvVmIsolation, KataVmIsolation, OCIContainer, WasmWasi |
Lista separada por espaço de zonas de disponibilidade onde os nós do agente serão colocados. Deve usar o tipo de pool de agentes VMSS.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool delete
Exclua o pool de agentes no cluster Kubernetes gerenciado.
az aks nodepool delete --cluster-name
--name --nodepool-name
--resource-group
[--if-match]
[--ignore-pdb]
[--no-wait]
Exemplos
Excluir um pool de agentes com ignore-pdb
az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --if-match etag --ignore-pdb
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.
Exclua um nodepool existente sem considerar o Orçamento de interrupção do pod.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool delete (aks-preview extensão)
Exclua o pool de agentes no cluster Kubernetes gerenciado.
az aks nodepool delete --cluster-name
--name --nodepool-name
--resource-group
[--if-match]
[--ignore-pod-disruption-budget]
[--no-wait]
Exemplos
Excluir um pool de agentes com ignore-pod-disruption-budget
az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --ignore-pod-disruption-budget=true
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.
(PREVIEW) ignore-pod-disruption-budget exclui um nodepool existente sem considerar o Pod Disruption Budget.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool delete-machines
Exclua máquinas específicas em um pool de agentes para um cluster gerenciado.
az aks nodepool delete-machines --cluster-name
--machine-names
--name --nodepool-name
--resource-group
[--no-wait]
Exemplos
Excluir máquinas específicas em um pool de agentes
az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1
Parâmetros Obrigatórios
O nome do cluster.
Lista separada por espaço de nomes de máquinas do pool de agentes a serem excluídos.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool delete-machines (aks-preview extensão)
Exclua máquinas específicas em um pool de agentes para um cluster gerenciado.
az aks nodepool delete-machines --cluster-name
--machine-names
--name --nodepool-name
--resource-group
[--no-wait]
Exemplos
Excluir máquinas específicas em um pool de agentes
az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1
Parâmetros Obrigatórios
O nome do cluster.
Lista separada por espaço de nomes de máquinas do pool de agentes a serem excluídos.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool get-upgrades
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster Kubernetes gerenciado.
az aks nodepool get-upgrades --cluster-name
--name --nodepool-name
--resource-group
Exemplos
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster Kubernetes gerenciado.
az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool get-upgrades (aks-preview extensão)
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster Kubernetes gerenciado.
az aks nodepool get-upgrades --cluster-name
--name --nodepool-name
--resource-group
Exemplos
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster Kubernetes gerenciado.
az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool list
Listar pools de nós no cluster Kubernetes gerenciado. Para obter a lista de nós no comando de execução kubectl get nodes do cluster.
az aks nodepool list --cluster-name
--resource-group
Parâmetros Obrigatórios
O nome do cluster.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool list (aks-preview extensão)
Listar pools de nós no cluster Kubernetes gerenciado.
az aks nodepool list --cluster-name
--resource-group
Parâmetros Obrigatórios
O nome do cluster.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool operation-abort
Anule a última operação em execução no pool de nós.
az aks nodepool operation-abort --cluster-name
--name --nodepool-name
--resource-group
[--no-wait]
Exemplos
Anular operação no pool de agentes
az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool operation-abort (aks-preview extensão)
Anule a última operação em execução no pool de nós.
az aks nodepool operation-abort --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Anular operação no pool de agentes
az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool scale
Dimensione o pool de nós em um cluster Kubernetes gerenciado.
az aks nodepool scale --cluster-name
--name --nodepool-name
--resource-group
[--no-wait]
[--node-count]
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Número de nós no pool de nós do Kubernetes.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 3 |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool scale (aks-preview extensão)
Dimensione o pool de nós em um cluster Kubernetes gerenciado.
az aks nodepool scale --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--no-wait]
[--node-count]
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Número de nós no pool de nós do Kubernetes.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 3 |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool show
Mostrar os detalhes de um pool de nós no cluster Kubernetes gerenciado.
az aks nodepool show --cluster-name
--name --nodepool-name
--resource-group
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool show (aks-preview extensão)
Mostrar os detalhes de um pool de nós no cluster Kubernetes gerenciado.
az aks nodepool show --cluster-name
--name --nodepool-name
--resource-group
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool start
Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado.
az aks nodepool start --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Iniciar pool de agentes no cluster gerenciado
az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool start (aks-preview extensão)
Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado.
az aks nodepool start --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Iniciar pool de agentes no cluster gerenciado
az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool stop
Pare de executar o pool de agentes no cluster Kubernetes gerenciado.
az aks nodepool stop --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Parar pool de agentes no cluster gerenciado
az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool stop (aks-preview extensão)
Pare de executar o pool de agentes no cluster Kubernetes gerenciado.
az aks nodepool stop --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Parar pool de agentes no cluster gerenciado
az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool update
Atualize as propriedades de um pool de nós.
Atualize um pool de nós para habilitar/desabilitar o escalonamento automático de cluster ou alterar a contagem mínima ou a contagem máxima. Quando chamado sem argumentos opcionais, ele tenta mover o pool de nós para seu estado de destino sem alterar a configuração atual do pool de nós. Isso pode ser usado para sair de um estado sem êxito.
az aks nodepool update --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--allowed-host-ports]
[--asg-ids]
[--disable-cluster-autoscaler]
[--disable-fips-image]
[--disable-secure-boot]
[--disable-vtpm]
[--drain-timeout]
[--enable-cluster-autoscaler]
[--enable-fips-image]
[--enable-secure-boot]
[--enable-vtpm]
[--if-match]
[--if-none-match]
[--labels]
[--localdns-config]
[--max-count]
[--max-surge]
[--max-unavailable]
[--min-count]
[--mode {Gateway, System, User}]
[--no-wait]
[--node-soak-duration]
[--node-taints]
[--os-sku {AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204}]
[--scale-down-mode {Deallocate, Delete}]
[--tags]
[--undrainable-node-behavior]
[--update-cluster-autoscaler]
Exemplos
Reconcilie o nodepool de volta ao seu estado atual.
az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Habilitar o escalonador automático de cluster dentro do intervalo de contagem de nós [1,5]
az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Desabilitar o autodimensionador de cluster para um cluster existente
az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Atualize a contagem mínima ou a contagem máxima para o autoscaler de cluster.
az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Pares chave-valor separados por vírgulas para especificar cabeçalhos personalizados.
Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por espaços de intervalos com protocolo, por exemplo.
80/TCP 443/TCP 4000-5000/TCP.
As IDs dos grupos de segurança de aplicativos aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por espaços.
Desative o autoscaler do cluster.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mude para usar SO não habilitado para FIPS em nós de agente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Desative a Inicialização Segura em um pool de nós de agente habilitado para Inicialização Confiável existente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Desative o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Quando os nós são drenados quantos minutos para esperar que todos os pods sejam removidos.
Habilite o autoscaler de cluster.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mude para usar o sistema operacional habilitado para FIPS nos nós do agente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite a Inicialização Segura em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS ou VMs.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS ou VMs.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.
Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.
Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels para sintaxe de rótulos.
Defina o perfil localDNS para um pool de nós com um arquivo de configuração JSON.
Contagem máxima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 5 ou 33%.
O número máximo ou a porcentagem de nós que podem estar simultaneamente indisponíveis durante a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Contagem mínima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
O modo para um pool de nós que define a função primária de um pool de nós. Se definido como "Sistema", o AKS prefere o agendamento de pods do sistema a pools de nós com o modo System. Saiba mais em https://aka.ms/aks/nodepool/mode.
| Propriedade | Valor |
|---|---|
| Valores aceites: | Gateway, System, User |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.
As manchas do nó para o pool de nós. Você pode atualizar a coloração de nó existente de um pool de nós ou criar uma nova coloração de nó para um pool de nós. Passe a corda "" vazia para remover todas as manchas.
O os-sku do pool de nós do agente.
| Propriedade | Valor |
|---|---|
| Valores aceites: | AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204 |
Descreva como as VMs são adicionadas ou removidas dos pools de nós.
| Propriedade | Valor |
|---|---|
| Valores aceites: | Deallocate, Delete |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Schedule".
Atualize a contagem mínima ou a contagem máxima para o autoscaler de cluster.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool update (aks-preview extensão)
Atualize as propriedades de um pool de nós.
Atualize um pool de nós para habilitar/desabilitar o escalonamento automático de cluster ou alterar a contagem mínima ou a contagem máxima. Quando chamado sem argumentos opcionais, ele tenta mover o pool de nós para seu estado de destino sem alterar a configuração atual do pool de nós. Isso pode ser usado para sair de um estado sem êxito.
az aks nodepool update --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--allowed-host-ports]
[--asg-ids]
[--batch-soak-duration]
[--disable-cluster-autoscaler]
[--disable-fips-image]
[--disable-secure-boot]
[--disable-vtpm]
[--drain-batch-size]
[--drain-timeout]
[--drain-timeout-bg]
[--enable-artifact-streaming]
[--enable-cluster-autoscaler]
[--enable-fips-image]
[--enable-secure-boot]
[--enable-vtpm]
[--final-soak-duration]
[--gpu-driver {Install, None}]
[--if-match]
[--if-none-match]
[--labels]
[--localdns-config]
[--max-blocked-nodes]
[--max-count]
[--max-surge]
[--max-unavailable]
[--min-count]
[--mode {Gateway, Machines, ManagedSystem, System, User}]
[--no-wait]
[--node-soak-duration]
[--node-taints]
[--node-vm-size]
[--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404}]
[--scale-down-mode {Deallocate, Delete}]
[--ssh-access {disabled, entraid, localuser}]
[--tags]
[--undrainable-node-behavior]
[--update-cluster-autoscaler]
[--upgrade-strategy {BlueGreen, Rolling}]
[--yes]
Exemplos
Reconcilie o nodepool de volta ao seu estado atual.
az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Habilitar o escalonador automático de cluster dentro do intervalo de contagem de nós [1,5]
az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Desabilitar o autodimensionador de cluster para um cluster existente
az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Atualize a contagem mínima ou a contagem máxima para o autoscaler de cluster.
az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Alterar um pool de nós para o modo de sistema
az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Atualizar o tamanho da vm do autoscaler do cluster, a contagem mínima e a contagem máxima para o pool de nós de máquinas virtuais
az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --update-cluster-autoscaler --node-vm-size "Standard_D2s_v3" --min-count 2 --max-count 4
Atualizar um pool de nós com configurações de atualização azul-verde
az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --drain-batch-size 50% --drain-timeout-bg 5 --batch-soak-duration 10 --final-soak-duration 10
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por vírgulas de intervalos com protocolo, por exemplo. 80/TCP,443/TCP,4000-5000/TCP. Deve usar o tipo de pool de agentes VMSS.
As IDs dos grupos de segurança de aplicativos aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por vírgula. Deve usar o tipo de pool de agentes VMSS.
Tempo de espera (em minutos) depois de drenar um lote de nós antes de prosseguir para o próximo lote. O padrão é 15 minutos. Apenas para atualizações azul-verde.
Desative o autoscaler do cluster.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mude para usar SO não habilitado para FIPS em nós de agente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Desative a Inicialização Segura em um pool de nós de agente habilitado para Inicialização Confiável existente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Desative o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Número ou porcentagem de nós a serem drenados por lote durante atualizações azul-verde. Aceita um número inteiro (por exemplo, «5») ou uma percentagem (por exemplo, «50%»). O padrão é 10%.
Especifica quantos nós drenar em cada lote durante uma atualização azul-verde. Deve ser um valor diferente de zero, seja como um inteiro (por exemplo, '5') ou uma porcentagem (por exemplo, '50%') do total de nós azuis no início da atualização. Os nós fracionários são arredondados para cima. Para obter mais detalhes e práticas recomendadas, consulte: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.
Quando os nós são drenados quantos minutos para esperar que todos os pods sejam removidos.
Tempo limite (em minutos) para remover pods e terminar graciosamente por nó durante atualizações azul-verde. O padrão é 30 minutos.
Tempo máximo (em minutos) para aguardar a remoção do pod e o término gracioso por nó durante as atualizações azul-verde. Honra os orçamentos de interrupção do pod. Se excedida, a atualização falhará. O padrão é 30 minutos.
Habilite o streaming de artefatos para VirtualMachineScaleSets gerenciados por um pool de nós, para acelerar o início a frio de contêineres em um nó por meio do carregamento de imagens sob demanda. Para usar esse recurso, as imagens de contêiner também devem habilitar o streaming de artefatos no ACR. Se não for especificado, o padrão será false.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o autoscaler de cluster. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mude para usar o sistema operacional habilitado para FIPS nos nós do agente.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite a Inicialização Segura em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Habilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Tempo de espera (em minutos) depois que todos os nós antigos são drenados antes de removê-los. O padrão é 60 minutos. Apenas para atualizações azul-verde.
Se deseja instalar o driver para o pool de nós da GPU. Os valores possíveis são "Install" ou "None".
| Propriedade | Valor |
|---|---|
| Valores aceites: | Install, None |
O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.
Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.
Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels para sintaxe de rótulos.
Defina o perfil localDNS para um pool de nós com um arquivo de configuração JSON.
O número máximo ou a porcentagem de nós extras que podem ser bloqueados no pool de agentes durante uma atualização quando o comportamento do nó não drenável é Cordon. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Contagem máxima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 5 ou 33%.
O número máximo ou a porcentagem de nós que podem estar simultaneamente indisponíveis durante a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Contagem mínima de nós usada para autoscaler, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.
O modo para um pool de nós que define a função primária de um pool de nós. Se definido como "Sistema", o AKS prefere o agendamento de pods do sistema a pools de nós com o modo System. Se definido como "ManagedSystem", todas as outras propriedades, exceto nome e modo, serão rejeitadas e gerenciadas pelo AKS. Saiba mais em https://aka.ms/aks/nodepool/mode.
| Propriedade | Valor |
|---|---|
| Valores aceites: | Gateway, Machines, ManagedSystem, System, User |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.
As manchas do nó para o pool de nós.
Tamanho da VM para nós do Kubernetes. Configurável somente ao atualizar as configurações de dimensionamento automático de um pool de nós VirtualMachines.
O os-sku do pool de nós do agente.
| Propriedade | Valor |
|---|---|
| Valores aceites: | AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404 |
Descreve como as VMs são adicionadas ou removidas dos pools de nós.
| Propriedade | Valor |
|---|---|
| Valores aceites: | Deallocate, Delete |
Atualize a configuração SSH para o pool de nós. Use "disabled" para desativar o acesso SSH, "localuser" para habilitar o acesso SSH usando a chave privada.
| Propriedade | Valor |
|---|---|
| Valores aceites: | disabled, entraid, localuser |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Schedule".
Atualize a contagem mínima ou a contagem máxima para o autoscaler de cluster.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Estratégia de atualização para o pool de nós. Os valores permitidos são "Rolling" ou "BlueGreen". O padrão é "Rolling".
| Propriedade | Valor |
|---|---|
| Valores aceites: | BlueGreen, Rolling |
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool upgrade
Atualizar o pool de nós num cluster Kubernetes gerido.
az aks nodepool upgrade --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--drain-timeout]
[--if-match]
[--if-none-match]
[--kubernetes-version]
[--max-surge]
[--max-unavailable]
[--no-wait]
[--node-image-only]
[--node-soak-duration]
[--snapshot-id]
[--undrainable-node-behavior]
[--yes]
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Pares chave-valor separados por vírgulas para especificar cabeçalhos personalizados.
Quando os nós são drenados, quanto tempo esperar para que todos os pods sejam removidos.
O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool. Para solicitações de versão de imagem de nó de atualização, isso será ignorado.
Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.
Versão do Kubernetes para atualizar o pool de nós para, como "1.16.9".
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 5 ou 33% (mutuamente exclusivos com "--node-image-only". Consulte "az aks nodepool update --max-surge" para atualizar max surge antes de atualizar com "--node-image-only").
O número máximo ou a porcentagem de nós que podem estar simultaneamente indisponíveis durante a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Atualize apenas a imagem do nó do pool de agentes.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.
O ID do instantâneo de origem usado para atualizar esse pool de nós.
Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Schedule".
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool upgrade (aks-preview extensão)
Atualizar o pool de nós num cluster Kubernetes gerido.
az aks nodepool upgrade --cluster-name
--name --nodepool-name
--resource-group
[--aks-custom-headers]
[--batch-soak-duration]
[--drain-batch-size]
[--drain-timeout]
[--drain-timeout-bg]
[--final-soak-duration]
[--if-match]
[--if-none-match]
[--kubernetes-version]
[--max-blocked-nodes]
[--max-surge]
[--max-unavailable]
[--no-wait]
[--node-image-only]
[--node-soak-duration]
[--snapshot-id]
[--undrainable-node-behavior]
[--upgrade-strategy {BlueGreen, Rolling}]
[--yes]
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Tempo de espera (em minutos) depois de drenar um lote de nós antes de prosseguir para o próximo lote. O padrão é 15 minutos. Apenas para atualizações azul-verde.
Número ou porcentagem de nós a serem drenados por lote durante atualizações azul-verde. Aceita um número inteiro (por exemplo, «5») ou uma percentagem (por exemplo, «50%»). O padrão é 10%.
Especifica quantos nós drenar em cada lote durante uma atualização azul-verde. Deve ser um valor diferente de zero, seja como um inteiro (por exemplo, '5') ou uma porcentagem (por exemplo, '50%') do total de nós azuis no início da atualização. Os nós fracionários são arredondados para cima. Para obter mais detalhes e práticas recomendadas, consulte: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.
Quando os nós são drenados quantos minutos para esperar que todos os pods sejam removidos.
Tempo limite (em minutos) para remover pods e terminar graciosamente por nó durante atualizações azul-verde. O padrão é 30 minutos.
Tempo máximo (em minutos) para aguardar a remoção do pod e o término gracioso por nó durante as atualizações azul-verde. Honra os orçamentos de interrupção do pod. Se excedida, a atualização falhará. O padrão é 30 minutos.
Tempo de espera (em minutos) depois que todos os nós antigos são drenados antes de removê-los. O padrão é 60 minutos. Apenas para atualizações azul-verde.
O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool. Para solicitações de versão de imagem de nó de atualização, isso será ignorado.
Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.
Versão do Kubernetes para atualizar o pool de nós, como "1.11.12".
O número máximo ou a porcentagem de nós extras que podem ser bloqueados no pool de agentes durante uma atualização quando o comportamento do nó não drenável é Cordon. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 5 ou 33%.
O número máximo ou a porcentagem de nós que podem estar simultaneamente indisponíveis durante a atualização. Quando especificado, representa o número ou percentagem utilizada, por exemplo. 1 ou 5%.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Atualize apenas a imagem do nó do pool de agentes.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.
O ID do instantâneo de origem usado para atualizar esse pool de nós. Deve usar o tipo de pool de agentes VMSS.
Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Schedule".
Estratégia de atualização para o pool de nós. Os valores permitidos são "Rolling" ou "BlueGreen". O padrão é "Rolling".
| Propriedade | Valor |
|---|---|
| Valores aceites: | BlueGreen, Rolling |
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az aks nodepool wait
Aguarde até que um pool de nós atinja o estado desejado.
Se uma operação em um pool de nós foi interrompida ou iniciada com --no-wait, use este comando para aguardar a conclusão.
az aks nodepool wait --cluster-name
--name --nodepool-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Exemplos
Aguarde até que um pool de nós atinja o estado desejado, sondando a cada minuto por até trinta minutos.
az aks nodepool wait --created --interval 60 --cluster-name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800
Parâmetros Obrigatórios
O nome do cluster.
O nome do pool de nós.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
Aguarde até ser excluído.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que o recurso exista.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Intervalo de sondagem em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | 30 |
Espera máxima em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | 3600 |
Aguarde até ser atualizado com provisioningState em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Parâmetros globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |