az aks nodepool
Observação
Esse 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 | Description | Tipo | Status |
---|---|---|---|
az aks nodepool add |
Adicione um pool de nós ao cluster gerenciado do Kubernetes. |
Núcleo | GA |
az aks nodepool add (aks-preview extensão) |
Adicione um pool de nós ao cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool delete |
Exclua o pool de agentes no cluster gerenciado do Kubernetes. |
Núcleo | GA |
az aks nodepool delete (aks-preview extensão) |
Exclua o pool de agentes no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool delete-machines |
Exclua computadores específicos em um pool de agentes para um cluster gerenciado. |
Núcleo | GA |
az aks nodepool delete-machines (aks-preview extensão) |
Exclua computadores específicos em um pool de agentes para um cluster gerenciado. |
Extensão | GA |
az aks nodepool get-upgrades |
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes. |
Núcleo | GA |
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 gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool list |
Liste pools de nós no cluster gerenciado do Kubernetes. Para obter a lista de nós no cluster, execute |
Núcleo | GA |
az aks nodepool list (aks-preview extensão) |
Liste pools de nós no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool manual-scale |
Comandos para gerenciar o pool de nós virtualMachineProfile.scale.manual. |
Extensão | GA |
az aks nodepool manual-scale add |
Adicione um novo manual a um pool de agentes do VirtualMachines no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool manual-scale delete |
Exclua um manual existente para um pool de agentes VirtualMachines no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool manual-scale update |
Atualize um manual existente de um agentpool de Máquinas Virtuais no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool operation-abort |
Anule a última operação em execução no pool de nós. |
Núcleo | GA |
az aks nodepool operation-abort (aks-preview extensão) |
Anule a última operação em execução no pool de nós. |
Extensão | GA |
az aks nodepool scale |
Dimensione o pool de nós em um cluster gerenciado do Kubernetes. |
Núcleo | GA |
az aks nodepool scale (aks-preview extensão) |
Dimensione o pool de nós em um cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool show |
Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes. |
Núcleo | GA |
az aks nodepool show (aks-preview extensão) |
Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool snapshot |
Comandos para gerenciar instantâneos do pool de nós. |
Núcleo e Extensão | GA |
az aks nodepool snapshot create |
Crie um instantâneo do pool de nós. |
Núcleo | GA |
az aks nodepool snapshot create (aks-preview extensão) |
Crie um instantâneo do pool de nós. |
Extensão | GA |
az aks nodepool snapshot delete |
Exclua um instantâneo do pool de nós. |
Núcleo | GA |
az aks nodepool snapshot delete (aks-preview extensão) |
Exclua um instantâneo do pool de nós. |
Extensão | GA |
az aks nodepool snapshot list |
Listar instantâneos do pool de nós. |
Núcleo | GA |
az aks nodepool snapshot list (aks-preview extensão) |
Listar instantâneos do pool de nós. |
Extensão | GA |
az aks nodepool snapshot show |
Mostre os detalhes de um instantâneo do pool de nós. |
Núcleo | GA |
az aks nodepool snapshot show (aks-preview extensão) |
Mostre os detalhes de um instantâneo do pool de nós. |
Extensão | GA |
az aks nodepool snapshot update |
Atualize as tags em um instantâneo de um pool de nós. |
Núcleo | GA |
az aks nodepool snapshot update (aks-preview extensão) |
Atualize as tags em um instantâneo de um pool de nós. |
Extensão | GA |
az aks nodepool snapshot wait |
Aguarde até que um instantâneo do pool de nós atinja um estado desejado. |
Núcleo | GA |
az aks nodepool start |
Inicie o pool de agentes parado no cluster gerenciado do Kubernetes. |
Núcleo | GA |
az aks nodepool start (aks-preview extensão) |
Inicie o pool de agentes parado no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool stop |
Pare de executar o pool de agentes no cluster gerenciado do Kubernetes. |
Núcleo | GA |
az aks nodepool stop (aks-preview extensão) |
Pare de executar o pool de agentes no cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool update |
Atualize as propriedades de um pool de nós. |
Núcleo | GA |
az aks nodepool update (aks-preview extensão) |
Atualize as propriedades de um pool de nós. |
Extensão | GA |
az aks nodepool upgrade |
Atualize o pool de nós em um cluster gerenciado do Kubernetes. |
Núcleo | GA |
az aks nodepool upgrade (aks-preview extensão) |
Atualize o pool de nós em um cluster gerenciado do Kubernetes. |
Extensão | GA |
az aks nodepool wait |
Aguarde até que um pool de nós atinja um estado desejado. |
Núcleo | GA |
az aks nodepool add
Adicione um pool de nós ao cluster gerenciado do Kubernetes.
az aks nodepool add --cluster-name
--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}]
[--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
[--host-group-id]
[--if-match]
[--if-none-match]
[--kubelet-config]
[--kubernetes-version]
[--labels]
[--linux-os-config]
[--max-count]
[--max-pods]
[--max-surge]
[--min-count]
[--mode {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, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022}]
[--os-type]
[--pod-subnet-id]
[--ppg]
[--priority {Regular, Spot}]
[--scale-down-mode {Deallocate, Delete}]
[--snapshot-id]
[--spot-max-price]
[--tags]
[--vnet-subnet-id]
[--zones]
Exemplos
Crie um pool de nós em um cluster do 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 pool de nós 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 um SKU de sistema operacional específico
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu
Criar um pool de nós com sistema operacional habilitado para FIPS
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image
Crie um cluster do Kubernetes com uma ID de snapshot.
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 pool de nós em um cluster do AKS existente com a ID do 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 pool de nós com uma ID do Grupo de Reserva de Capacidade (CRG).
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"
Parâmetros Exigidos
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
Pares de chave-valor separados por vírgula 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 do aplicativo aos quais o adaptador de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separadas por espaços.
A id crg usada para associar o novo pool de nós ao recurso Grupo de Reserva de Capacidade existente.
Desative o Windows OutboundNAT no pool de nós do agente do Windows.
Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.
Habilite o dimensionador automático de cluster.
Habilite EncryptionAtHost, o valor padrão é false.
Use o sistema operacional habilitado para FIPS em nós de agente.
Habilite o IP público do nó VMSS.
Habilite a Inicialização Segura no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
Ativar UltraSSD, o valor padrão é false.
Habilite o vTPM no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
A política de remoção do pool de nós spot. Ele só pode ser definido quando --priority for Spot.
Perfil de instância de GPU para particionar GPUs Nvidia multi-GPU.
A ID do grupo de hosts dedicado totalmente qualificada usada para provisionar o pool de nós do agente.
O valor fornecido será comparado com a ETag do agentpool, se corresponder à operação continuará. 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 que contém as configurações do Kubelet para nós do agente. https://aka.ms/aks/custom-node-config.
Versão do Kubernetes a ser usada para criar o cluster, como "1.16.9".
Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.
Caminho para o arquivo JSON que contém as configurações do sistema operacional para nós do agente do Linux. https://aka.ms/aks/custom-node-config.
Contagem máxima de nós usada para o dimensionador automático, 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 implantados 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 porcentagem usada, por exemplo. 5 ou 33%.
Contagem mínima de nós usada para o dimensionador automático, 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 de 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 para pools de nós com o modo System
. Saiba mais em https://aka.ms/aks/nodepool/mode.
Não aguarde a conclusão da operação de execução longa.
Número de nós no pool de agentes do Kubernetes. Depois de criar um cluster, você pode alterar o tamanho do pool de nós com az aks scale
.
Tamanho em GiB do disco do sistema operacional para cada nó no pool de agentes. Mínimo de 30 GiB.
Tipo de disco do sistema operacional a ser usado para computadores 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 'Gerenciado').
ID de prefixo de IP público usado para atribuir IPs públicos a nós VMSS.
As ipTags dos IPs públicos do nó.
A quantidade de tempo (em minutos) a aguardar após drenar um nó e antes de reimaginá-lo e passar para o próximo nó.
Os contaminadores do nó para o pool de nós.
Tamanho das máquinas virtuais para criar como nós do Kubernetes.
O SKU do sistema operacional do pool de nós do agente. Ubuntu ou CBLMariner para Linux. Windows2019 ou Windows2022 para Windows.
O tipo de sistema operacional. Linux ou Windows.
A ID do recurso de uma sub-rede em uma VNet existente na qual atribuir pods no cluster (requer azure network-plugin).
O ID de um PPG.
A prioridade do pool de nós.
Descreva como as VMs são adicionadas ou removidas dos pools de nós.
O ID do instantâneo de origem usado para criar esse pool de nós.
Ele só pode ser definido quando --priority for Spot. Especifique o preço máximo que você está disposto a pagar em dólares americanos. Os valores possíveis são qualquer valor decimal maior que zero ou -1, o que indica que o preço padrão está ativo sob demanda. Ele só pode incluir até 5 casas decimais.
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.
A ID do recurso de uma sub-rede em uma VNet existente na qual implantar o cluster.
Zonas de disponibilidade em que 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ê insira --zones 1 2 3
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool add (aks-preview extensão)
Adicione um pool de nós ao cluster gerenciado do Kubernetes.
az aks nodepool add --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--allowed-host-ports]
[--asg-ids]
[--crg-id]
[--disable-windows-outbound-nat]
[--drain-timeout]
[--driver-type {CUDA, GRID}]
[--enable-artifact-streaming]
[--enable-cluster-autoscaler]
[--enable-custom-ca-trust]
[--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-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
[--host-group-id]
[--if-match]
[--if-none-match]
[--kubelet-config]
[--kubernetes-version]
[--labels]
[--linux-os-config]
[--max-count]
[--max-pods]
[--max-surge]
[--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, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual}]
[--os-type]
[--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
[--pod-subnet-id]
[--ppg]
[--priority {Regular, Spot}]
[--scale-down-mode {Deallocate, Delete}]
[--skip-gpu-driver-install]
[--snapshot-id]
[--spot-max-price]
[--ssh-access {disabled, localuser}]
[--tags]
[--undrainable-node-behavior]
[--vm-set-type]
[--vm-sizes]
[--vnet-subnet-id]
[--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
[--zones]
Exemplos
Crie um pool de nós em um cluster do 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 pool de nós com EncryptionAtHost habilitado.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host
Criar um pool de nós com um os-sku específico
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu
Crie um pool de nós que possa executar cargas de trabalho wasm.
az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --workload-runtime WasmWasi
Crie um cluster do Kubernetes com uma ID de snapshot.
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 pool de nós com uma ID do Grupo de Reserva de Capacidade (CRG).
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 pool de nós em um cluster do AKS existente com a ID do 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
Criar um pool de nós com o modo de alocação de ip definido como "StaticBlock" e usando um ID de sub-rede de 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
Parâmetros Exigidos
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
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 do aplicativo aos quais o adaptador de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por vírgulas. Deve usar o tipo de pool de agentes VMSS.
O crg-id usado para associar o novo pool de nós 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.
Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.
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 selecionará o driver com base na compatibilidade do sistema. Essa opção não pode ser alterada depois que o AgentPool for criado. O padrão é sistema selecionado.
Habilite o streaming de artefato para VirtualMachineScaleSets gerenciado por um pool de nós, para acelerar a inicialização a frio de contêineres em um nó por meio do carregamento de imagem sob demanda. Para usar esse recurso, as imagens de contêiner também devem habilitar o streaming de artefato no ACR. Se não for especificado, o padrão será false.
Habilite o dimensionador automático de cluster. Deve usar o tipo de pool de agentes VMSS.
Habilite a confiança de CA personalizada no pool de nós do agente.
Habilite EncryptionAtHost no pool de nós do agente.
Use o sistema operacional habilitado para FIPS em nós de agente.
Habilite o IP público do nó VMSS. Deve usar o tipo de pool de agentes VMSS.
Habilite a Inicialização Segura no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
Habilite o UltraSSD no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
Habilite o vTPM no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
A política de remoção do pool de nós spot. Ele só pode ser definido quando --priority for Spot.
O tamanho do IPPrefix público anexado ao pool de nós do modo Gateway. O pool de nós deve estar no modo Gateway.
Perfil de instância de GPU para particionar GPUs Nvidia multi-GPU.
(VISUALIZAÇÃO) A ID do grupo de hosts dedicado totalmente qualificada usada para provisionar o pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.
O valor fornecido será comparado com a ETag do agentpool, se corresponder à operação continuará. 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 do 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".
Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.
Configurações do sistema operacional para nós do agente do Linux.
Contagem máxima de nós usada para o dimensionador automático, 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 implantados 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 porcentagem usada, por exemplo. 5 ou 33%.
Caminho para um arquivo contendo a mensagem desejada do dia. Válido apenas para nós linux. Será escrito em /etc/motd.
Contagem mínima de nós usada para o dimensionador automático, 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 de 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 para pools de nós com o modo System
. Saiba mais em https://aka.ms/aks/nodepool/mode.
Não aguarde a conclusão da operação de execução longa.
Número de nós no pool de agentes do Kubernetes. Depois de criar um cluster, você pode alterar o tamanho do pool de nós com az aks scale
.
Tamanho em GiB do disco do sistema operacional para cada nó no pool de agentes. Mínimo de 30 GiB.
Tipo de disco do sistema operacional a ser usado para computadores 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 'Gerenciado').
ID de prefixo de 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) a aguardar após drenar um nó e antes de reimaginá-lo e passar para o próximo nó.
Os contaminadores do nó para o pool de nós.
Tamanho das máquinas virtuais para criar como nós do Kubernetes.
O os-sku do pool de nós do agente. Ubuntu ou CBLMariner quando o tipo de sistema operacional é Linux, o padrão é Ubuntu se não estiver definido; Windows2019, Windows2022 ou WindowsAnnual quando o tipo de sistema operacional é Windows, o padrão atual é Windows2022 se não estiver definido.
O tipo de sistema operacional. Linux ou Windows. O Windows ainda não é compatível com o tipo de conjunto de VM "VirtualMachines".
Defina o modo de alocação de ip para como os IPs de pod da sub-rede do Azure Pod são alocados para os nós no cluster do AKS. A escolha é entre lotes dinâmicos de IPs individuais ou alocação estática de um conjunto de blocos CIDR. Os valores aceitos são "DynamicIndividual" ou "StaticBlock".
Usado em conjunto com o plug-in de rede "azure". Requer --pod-subnet-id.
A ID de uma sub-rede em uma VNet existente na qual atribuir pods no cluster (requer azure network-plugin).
O ID de um PPG. Deve usar o tipo de pool de agentes VMSS.
A prioridade do pool de nós.
Descreve como as VMs são adicionadas ou removidas de pools de nós.
Para ignorar a instalação automática do driver de GPU pelo AKS em um pool de nós usando o tamanho da VM da GPU se os clientes quiserem gerenciar a instalação do driver de GPU por conta própria. Se não for especificado, o padrão será false.
O ID do instantâneo de origem usado para criar esse pool de nós. Deve usar o tipo de pool de agentes VMSS.
Ele só pode ser definido quando --priority for Spot. Especifique o preço máximo que você está disposto a pagar em dólares americanos. Os valores possíveis são qualquer valor decimal maior que zero ou -1, o que indica que o preço padrão está ativo sob demanda. Ele só pode incluir até 5 casas decimais.
Defina a configuração de SSH para o pool de nós. Use "disabled" para desabilitar o acesso SSH, "localuser" para habilitar o acesso SSH usando a chave privada.
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as 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 é "Agendar".
Tipo de conjunto de vm do pool de agentes. VirtualMachineScaleSets, AvailabilitySet ou VirtualMachines (versão prévia).
Lista de tamanhos separados por vírgulas. Deve usar o tipo de pool de agentes de Máquinas Virtuais.
O 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.
Lista separada por espaço de zonas de disponibilidade em que os nós do agente serão colocados. Deve usar o tipo de pool de agentes VMSS.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool delete
Exclua o pool de agentes no cluster gerenciado do Kubernetes.
az aks nodepool delete --cluster-name
--name
--resource-group
[--if-match]
[--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 --if-match etag
Parâmetros Exigidos
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
O valor fornecido será comparado com a ETag do pool de nós, se corresponder a operação continuará. 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.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool delete (aks-preview extensão)
Exclua o pool de agentes no cluster gerenciado do Kubernetes.
az aks nodepool delete --cluster-name
--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 Exigidos
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
O valor fornecido será comparado com a ETag do pool de nós, se corresponder a operação continuará. 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 pool de nós existente sem considerar o Orçamento de Interrupção do Pod.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool delete-machines
Exclua computadores específicos em um pool de agentes para um cluster gerenciado.
az aks nodepool delete-machines --cluster-name
--machine-names
--name
--resource-group
[--no-wait]
Exemplos
Excluir computadores específicos em um pool de agentes
az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1
Parâmetros Exigidos
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
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool delete-machines (aks-preview extensão)
Exclua computadores específicos em um pool de agentes para um cluster gerenciado.
az aks nodepool delete-machines --cluster-name
--machine-names
--name
--resource-group
[--no-wait]
Exemplos
Excluir computadores específicos em um pool de agentes
az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1
Parâmetros Exigidos
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
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool get-upgrades
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.
az aks nodepool get-upgrades --cluster-name
--name
--resource-group
Exemplos
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.
az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool
Parâmetros Exigidos
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 o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
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 gerenciado do Kubernetes.
az aks nodepool get-upgrades --cluster-name
--name
--resource-group
Exemplos
Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.
az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool
Parâmetros Exigidos
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 o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool list
Liste pools de nós no cluster gerenciado do Kubernetes. Para obter a lista de nós no cluster, execute kubectl get nodes
o comando.
az aks nodepool list --cluster-name
--resource-group
Parâmetros Exigidos
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 o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool list (aks-preview extensão)
Liste pools de nós no cluster gerenciado do Kubernetes.
az aks nodepool list --cluster-name
--resource-group
Parâmetros Exigidos
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 o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
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
--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 Exigidos
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
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
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
--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 Exigidos
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
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool scale
Dimensione o pool de nós em um cluster gerenciado do Kubernetes.
az aks nodepool scale --cluster-name
--name
--resource-group
[--no-wait]
[--node-count]
Parâmetros Exigidos
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
Não aguarde a conclusão da operação de execução longa.
Número de nós no pool de nós do Kubernetes.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool scale (aks-preview extensão)
Dimensione o pool de nós em um cluster gerenciado do Kubernetes.
az aks nodepool scale --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--no-wait]
[--node-count]
Parâmetros Exigidos
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
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não aguarde a conclusão da operação de execução longa.
Número de nós no pool de nós do Kubernetes.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool show
Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes.
az aks nodepool show --cluster-name
--name
--resource-group
Parâmetros Exigidos
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 o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool show (aks-preview extensão)
Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes.
az aks nodepool show --cluster-name
--name
--resource-group
Parâmetros Exigidos
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 o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool start
Inicie o pool de agentes parado no cluster gerenciado do Kubernetes.
az aks nodepool start --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Iniciar o pool de agentes no cluster gerenciado
az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Exigidos
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
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool start (aks-preview extensão)
Inicie o pool de agentes parado no cluster gerenciado do Kubernetes.
az aks nodepool start --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Iniciar o pool de agentes no cluster gerenciado
az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Exigidos
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
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool stop
Pare de executar o pool de agentes no cluster gerenciado do Kubernetes.
az aks nodepool stop --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Parar o pool de agentes no cluster gerenciado
az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Exigidos
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
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool stop (aks-preview extensão)
Pare de executar o pool de agentes no cluster gerenciado do Kubernetes.
az aks nodepool stop --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--no-wait]
Exemplos
Parar o pool de agentes no cluster gerenciado
az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster
Parâmetros Exigidos
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
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool update
Atualize as propriedades de um pool de nós.
Atualize um pool de nós para habilitar/desabilitar o dimensionador automático de cluster ou alterar min-count ou max-count. Quando chamado sem argumentos opcionais, ele tenta mover o pool de nós para seu estado de meta sem alterar a configuração atual do pool de nós. Isso pode ser usado para sair de um estado não bem-sucedido.
az aks nodepool update --cluster-name
--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]
[--max-count]
[--max-surge]
[--min-count]
[--mode {System, User}]
[--no-wait]
[--node-soak-duration]
[--node-taints]
[--os-sku {AzureLinux, CBLMariner, Mariner}]
[--scale-down-mode {Deallocate, Delete}]
[--tags]
[--update-cluster-autoscaler]
Exemplos
Reconcilie o pool de nós de volta ao seu estado atual.
az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Habilitar o dimensionador 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 dimensionador automático de cluster para um cluster existente
az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Atualize min-count ou max-count para dimensionador automático de cluster.
az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Parâmetros Exigidos
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
Pares de chave-valor separados por vírgula 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 do aplicativo aos quais o adaptador de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separadas por espaços.
Desative o dimensionador automático de cluster.
Alterne para usar o sistema operacional não habilitado para FIPS nos nós do agente.
Desabilite a Inicialização Segura ativada em um pool de nós de agente habilitado para Inicialização Confiável.
Desabilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente.
Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.
Habilite o dimensionador automático de cluster.
Alterne para usar o sistema operacional habilitado para FIPS nos nós do agente.
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.
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.
O valor fornecido será comparado com a ETag do pool de nós, se corresponder a operação continuará. 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 a sintaxe dos rótulos.
Contagem máxima de nós usada para o dimensionador automático, 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 porcentagem usada, por exemplo. 5 ou 33%.
Contagem mínima de nós usada para o dimensionador automático, 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 de 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 para pools de nós com o modo System
. Saiba mais em https://aka.ms/aks/nodepool/mode.
Não aguarde a conclusão da operação de execução longa.
A quantidade de tempo (em minutos) a aguardar após drenar um nó e antes de reimaginá-lo e passar para o próximo nó.
Os contaminadores do nó para o pool de nós. Você pode atualizar o taint de nó existente de um pool de nós ou criar um novo taint de nó para um pool de nós. Passe a string ""
vazia para remover todas as manchas.
O os-sku do pool de nós do agente.
Descreva como as VMs são adicionadas ou removidas dos pools de nós.
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.
Atualize min-count ou max-count para dimensionador automático de cluster.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
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 dimensionador automático de cluster ou alterar min-count ou max-count. Quando chamado sem argumentos opcionais, ele tenta mover o pool de nós para seu estado de meta sem alterar a configuração atual do pool de nós. Isso pode ser usado para sair de um estado não bem-sucedido.
az aks nodepool update --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--allowed-host-ports]
[--asg-ids]
[--dcat]
[--disable-cluster-autoscaler]
[--disable-fips-image]
[--disable-secure-boot]
[--disable-vtpm]
[--drain-timeout]
[--enable-artifact-streaming]
[--enable-cluster-autoscaler]
[--enable-custom-ca-trust]
[--enable-fips-image]
[--enable-secure-boot]
[--enable-vtpm]
[--if-match]
[--if-none-match]
[--labels]
[--max-count]
[--max-surge]
[--min-count]
[--mode {Gateway, System, User}]
[--no-wait]
[--node-soak-duration]
[--node-taints]
[--os-sku {AzureLinux, Ubuntu}]
[--scale-down-mode {Deallocate, Delete}]
[--ssh-access {disabled, localuser}]
[--tags]
[--undrainable-node-behavior]
[--update-cluster-autoscaler]
[--yes]
Exemplos
Reconcilie o pool de nós de volta ao seu estado atual.
az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Habilitar o dimensionador 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 dimensionador automático de cluster para um cluster existente
az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Atualize min-count ou max-count para dimensionador automático 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 do sistema
az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster
Parâmetros Exigidos
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
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 do aplicativo aos quais o adaptador de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por vírgulas. Deve usar o tipo de pool de agentes VMSS.
Desative a confiança de CA personalizada no pool de nós do agente.
Desative o dimensionador automático de cluster.
Alterne para usar o sistema operacional não habilitado para FIPS nos nós do agente.
Desabilite a Inicialização Segura ativada em um pool de nós de agente habilitado para Inicialização Confiável.
Desabilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente.
Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.
Habilite o streaming de artefato para VirtualMachineScaleSets gerenciado por um pool de nós, para acelerar a inicialização a frio de contêineres em um nó por meio do carregamento de imagem sob demanda. Para usar esse recurso, as imagens de contêiner também devem habilitar o streaming de artefato no ACR. Se não for especificado, o padrão será false.
Habilite o dimensionador automático de cluster. Deve usar o tipo de pool de agentes VMSS.
Habilite a confiança de CA personalizada no pool de nós do agente.
Alterne para usar o sistema operacional habilitado para FIPS nos nós do agente.
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.
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.
O valor fornecido será comparado com a ETag do pool de nós, se corresponder a operação continuará. 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 a sintaxe dos rótulos.
Contagem máxima de nós usada para o dimensionador automático, 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 porcentagem usada, por exemplo. 5 ou 33%.
Contagem mínima de nós usada para o dimensionador automático, 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 de 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 para pools de nós com o modo System
. Saiba mais em https://aka.ms/aks/nodepool/mode.
Não aguarde a conclusão da operação de execução longa.
A quantidade de tempo (em minutos) a aguardar após drenar um nó e antes de reimaginá-lo e passar para o próximo nó.
Os contaminadores do nó para o pool de nós.
O os-sku do pool de nós do agente.
Descreve como as VMs são adicionadas ou removidas de pools de nós.
Atualize a configuração de SSH para o pool de nós. Use "disabled" para desabilitar o acesso SSH, "localuser" para habilitar o acesso SSH usando a chave privada.
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as 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 é "Agendar".
Atualize min-count ou max-count para dimensionador automático de cluster.
Não solicite confirmação.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool upgrade
Atualize o pool de nós em um cluster gerenciado do Kubernetes.
az aks nodepool upgrade --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--drain-timeout]
[--if-match]
[--if-none-match]
[--kubernetes-version]
[--max-surge]
[--no-wait]
[--node-image-only]
[--node-soak-duration]
[--snapshot-id]
[--yes]
Parâmetros Exigidos
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
Pares de chave-valor separados por vírgula 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 a ETag do pool de nós, se corresponder a operação continuará. 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 do 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.16.9".
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33% (mutuamente exclusivo com "--node-image-only". Consulte "az aks nodepool update --max-surge" para atualizar o pico máximo antes de atualizar com "--node-image-only").
Não aguarde a conclusão da operação de execução longa.
Atualizar apenas a imagem do nó do pool de agentes.
A quantidade de tempo (em minutos) a aguardar após drenar um nó e antes de reimaginá-lo e passar para o próximo nó.
A ID do instantâneo de origem usada para atualizar esse pool de nós.
Não solicite confirmação.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool upgrade (aks-preview extensão)
Atualize o pool de nós em um cluster gerenciado do Kubernetes.
az aks nodepool upgrade --cluster-name
--name
--resource-group
[--aks-custom-headers]
[--drain-timeout]
[--if-match]
[--if-none-match]
[--kubernetes-version]
[--max-surge]
[--no-wait]
[--node-image-only]
[--node-soak-duration]
[--snapshot-id]
[--undrainable-node-behavior]
[--yes]
Parâmetros Exigidos
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
Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.
Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.
O valor fornecido será comparado com a ETag do pool de nós, se corresponder a operação continuará. 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 do 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".
Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33%.
Não aguarde a conclusão da operação de execução longa.
Atualizar apenas a imagem do nó do pool de agentes.
A quantidade de tempo (em minutos) a aguardar após drenar um nó e antes de reimaginá-lo e passar para o próximo nó.
A ID do instantâneo de origem usada 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 é "Agendar".
Não solicite confirmação.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az aks nodepool wait
Aguarde até que um pool de nós atinja um 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
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Exemplos
Aguarde até que um pool de nós atinja um 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 Exigidos
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
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Aguarde até ser excluído.
Aguarde até que o recurso exista.
Intervalo de sondagem em segundos.
Espera máxima em segundos.
Aguarde até ser atualizado com provisioningState em 'Succeeded'.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.