az aks nodepool

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Comandos para administrar grupos de nodos en el clúster de Kubernetes de Kubernetes.

Comandos

Nombre Description Tipo Estado
az aks nodepool add

Agregue un grupo de nodos al clúster de Kubernetes administrado.

Core GA
az aks nodepool add (aks-preview extensión)

Agregue un grupo de nodos al clúster de Kubernetes administrado.

Extensión GA
az aks nodepool delete

Elimine el grupo de agentes en el clúster de Kubernetes administrado.

Core GA
az aks nodepool delete (aks-preview extensión)

Elimine el grupo de agentes en el clúster de Kubernetes administrado.

Extensión GA
az aks nodepool delete-machines

Elimine máquinas específicas de un grupo de agentes para un clúster administrado.

Extensión GA
az aks nodepool get-upgrades

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

Core GA
az aks nodepool get-upgrades (aks-preview extensión)

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

Extensión GA
az aks nodepool list

Enumera los grupos de nodos del clúster de Kubernetes administrado. Para obtener la lista de nodos en el comando cluster run kubectl get nodes .

Core GA
az aks nodepool list (aks-preview extensión)

Enumera los grupos de nodos del clúster de Kubernetes administrado.

Extensión GA
az aks nodepool manual-scale

Comandos para administrar nodepool virtualMachineProfile.scale.manual.

Extensión GA
az aks nodepool manual-scale add

Agregue un nuevo manual a un grupo de agentes de VirtualMachines en el clúster de Kubernetes administrado.

Extensión GA
az aks nodepool manual-scale delete

Elimine un manual existente en un grupo de agentes de VirtualMachines en el clúster de Kubernetes administrado.

Extensión GA
az aks nodepool manual-scale update

Actualice un manual existente de un grupo de agentes de VirtualMachines en el clúster de Kubernetes administrado.

Extensión GA
az aks nodepool operation-abort

Anule la última operación en ejecución en nodepool.

Core GA
az aks nodepool operation-abort (aks-preview extensión)

Anule la última operación en ejecución en nodepool.

Extensión GA
az aks nodepool scale

Escala el grupo de nodos en un clúster de Kubernetes administrado.

Core GA
az aks nodepool scale (aks-preview extensión)

Escala el grupo de nodos en un clúster de Kubernetes administrado.

Extensión GA
az aks nodepool show

Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.

Core GA
az aks nodepool show (aks-preview extensión)

Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.

Extensión GA
az aks nodepool snapshot

Comandos para administrar instantáneas del grupo de nodos.

Núcleo y extensión GA
az aks nodepool snapshot create

Cree una instantánea de grupo de nodos.

Core GA
az aks nodepool snapshot create (aks-preview extensión)

Cree una instantánea de grupo de nodos.

Extensión GA
az aks nodepool snapshot delete

Elimine una instantánea de grupo de nodos.

Core GA
az aks nodepool snapshot delete (aks-preview extensión)

Elimine una instantánea de grupo de nodos.

Extensión GA
az aks nodepool snapshot list

Enumerar instantáneas de grupo de nodos.

Core GA
az aks nodepool snapshot list (aks-preview extensión)

Enumerar instantáneas de grupo de nodos.

Extensión GA
az aks nodepool snapshot show

Muestra los detalles de una instantánea de grupo de nodos.

Core GA
az aks nodepool snapshot show (aks-preview extensión)

Muestra los detalles de una instantánea de grupo de nodos.

Extensión GA
az aks nodepool snapshot update

Actualizar etiquetas en una instantánea de un grupo de nodos.

Core GA
az aks nodepool snapshot update (aks-preview extensión)

Actualizar etiquetas en una instantánea de un grupo de nodos.

Extensión GA
az aks nodepool snapshot wait

Espere a que una instantánea de grupo de nodos alcance un estado deseado.

Core GA
az aks nodepool start

Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.

Core GA
az aks nodepool start (aks-preview extensión)

Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.

Extensión GA
az aks nodepool stop

Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.

