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 do 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 agentpool 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

Listar pools de nós no cluster gerenciado do Kubernetes. Para obter a lista de nós no comando run kubectl get nodes do cluster.

Núcleo GA
az aks nodepool list (aks-preview extensão)

Listar pools de nós no cluster gerenciado do Kubernetes.

Extensão GA
az aks nodepool operation-abort

Anular a última operação em execução no nodepool.

Núcleo GA
az aks nodepool operation-abort (aks-preview extensão)

Anular a última operação em execução no nodepool.

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

Mostrar os detalhes de um pool de nós no cluster gerenciado do Kubernetes.

Núcleo GA
az aks nodepool show (aks-preview extensão)

Mostrar 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 nodepool.

Núcleo e Extensão GA
az aks nodepool snapshot create

Crie um instantâneo do nodepool.

Núcleo GA
az aks nodepool snapshot create (aks-preview extensão)

Crie um instantâneo do nodepool.

Extensão GA
az aks nodepool snapshot delete

Exclua um instantâneo do nodepool.

Núcleo GA
az aks nodepool snapshot delete (aks-preview extensão)

Exclua um instantâneo do nodepool.

Extensão GA
az aks nodepool snapshot list

Listar instantâneos do nodepool.

Núcleo GA
az aks nodepool snapshot list (aks-preview extensão)

Listar instantâneos do nodepool.

Extensão GA
az aks nodepool snapshot show

Mostrar os detalhes de um instantâneo do nodepool.

Núcleo GA
az aks nodepool snapshot show (aks-preview extensão)

Mostrar os detalhes de um instantâneo do nodepool.

Extensão GA
az aks nodepool snapshot update

Atualizar marcas em um instantâneo de um nodepool.

Núcleo GA
az aks nodepool snapshot update (aks-preview extensão)

Atualizar marcas em um instantâneo de um nodepool.

Extensão GA
az aks nodepool snapshot wait

Aguarde até que um instantâneo do nodepool atinja o estado desejado.

Núcleo GA
az aks nodepool start

Inicie o pool de agentes interrompido no cluster gerenciado do Kubernetes.

Núcleo GA
az aks nodepool start (aks-preview extensão)

Inicie o pool de agentes interrompido 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

Atualizar as propriedades de um pool de nós.

Núcleo GA
az aks nodepool update (aks-preview extensão)

Atualizar 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 o 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]
                    [--drain-timeout]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-ultra-ssd]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--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 nodepool em um cluster AKS existente com sistemas operacionais efêmeros habilitados.

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 o UltraSSD habilitado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd

Criar um cluster nodepool com um SKU de sistema operacional específico

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu

Criar um conjunto de nós com o 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 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 host

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 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"

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Pares chave-valor separados por vírgulas para especificar cabeçalhos personalizados.

--allowed-host-ports

Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por espaço de intervalos com protocolo, por exemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Os IDs dos grupos de segurança de aplicativo aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista separada por espaço de IDs.

--crg-id

A id crg usada para associar o novo nodepool ao recurso Grupo de Reserva de Capacidade existente.

--drain-timeout

Quando os nós estiverem esgotados, aguarde quantos minutos para que todos os pods sejam removidos.

--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster.

valor padrão: False
--enable-encryption-at-host

Habilite EncryptionAtHost, o valor padrão é false.

valor padrão: False
--enable-fips-image

Use o sistema operacional habilitado para FIPS nos nós do agente.

valor padrão: False
--enable-node-public-ip

Habilite o IP público do nó VMSS.

valor padrão: False
--enable-ultra-ssd

Habilite o UltraSSD, o valor padrão é false.

valor padrão: False
--eviction-policy

A política de remoção do pool de nós Spot. Ele só pode ser definido quando --priority é Spot.

valores aceitos: Deallocate, Delete
valor padrão: Delete
--gpu-instance-profile

Perfil de instância de GPU para particionar GPUs Nvidia multi-gpu.

valores aceitos: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

A ID do grupo de hosts dedicado totalmente qualificada usada para provisionar o pool de nós do agente.

--kubelet-config