Core GA
az aks nodepool stop (aks-preview extensión)

Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.

Extensión GA
az aks nodepool update

Actualice las propiedades de un grupo de nodos.

Core GA
az aks nodepool update (aks-preview extensión)

Actualice las propiedades de un grupo de nodos.

Extensión GA
az aks nodepool upgrade

Actualiza el grupo de nodos en un clúster de Kubernetes administrado.

Core GA
az aks nodepool upgrade (aks-preview extensión)

Actualiza el grupo de nodos en un clúster de Kubernetes administrado.

Extensión GA
az aks nodepool wait

Espere a que un grupo de nodos alcance un estado deseado.

Core GA

az aks nodepool add

Agregue un grupo de nodos al clúster de Kubernetes administrado.

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

Ejemplos

Cree un grupo de nodos en un clúster de AKS existente con sistemas operativos efímeros habilitados.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Cree un grupo de nodos con EncryptionAtHost habilitado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Cree un grupo de nodos con UltraSSD habilitado.

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

Creación de un clúster de grupos de nodos con una SKU específica del sistema operativo

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

Creación de un grupo de nodos con sistema operativo habilitado para FIPS

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image

cree un clúster de Kubernetes con un identificador de instantánea.

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"

creación de un grupo de nodos en un clúster de AKS existente con el identificador de grupo 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