Caminho para o arquivo JSON que contém configurações do Kubelet para nós do agente. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Versão do Kubernetes a ser usada para criar o cluster, como "1.16.9".

valor de: `az aks get-versions`
--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--linux-os-config

Caminho para o arquivo JSON que contém configurações do sistema operacional para nós do agente Linux. https://aka.ms/aks/custom-node-config.

--max-count

Contagem máxima de nós usada para o 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.

--max-pods -m

O número máximo de pods implantados em um nó.

Se não for especificado, o padrão será baseado no plug-in de rede. 30 para "azure", 110 para "kubenet" ou 250 para "nenhum".

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem utilizada, por exemplo. 5 ou 33%.

--min-count

Contagem mínima de nós usada para o 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.

--mode

O modo para um pool de nós que define a função principal 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.

valores aceitos: System, User
valor padrão: User
--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-count -c

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 scaleo .

valor padrão: 3
--node-osdisk-size

Tamanho em GiB do disco do sistema operacional para cada nó no pool de agentes. Mínimo 30 GiB.

--node-osdisk-type

Tipo de disco do sistema operacional 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 'Gerenciado').

valores aceitos: Ephemeral, Managed
--node-public-ip-prefix-id

ID de prefixo IP público usado para atribuir IPs públicos a nós VMSS.

--node-public-ip-tags

As ipTags dos IPs públicos do nó.

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

O nó contamina o pool de nós.

--node-vm-size -s

Tamanho das Máquinas Virtuais a serem criadas como nós do Kubernetes.

--os-sku

A SKU do sistema operacional do pool de nós do agente. Ubuntu ou CBLMariner para Linux. Windows2019 ou Windows2022 para Windows.

valores aceitos: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

O tipo de sistema operacional. Linux ou Windows.

--pod-subnet-id

A ID de recurso de uma sub-rede em uma rede virtual existente na qual atribuir pods no cluster (requer plug-in de rede azure).

--ppg

O ID de um PPG.

--priority

A prioridade do pool de nós.

valores aceitos: Regular, Spot
valor padrão: Regular
--scale-down-mode

Descrever como as VMs são adicionadas ou removidas dos pools de nós.

valores aceitos: Deallocate, Delete
valor padrão: Delete
--snapshot-id

O ID do instantâneo de origem usado para criar esse nodepool.

--spot-max-price

Ele só pode ser definido quando --priority é 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 deve ser atualizado sob demanda. Só pode incluir até 5 casas decimais.

valor padrão: nan
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--vnet-subnet-id

A ID do recurso de uma sub-rede em uma rede virtual existente na qual implantar o cluster.

--zones -z

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ê insira --zones 1 2 3.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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]
                    [--enable-artifact-streaming]
                    [--enable-cluster-autoscaler]
                    [--enable-custom-ca-trust]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-ultra-ssd]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--message-of-the-day]
                    [--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}]
                    [--skip-gpu-driver-install]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, localuser}]
                    [--tags]
                    [--vm-set-type]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

Exemplos

Crie um nodepool em um cluster AKS existente com sistemas operacionais efêmeros habilitados.

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 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 do Kubernetes com uma 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 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 host

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

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--allowed-host-ports
Versão Prévia

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.

--asg-ids
Versão Prévia

Os IDs dos grupos de segurança de aplicativo aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista separada por vírgulas de IDs. Deve usar o tipo de pool de agentes VMSS.

--crg-id
Versão Prévia

O crg-id usado para associar o novo nodepool ao recurso existente do Grupo de Reserva de Capacidade. Deve usar o tipo de pool de agentes VMSS.

--disable-windows-outbound-nat

Desative o Windows OutboundNAT no pool de nós do agente do Windows. Deve usar o tipo de pool de agentes VMSS.

valor padrão: False
--drain-timeout

Quando os nós estiverem esgotados, aguarde quantos minutos para que todos os pods sejam removidos.

--enable-artifact-streaming
Versão Prévia

Habilite o streaming de artefatos para VirtualMachineScaleSets gerenciados 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 artefatos no ACR. Se não for especificado, o padrão será false.

valor padrão: False
--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster. Deve usar o tipo de pool de agentes VMSS.