cree un grupo de nodos con un identificador de grupo de reserva de capacidad (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 requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Pares clave-valor separados por comas para especificar encabezados personalizados.

--allowed-host-ports

Exponga los puertos de host en el grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por espacios de intervalos con protocolo, por ejemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Identificadores de los grupos de seguridad de aplicaciones a los que debe pertenecer la interfaz de red del grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por espacios de identificadores.

--crg-id

Identificador crg usado para asociar el nuevo grupo de nodos con el recurso grupo de reserva de capacidad existente.

--disable-windows-outbound-nat

Deshabilite Windows OutboundNAT en el grupo de nodos del agente de Windows.

Valor predeterminado: False
--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster.

Valor predeterminado: False
--enable-encryption-at-host

Enable EncryptionAtHost, el valor predeterminado es false.

Valor predeterminado: False
--enable-fips-image

Use el sistema operativo habilitado para FIPS en los nodos del agente.

Valor predeterminado: False
--enable-node-public-ip

Habilite la dirección IP pública del nodo VMSS.

Valor predeterminado: False
--enable-ultra-ssd

Habilitar UltraSSD, el valor predeterminado es false.

Valor predeterminado: False
--eviction-policy

Directiva de expulsión del grupo de nodos de spot. Solo se puede establecer cuando --priority es Spot.

Valores aceptados: Deallocate, Delete
Valor predeterminado: Delete
--gpu-instance-profile

Perfil de instancia de GPU para particionar gpu múltiples GPU nvidia.

Valores aceptados: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

Identificador de grupo host dedicado completo que se usa para aprovisionar el grupo de nodos del agente.

--kubelet-config

Ruta de acceso al archivo JSON que contiene configuraciones de Kubelet para los nodos del agente. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Versión de Kubernetes que se usará para crear el clúster, como "1.16.9".

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

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--linux-os-config

Ruta de acceso al archivo JSON que contiene configuraciones del sistema operativo para los nodos del agente de Linux. https://aka.ms/aks/custom-node-config.

--max-count

Número máximo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--max-pods -m

Número máximo de pods que se pueden implementar en un nodo.

Si no se especifica, el valor predeterminado se basa en el complemento de red. 30 para "azure", 110 para "kubenet" o 250 para "none".

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--min-count

Número mínimo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--mode

Modo para un grupo de nodos que define la función principal de un grupo de nodos. Si se establece como "Sistema", AKS prefiere programar pods del sistema en grupos de nodos con el modo System. Obtenga más información en https://aka.ms/aks/nodepool/mode.

Valores aceptados: System, User
Valor predeterminado: User
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-count -c

Número de nodos del grupo de agentes de Kubernetes. Después de crear un clúster, puede cambiar el tamaño de su grupo de nodos con az aks scale.

Valor predeterminado: 3
--node-osdisk-size

Tamaño en GiB del disco del sistema operativo para cada nodo del grupo de agentes. Mínimo 30 GiB.

--node-osdisk-type

Tipo de disco del sistema operativo que se va a usar para las máquinas de un grupo de agentes determinado. El valor predeterminado es "Efímero" cuando sea posible junto con el tamaño de máquina virtual y el tamaño del disco del sistema operativo. Es posible que no se cambie para este grupo después de la creación. ('Efímero' o 'Administrado').

Valores aceptados: Ephemeral, Managed
--node-public-ip-prefix-id

Identificador de prefijo de IP pública que se usa para asignar direcciones IP públicas a los nodos de VMSS.

--node-public-ip-tags

IpTags del nodo direcciones IP públicas.

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos.

--node-vm-size -s

Tamaño de las máquinas virtuales que se van a crear como nodos de Kubernetes.

--os-sku

SKU del sistema operativo del grupo de nodos del agente. Ubuntu o CBLMariner para Linux. Windows2019 o Windows2022 para Windows.

Valores aceptados: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

Tipo de sistema operativo. Linux o Windows.

--pod-subnet-id

El identificador de recurso de una subred de una red virtual existente en la que asignar pods en el clúster (requiere azure network-plugin).

--ppg

Identificador de un PPG.

--priority

Prioridad del grupo de nodos.

Valores aceptados: Regular, Spot
Valor predeterminado: Regular
--scale-down-mode

Describir cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Valores aceptados: Deallocate, Delete
Valor predeterminado: Delete
--snapshot-id

Identificador de instantánea de origen que se usa para crear este grupo de nodos.

--spot-max-price

Solo se puede establecer cuando --priority es Spot. Especifique el precio máximo que está dispuesto a pagar en dólares estadounidenses. Los valores posibles son cualquier valor decimal mayor que cero o -1, lo que indica que el precio predeterminado es de hasta la demanda. Solo puede incluir hasta 5 posiciones decimales.

Valor predeterminado: nan
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--vnet-subnet-id

Identificador de recurso de una subred en una red virtual existente en la que se va a implementar el clúster.

--zones -z

Zonas de disponibilidad en las que se colocarán los nodos del agente. Además, para instalar nodos de agente en más de una zona, debe pasar números de zona separados por espacios en blanco. Por ejemplo: para tener todas las tres zonas, se espera que escriba --zones 1 2 3.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool add (aks-preview extensión)

Agregue un grupo de nodos al clúster de Kubernetes administrado.

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-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]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

Ejemplos

Cree un grupo de nodos en un clúster de AKS existente con sistemas operativos efímeros habilitados.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Cree un grupo de nodos con EncryptionAtHost habilitado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Creación de un grupo de nodos con una SKU específica de os

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

Cree un grupo de nodos que pueda ejecutar cargas de trabajo wasm.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --workload-runtime WasmWasi

cree un clúster de Kubernetes con un identificador de instantánea.

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"

cree un grupo de nodos con un identificador de grupo de reserva de capacidad (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"

creación de un grupo de nodos en un clúster de AKS existente con el identificador de grupo 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

Cree un grupo de nodos con el modo de asignación ip establecido en "StaticBlock" y use un identificador de subred 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

Creación de un grupo de nodos de 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 requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--allowed-host-ports
Vista previa

Exponga los puertos de host en el grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por comas de intervalos con protocolo, por ejemplo. 80/TCP,443/TCP,4000-5000/TCP. Debe usar el tipo de grupo de agentes de VMSS.

--asg-ids
Vista previa

Identificadores de los grupos de seguridad de aplicaciones a los que debe pertenecer la interfaz de red del grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por comas de identificadores. Debe usar el tipo de grupo de agentes de VMSS.

--crg-id
Vista previa

El crg-id usado para asociar el nuevo grupo de nodos con el recurso grupo de reserva de capacidad existente. Debe usar el tipo de grupo de agentes de VMSS.

--disable-windows-outbound-nat

Deshabilite Windows OutboundNAT en el grupo de nodos del agente de Windows. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--enable-artifact-streaming
Vista previa

Habilite el streaming de artefactos para VirtualMachineScaleSets administrado por un grupo de nodos para acelerar el arranque en frío de los contenedores en un nodo a través de la carga de imágenes a petición. Para usar esta característica, las imágenes de contenedor también deben habilitar el streaming de artefactos en ACR. Si no se especifica, el valor predeterminado es false.

Valor predeterminado: False
--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--enable-custom-ca-trust

Habilite Confianza de CA personalizada en el grupo de nodos del agente.

Valor predeterminado: False
--enable-encryption-at-host

Habilite EncryptionAtHost en el grupo de nodos del agente.

Valor predeterminado: False
--enable-fips-image

Use el sistema operativo habilitado para FIPS en los nodos del agente.

Valor predeterminado: False
--enable-node-public-ip

Habilite la dirección IP pública del nodo VMSS. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--enable-secure-boot
Vista previa

Habilite el arranque seguro en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--enable-ultra-ssd

Habilite UltraSSD en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--enable-vtpm
Vista previa

Habilite vTPM en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--eviction-policy

Directiva de expulsión del grupo de nodos de spot. Solo se puede establecer cuando --priority es Spot.

Valores aceptados: Deallocate, Delete
Valor predeterminado: Delete
--gateway-prefix-size
Vista previa

Tamaño de IPPrefix público asociado al grupo de nodos en modo de puerta de enlace. El grupo de nodos debe estar en modo de puerta de enlace.

--gpu-instance-profile

Perfil de instancia de GPU para particionar gpu múltiples GPU nvidia.

Valores aceptados: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

(VERSIÓN PRELIMINAR) Identificador de grupo host dedicado completo que se usa para aprovisionar el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

--if-match

El valor proporcionado se comparará con la ETag del grupo de agentes, si coincide con la operación. Si no coincide, la solicitud se rechazará para evitar sobrescrituras accidentales. No se debe especificar al crear un grupo de agentes.

--if-none-match

Establézcalo en "*" para permitir que se cree un nuevo grupo de agentes, pero para evitar la actualización de un grupo de agentes existente. Se omitirán otros valores.

--kubelet-config

Configuraciones de Kubelet para nodos de agente.

--kubernetes-version -k

Versión de Kubernetes que se usará para crear el clúster, como "1.7.12" o "1.8.7".

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

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--linux-os-config

Configuraciones del sistema operativo para nodos del agente de Linux.

--max-count

Número máximo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--max-pods -m

Número máximo de pods que se pueden implementar en un nodo.

Si no se especifica, el valor predeterminado se basa en el complemento de red. 30 para "azure", 110 para "kubenet" o 250 para "none".

Valor predeterminado: 0
--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--message-of-the-day

Ruta de acceso a un archivo que contiene el mensaje deseado del día. Solo es válido para los nodos de Linux. Se escribirá en /etc/motd.

--min-count

Número de nodos de minicomunión usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--mode

Modo para un grupo de nodos que define la función principal de un grupo de nodos. Si se establece como "Sistema", AKS prefiere programar pods del sistema en grupos de nodos con el modo System. Obtenga más información en https://aka.ms/aks/nodepool/mode.

Valores aceptados: Gateway, System, User
Valor predeterminado: User
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-count -c

Número de nodos del grupo de agentes de Kubernetes. Después de crear un clúster, puede cambiar el tamaño de su grupo de nodos con az aks scale.

Valor predeterminado: 3
--node-osdisk-size

Tamaño en GiB del disco del sistema operativo para cada nodo del grupo de agentes. Mínimo 30 GiB.

Valor predeterminado: 0
--node-osdisk-type

Tipo de disco del sistema operativo que se va a usar para las máquinas de un grupo de agentes determinado. El valor predeterminado es "Efímero" cuando sea posible junto con el tamaño de máquina virtual y el tamaño del disco del sistema operativo. Es posible que no se cambie para este grupo después de la creación. ('Efímero' o 'Administrado').

Valores aceptados: Ephemeral, Managed
--node-public-ip-prefix-id

Identificador de prefijo de IP pública que se usa para asignar direcciones IP públicas a los nodos de VMSS. Debe usar el tipo de grupo de agentes de VMSS.

--node-public-ip-tags

IpTags del nodo direcciones IP públicas. Debe usar el tipo de grupo de agentes de VMSS.

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos.

--node-vm-size -s

Tamaño de las máquinas virtuales que se van a crear como nodos de Kubernetes.

--os-sku

La os-sku del grupo de nodos del agente. Ubuntu o CBLMariner cuando el tipo de sistema operativo es Linux, el valor predeterminado es Ubuntu si no se establece; Windows2019, Windows2022 o Windows Annual cuando el tipo de sistema operativo es Windows, el valor predeterminado actual es Windows2022 si no se establece.

Valores aceptados: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual
--os-type

Tipo de sistema operativo. Linux o Windows. Windows aún no se admite para el tipo de conjunto de máquinas virtuales "VirtualMachines".

--pod-ip-allocation-mode

Establezca el modo de asignación ip para saber cómo se asignan las direcciones IP de pod de la subred de pod de Azure a los nodos del clúster de AKS. La elección es entre lotes dinámicos de direcciones IP individuales o la asignación estática de un conjunto de bloques CIDR. Los valores aceptados son "DynamicIndividual" o "StaticBlock".

Se usa junto con el complemento de red "azure". Requiere --pod-subnet-id.

Valores aceptados: DynamicIndividual, StaticBlock
--pod-subnet-id

El identificador de una subred de una red virtual existente en la que asignar pods en el clúster (requiere azure network-plugin).

--ppg

Identificador de un PPG. Debe usar el tipo de grupo de agentes de VMSS.

--priority

Prioridad del grupo de nodos.

Valores aceptados: Regular, Spot
Valor predeterminado: Regular
--scale-down-mode

Describe cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Valores aceptados: Deallocate, Delete
Valor predeterminado: Delete
--skip-gpu-driver-install
Vista previa

Para omitir la instalación automática del controlador de GPU por AKS en un grupo de nodos mediante el tamaño de máquina virtual de GPU si los clientes quieren administrar la instalación del controlador de GPU por su cuenta propia. Si no se especifica, el valor predeterminado es false.

Valor predeterminado: False
--snapshot-id

Identificador de instantánea de origen que se usa para crear este grupo de nodos. Debe usar el tipo de grupo de agentes de VMSS.

--spot-max-price

Solo se puede establecer cuando --priority es Spot. Especifique el precio máximo que está dispuesto a pagar en dólares estadounidenses. Los valores posibles son cualquier valor decimal mayor que cero o -1, lo que indica que el precio predeterminado es de hasta la demanda. Solo puede incluir hasta 5 posiciones decimales.

Valor predeterminado: nan
--ssh-access
Vista previa

Configure la configuración de SSH para el grupo de nodos. Use "disabled" para deshabilitar el acceso SSH, "localuser" para habilitar el acceso SSH mediante la clave privada.

Valores aceptados: disabled, localuser
Valor predeterminado: localuser
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--vm-set-type

Tipo de conjunto de máquinas virtuales del grupo de agentes. VirtualMachineScaleSets, AvailabilitySet o VirtualMachines(Preview).

--vm-sizes
Vista previa

Lista separada por comas de tamaños. Debe usar el tipo de grupo de agentes VirtualMachines.

--vnet-subnet-id

Identificador de la subred de una red virtual existente en la que se va a implementar el clúster.

--workload-runtime

Determina el tipo de carga de trabajo que puede ejecutar un nodo. El valor predeterminado es OCIContainer.

Valores aceptados: KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi
Valor predeterminado: OCIContainer
--zones -z

Lista separada por espacios de zonas de disponibilidad donde se colocarán los nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool delete

Elimine el grupo de agentes en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool delete (aks-preview extensión)

Elimine el grupo de agentes en el clúster de Kubernetes administrado.

az aks nodepool delete --cluster-name
                       --name
                       --resource-group
                       [--if-match]
                       [--ignore-pod-disruption-budget]
                       [--no-wait]

Ejemplos

Eliminación de un grupo de agentes con ignore-pod-disruption-budget

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --ignore-pod-disruption-budget=true

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--if-match

El valor proporcionado se comparará con la ETag del grupo de nodos, si coincide con la operación. Si no coincide, la solicitud se rechazará para evitar sobrescrituras accidentales. No se debe especificar al crear un grupo de agentes.

--ignore-pod-disruption-budget -i
Vista previa

(VERSIÓN PRELIMINAR) ignore-pod-disruption-budget elimina un grupo de nodos existente sin tener en cuenta el presupuesto de interrupciones del pod.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool delete-machines

Elimine máquinas específicas de un grupo de agentes para un clúster administrado.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name
                                --resource-group
                                [--no-wait]

Ejemplos

Eliminación de máquinas específicas en un grupo de agentes

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Parámetros requeridos

--cluster-name

El nombre del clúster.

--machine-names

Lista separada por espacios de nombres de máquina del grupo de agentes que se va a eliminar.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool get-upgrades

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

az aks nodepool get-upgrades --cluster-name
                             --name
                             --resource-group

Ejemplos

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool get-upgrades (aks-preview extensión)

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

az aks nodepool get-upgrades --cluster-name
                             --name
                             --resource-group

Ejemplos

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool list

Enumera los grupos de nodos del clúster de Kubernetes administrado. Para obtener la lista de nodos en el comando cluster run kubectl get nodes .

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool list (aks-preview extensión)

Enumera los grupos de nodos del clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool operation-abort

Anule la última operación en ejecución en nodepool.

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

Ejemplos

Anulación de la operación en el grupo de agentes

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool operation-abort (aks-preview extensión)

Anule la última operación en ejecución en nodepool.

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

Ejemplos

Anulación de la operación en el grupo de agentes

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool scale

Escala el grupo de nodos en un clúster de Kubernetes administrado.

az aks nodepool scale --cluster-name
                      --name
                      --resource-group
                      [--no-wait]
                      [--node-count]

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-count -c

Número de nodos del grupo de nodos de Kubernetes.

Valor predeterminado: 3
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool scale (aks-preview extensión)

Escala el grupo de nodos en un clúster de Kubernetes administrado.

az aks nodepool scale --cluster-name
                      --name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]
                      [--node-count]

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-count -c