valor padrão: False
--enable-custom-ca-trust

Habilite a Confiança de CA Personalizada no pool de nós do agente.

valor padrão: False
--enable-encryption-at-host

Habilite EncryptionAtHost no pool de nós do agente.

valor padrão: False
--enable-fips-image

Use o sistema operacional habilitado para FIPS nos nós do agente.

valor padrão: False
--enable-node-public-ip

Habilite o IP público do nó VMSS. Deve usar o tipo de pool de agentes VMSS.

valor padrão: False
--enable-ultra-ssd

Habilite o UltraSSD no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

valor padrão: False
--eviction-policy

A política de remoção do pool de nós Spot. Ele só pode ser definido quando --priority é Spot.

valores aceitos: Deallocate, Delete
valor padrão: Delete
--gpu-instance-profile

Perfil de instância de GPU para particionar GPUs Nvidia multi-gpu.

valores aceitos: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

(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.

--kubelet-config

Configurações do Kubelet para nós do agente.

--kubernetes-version -k

Versão do Kubernetes a ser usada para criar o cluster, como "1.7.12" ou "1.8.7".

valor de: `az aks get-versions`
--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--linux-os-config

Configurações do sistema operacional para nós do agente Linux.

--max-count

Contagem máxima de nós usada para o 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.

--max-pods -m

O número máximo de pods implantados em um nó.

Se não for especificado, o padrão será baseado no plug-in de rede. 30 para "azure", 110 para "kubenet" ou 250 para "nenhum".

valor padrão: 0
--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem utilizada, por exemplo. 5 ou 33%.

--message-of-the-day

Caminho para um arquivo contendo a mensagem desejada do dia. Válido apenas para nós linux. Será escrito para /etc/motd.

--min-count

Contagem de nós mínimos 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.

--mode

O modo para um pool de nós que define a função principal 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.

valores aceitos: System, User
valor padrão: User
--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-count -c

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 scaleo .

valor padrão: 3
--node-osdisk-size

Tamanho em GiB do disco do sistema operacional para cada nó no pool de agentes. Mínimo 30 GiB.

valor padrão: 0
--node-osdisk-type

Tipo de disco do sistema operacional 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 'Gerenciado').

valores aceitos: Ephemeral, Managed
--node-public-ip-prefix-id

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.

--node-public-ip-tags

As ipTags dos IPs públicos do nó. Deve usar o tipo de pool de agentes VMSS.

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

O nó contamina o pool de nós.

--node-vm-size -s

Tamanho das Máquinas Virtuais a serem criadas como nós do Kubernetes.

--os-sku

O os-sku do pool de nós do agente. Ubuntu ou CBLMariner quando os-type é Linux, o padrão é Ubuntu se não estiver definido; Windows2019 ou Windows2022 quando o tipo de sistema operacional é Windows, o padrão atual é Windows2019 se não estiver definido e o padrão será alterado para Windows2022 depois que o Windows2019 for preterido.

valores aceitos: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

O tipo de sistema operacional. Linux ou Windows. O Windows ainda não é suportado para o tipo de conjunto de VM "VirtualMachines".

--pod-subnet-id

A ID de uma sub-rede em uma rede virtual existente na qual atribuir pods no cluster (requer plug-in de rede azure).

--ppg

O ID de um PPG. Deve usar o tipo de pool de agentes VMSS.

--priority

A prioridade do pool de nós.

valores aceitos: Regular, Spot
valor padrão: Regular
--scale-down-mode

Descreve como as VMs são adicionadas ou removidas de pools de nós.

valores aceitos: Deallocate, Delete
valor padrão: Delete
--skip-gpu-driver-install
Versão Prévia

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 da GPU por conta própria. Se não for especificado, o padrão será false.

valor padrão: False
--snapshot-id

O ID do instantâneo de origem usado para criar esse nodepool. Deve usar o tipo de pool de agentes VMSS.

--spot-max-price

Ele só pode ser definido quando --priority é 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 deve ser atualizado sob demanda. Só pode incluir até 5 casas decimais.

valor padrão: nan
--ssh-access
Versão Prévia