Número de nodos del grupo de nodos de Kubernetes.

Valor predeterminado: 3
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool show

Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool show (aks-preview extensión)

Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool start

Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.

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

Ejemplos

Inicio del grupo de agentes en el clúster administrado

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool start (aks-preview extensión)

Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.

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

Ejemplos

Inicio del grupo de agentes en el clúster administrado

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool stop

Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.

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

Ejemplos

Detener el grupo de agentes en el clúster administrado

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool stop (aks-preview extensión)

Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.

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

Ejemplos

Detener el grupo de agentes en el clúster administrado

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool update

Actualice las propiedades de un grupo de nodos.

Actualice un grupo de nodos para habilitar o deshabilitar el escalador automático de clústeres o cambie min-count o max-count. Cuando se llama sin argumentos opcionales, intenta mover el grupo de nodos a su estado objetivo sin cambiar la configuración actual del grupo de nodos. Esto se puede usar para salir de un estado no correcto.

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]
                       [--os-sku {AzureLinux, CBLMariner, Mariner}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--update-cluster-autoscaler]

Ejemplos

Concilie el grupo de nodos a su estado actual.

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

Habilitación del escalador automático de clústeres dentro del intervalo de recuento de nodos [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Deshabilitación del escalador automático de clústeres para un clúster existente

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

Actualice min-count o max-count para el escalador automático del clúster.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Pares clave-valor separados por comas para especificar encabezados personalizados.

--allowed-host-ports

Exponga los puertos de host en el grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por espacios de intervalos con protocolo, por ejemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Identificadores de los grupos de seguridad de aplicaciones a los que debe pertenecer la interfaz de red del grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por espacios de identificadores.

--disable-cluster-autoscaler -d

Deshabilite el escalador automático del clúster.

Valor predeterminado: False
--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster.

Valor predeterminado: False
--labels

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--max-count

Número máximo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--min-count

Número mínimo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--mode

Modo para un grupo de nodos que define la función principal de un grupo de nodos. Si se establece como "Sistema", AKS prefiere programar pods del sistema en grupos de nodos con el modo System. Obtenga más información en https://aka.ms/aks/nodepool/mode.

Valores aceptados: System, User
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos. Puede actualizar el taint de nodo existente de un grupo de nodos o crear un nuevo valor taint de nodo para un grupo de nodos. Pase la cadena "" vacía para quitar todos los taints.

--os-sku

La os-sku del grupo de nodos del agente.

Valores aceptados: AzureLinux, CBLMariner, Mariner
--scale-down-mode

Describir cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Valores aceptados: Deallocate, Delete
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--update-cluster-autoscaler -u

Actualice min-count o max-count para el escalador automático del clúster.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool update (aks-preview extensión)

Actualice las propiedades de un grupo de nodos.

Actualice un grupo de nodos para habilitar o deshabilitar el escalador automático de clústeres o cambie min-count o max-count. Cuando se llama sin argumentos opcionales, intenta mover el grupo de nodos a su estado objetivo sin cambiar la configuración actual del grupo de nodos. Esto se puede usar para salir de un estado no correcto.

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]
                       [--update-cluster-autoscaler]
                       [--yes]