Defina a configuração de SSH para o pool de nós. Use "disabled" para desativar o acesso SSH, "localuser" para habilitar o acesso SSH usando chave privada.

valores aceitos: disabled, localuser
valor padrão: localuser
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--vm-set-type

Tipo de conjunto de vm do pool de agentes. VirtualMachineScaleSets, AvailabilitySet ou VirtualMachines(Pré-visualização).

--vnet-subnet-id

O ID de uma sub-rede em uma VNet existente na qual implantar o cluster.

--workload-runtime

Determina o tipo de carga de trabalho que um nó pode executar. O padrão é OCIContainer.

valores aceitos: KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi
valor padrão: OCIContainer
--zones -z

Lista separada por espaço das zonas de disponibilidade onde os nós do agente serão colocados. Deve usar o tipo de pool de agentes VMSS.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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
                       [--no-wait]

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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
                       [--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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--ignore-pod-disruption-budget -i
Versão Prévia

(PREVIEW) ignore-pod-disruption-budget exclui um nodepool existente sem considerar o Orçamento de Interrupção do Pod.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool delete-machines

Exclua computadores específicos em um agentpool 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

--cluster-name

O nome do cluster.

--machine-names

Lista separada por espaço de nomes de máquina do pool de agentes a serem excluídos.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool list

Listar pools de nós no cluster gerenciado do Kubernetes. Para obter a lista de nós no comando run kubectl get nodes do cluster.

az aks nodepool list --cluster-name
                     --resource-group

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool list (aks-preview extensão)

Listar pools de nós no cluster gerenciado do Kubernetes.

az aks nodepool list --cluster-name
                     --resource-group

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool operation-abort

Anular a última operação em execução no nodepool.

az aks nodepool operation-abort --cluster-name
                                --name
                                --resource-group
                                [--no-wait]

Exemplos

Anular a operação no pool de agentes

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool operation-abort (aks-preview extensão)

Anular a última operação em execução no nodepool.

az aks nodepool operation-abort --cluster-name
                                --name
                                --resource-group
                                [--aks-custom-headers]
                                [--no-wait]

Exemplos

Anular a operação no pool de agentes

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-count -c

Número de nós no pool de nós do Kubernetes.

valor padrão: 3
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-count -c

Número de nós no pool de nós do Kubernetes.

valor padrão: 3
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool show

Mostrar 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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool show (aks-preview extensão)

Mostrar 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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool start

Inicie o pool de agentes interrompido no cluster gerenciado do Kubernetes.

az aks nodepool start --cluster-name
                      --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 Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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 interrompido no cluster gerenciado do Kubernetes.

az aks nodepool start --cluster-name
                      --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 Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool update

Atualizar as propriedades de um pool de nós.

Atualize um pool de nós para habilitar/desabilitar o cluster-autoscaler 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 sem sucesso.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--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 cluster-autoscaler 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 cluster-autoscaler para um cluster existente

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Atualize a contagem mínima ou 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 Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Pares chave-valor separados por vírgulas para especificar cabeçalhos personalizados.

--allowed-host-ports

Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por espaço de intervalos com protocolo, por exemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Os IDs dos grupos de segurança de aplicativo aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista separada por espaço de IDs.

--disable-cluster-autoscaler -d

Desative o autoscaler de cluster.

valor padrão: False
--drain-timeout

Quando os nós estiverem esgotados, aguarde quantos minutos para que todos os pods sejam removidos.

--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster.

valor padrão: False
--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--max-count

Contagem máxima de nós usada para o 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.

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem utilizada, por exemplo. 5 ou 33%.

--min-count

Contagem mínima de nós usada para o 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.

--mode

O modo para um pool de nós que define a função principal 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.

valores aceitos: System, User
--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

O nó contamina o pool de nós. Você pode atualizar a mancha de nó existente de um nodepool ou criar uma nova mancha de nó para um nodepool. Passe a cadeia de caracteres "" vazia para remover todas as manchas.

--scale-down-mode

Descrever como as VMs são adicionadas ou removidas dos pools de nós.

valores aceitos: Deallocate, Delete
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--update-cluster-autoscaler -u

Atualize a contagem mínima ou máxima para o autoscaler de cluster.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az aks nodepool update (aks-preview extensão)

Atualizar as propriedades de um pool de nós.

Atualize um pool de nós para habilitar/desabilitar o cluster-autoscaler 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 sem sucesso.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--dcat]
                       [--disable-cluster-autoscaler]
                       [--drain-timeout]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-custom-ca-trust]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, Ubuntu}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, localuser}]
                       [--tags]
                       [--update-cluster-autoscaler]
                       [--yes]

Exemplos

Reconcilie o nodepool de volta ao seu estado atual.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Habilitar o cluster-autoscaler 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 cluster-autoscaler para um cluster existente

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Atualize a contagem mínima ou 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 do sistema

az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--allowed-host-ports
Versão Prévia

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.

--asg-ids
Versão Prévia

Os IDs dos grupos de segurança de aplicativo aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista separada por vírgulas de IDs. Deve usar o tipo de pool de agentes VMSS.

--dcat --disable-custom-ca-trust

Desative a Confiança de CA Personalizada no pool de nós do agente.

valor padrão: False
--disable-cluster-autoscaler -d

Desative o autoscaler de cluster.

valor padrão: False
--drain-timeout

Quando os nós estiverem esgotados, aguarde quantos minutos para que todos os pods sejam removidos.

--enable-artifact-streaming
Versão Prévia

Habilite o streaming de artefatos para VirtualMachineScaleSets gerenciados 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 artefatos no ACR. Se não for especificado, o padrão será false.

valor padrão: False
--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster. Deve usar o tipo de pool de agentes VMSS.

valor padrão: False
--enable-custom-ca-trust

Habilite a Confiança de CA Personalizada no pool de nós do agente.

valor padrão: False
--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--max-count

Contagem máxima de nós usada para o 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.

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem utilizada, por exemplo. 5 ou 33%.

--min-count

Contagem de nós mínimos 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.

--mode

O modo para um pool de nós que define a função principal 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.

valores aceitos: System, User
--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

O nó contamina o pool de nós.

--os-sku

O os-sku do pool de nós do agente.

valores aceitos: AzureLinux, Ubuntu
--scale-down-mode

Descreve como as VMs são adicionadas ou removidas de pools de nós.

valores aceitos: Deallocate, Delete
--ssh-access
Versão Prévia

Atualize a configuração de SSH para o pool de nós. Use "disabled" para desativar o acesso SSH, "localuser" para habilitar o acesso SSH usando chave privada.

valores aceitos: disabled, localuser
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--update-cluster-autoscaler -u

Atualize a contagem mínima ou máxima para o autoscaler de cluster.

valor padrão: False
--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--yes]

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Pares chave-valor separados por vírgulas para especificar cabeçalhos personalizados.

--drain-timeout

Quando os nós estiverem esgotados, quanto tempo esperar para que todos os pods sejam removidos.

--kubernetes-version -k

Versão do Kubernetes para atualizar o pool de nós, como "1.16.9".

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem utilizada, por exemplo. 5 ou 33% (mutuamente exclusivo com "--node-image-only". Consulte "az aks nodepool update --max-surge" para atualizar o máximo surge antes de atualizar com "--node-image-only").

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-image-only

Atualize somente a imagem do nó do pool de agentes.

valor padrão: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--snapshot-id

O ID do instantâneo de origem usado para atualizar esse nodepool.

--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--yes]

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aks-custom-headers

Enviar cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--drain-timeout

Quando os nós estiverem esgotados, aguarde quantos minutos para que todos os pods sejam removidos.

--kubernetes-version -k

Versão do Kubernetes para atualizar o pool de nós, como "1.11.12".

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem utilizada, por exemplo. 5 ou 33%.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--node-image-only

Atualize somente a imagem do nó do pool de agentes.

valor padrão: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--snapshot-id

O ID do instantâneo de origem usado para atualizar esse nodepool. Deve usar o tipo de pool de agentes VMSS.

--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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 o estado desejado.

Se uma operação em um pool de nós foi interrompida ou iniciada com --no-waito , 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 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 Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.