Ejemplos

Concilie el grupo de nodos a su estado actual.

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

Habilitación del escalador automático de clústeres dentro del intervalo de recuento de nodos [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Deshabilitación del escalador automático de clústeres para un clúster existente

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

Actualice min-count o max-count para el escalador automático del clúster.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Cambiar un grupo de nodos al modo del sistema

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--allowed-host-ports
Vista previa

Exponga los puertos de host en el grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por comas de intervalos con protocolo, por ejemplo. 80/TCP,443/TCP,4000-5000/TCP. Debe usar el tipo de grupo de agentes de VMSS.

--asg-ids
Vista previa

Identificadores de los grupos de seguridad de aplicaciones a los que debe pertenecer la interfaz de red del grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por comas de identificadores. Debe usar el tipo de grupo de agentes de VMSS.

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

Deshabilite Confianza de CA personalizada en el grupo de nodos del agente.

Valor predeterminado: False
--disable-cluster-autoscaler -d

Deshabilite el escalador automático del clúster.

Valor predeterminado: False
--disable-fips-image

Cambie para usar el sistema operativo no habilitado para FIPS en los nodos del agente.

Valor predeterminado: False
--disable-secure-boot
Vista previa

Deshabilite el arranque seguro en un grupo de nodos de agente habilitado para inicio seguro existente.

Valor predeterminado: False
--disable-vtpm
Vista previa

Deshabilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente.

Valor predeterminado: False
--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--enable-artifact-streaming
Vista previa

Habilite el streaming de artefactos para VirtualMachineScaleSets administrado por un grupo de nodos para acelerar el arranque en frío de los contenedores en un nodo a través de la carga de imágenes a petición. Para usar esta característica, las imágenes de contenedor también deben habilitar el streaming de artefactos en ACR. Si no se especifica, el valor predeterminado es false.

Valor predeterminado: False
--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--enable-custom-ca-trust

Habilite Confianza de CA personalizada en el grupo de nodos del agente.

Valor predeterminado: False
--enable-fips-image

Cambie para usar el sistema operativo habilitado para FIPS en los nodos del agente.

Valor predeterminado: False
--enable-secure-boot
Vista previa

Habilite el arranque seguro en un grupo de nodos de agente habilitado para inicio seguro existente. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--enable-vtpm
Vista previa

Habilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente. Debe usar el tipo de grupo de agentes de VMSS.

Valor predeterminado: False
--if-match

El valor proporcionado se comparará con la ETag del grupo de nodos, si coincide con la operación. Si no coincide, la solicitud se rechazará para evitar sobrescrituras accidentales. No se debe especificar al crear un grupo de agentes.

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo grupo de nodos, pero para evitar la actualización de un grupo de nodos existente. Se omitirán otros valores.

--labels

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--max-count

Número máximo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--min-count

Número de nodos de minicomunión usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--mode

Modo para un grupo de nodos que define la función principal de un grupo de nodos. Si se establece como "Sistema", AKS prefiere programar pods del sistema en grupos de nodos con el modo System. Obtenga más información en https://aka.ms/aks/nodepool/mode.

Valores aceptados: Gateway, System, User
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos.

--os-sku

La os-sku del grupo de nodos del agente.

Valores aceptados: AzureLinux, Ubuntu
--scale-down-mode

Describe cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Valores aceptados: Deallocate, Delete
--ssh-access
Vista previa

Actualice la configuración de SSH para el grupo de nodos. Use "disabled" para deshabilitar el acceso SSH, "localuser" para habilitar el acceso SSH mediante la clave privada.

Valores aceptados: disabled, localuser
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--update-cluster-autoscaler -u

Actualice min-count o max-count para el escalador automático del clúster.

Valor predeterminado: False
--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool upgrade

Actualiza el grupo de nodos en un clúster de Kubernetes administrado.

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 requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Pares clave-valor separados por comas para especificar encabezados personalizados.

--drain-timeout

Cuando los nodos se purgan cuánto tiempo se espera a que se desaloten todos los pods.

--kubernetes-version -k

Versión de Kubernetes a la que actualizar el grupo de nodos, como "1.16.9".

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33 % (mutuamente excluyente con "--node-image-only". Consulte "az aks nodepool update --max-surge" para actualizar el aumento máximo antes de actualizar con "--node-image-only").

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-image-only

Actualice solo la imagen de nodo del grupo de agentes.

Valor predeterminado: False
--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--snapshot-id

Identificador de instantánea de origen que se usa para actualizar este grupo de nodos.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool upgrade (aks-preview extensión)

Actualiza el grupo de nodos en un clúster de Kubernetes administrado.

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 requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--aks-custom-headers

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--if-match

El valor proporcionado se comparará con la ETag del grupo de nodos, si coincide con la operación. Si no coincide, la solicitud se rechazará para evitar sobrescrituras accidentales. No se debe especificar al crear un grupo de agentes. En el caso de las solicitudes de versión de la imagen del nodo de actualización, se omitirá.

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo grupo de nodos, pero para evitar la actualización de un grupo de nodos existente. Se omitirán otros valores.

--kubernetes-version -k

Versión de Kubernetes a la que actualizar el grupo de nodos, como "1.11.12".

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--node-image-only

Actualice solo la imagen de nodo del grupo de agentes.

Valor predeterminado: False
--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--snapshot-id

Identificador de instantánea de origen que se usa para actualizar este grupo de nodos. Debe usar el tipo de grupo de agentes de VMSS.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks nodepool wait

Espere a que un grupo de nodos alcance un estado deseado.

Si se interrumpió una operación en un grupo de nodos o se inició con --no-wait, use este comando para esperar a que se complete.

az aks nodepool wait --cluster-name
                     --name
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

Ejemplos

Espere a que un grupo de nodos alcance un estado deseado, sondeando cada minuto hasta treinta minutos.

az aks nodepool wait --created --interval 60 --cluster-name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.