Share via


az aks nodepool

Nota:

Esta referencia forma parte de la extensión aks-preview para la CLI de Azure (versión 2.56.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az aks nodepool . Obtenga más información sobre las extensiones.

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

Comandos

Nombre Description Tipo Estado
az aks nodepool add

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.

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.

Extensión GA
az aks nodepool list

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.

Extensión GA
az aks nodepool scale

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.

Extensión GA
az aks nodepool snapshot

Comandos para administrar instantáneas del grupo de nodos.

Extensión GA
az aks nodepool snapshot create

Cree una instantánea de grupo de nodos.

Extensión GA
az aks nodepool snapshot delete

Elimine una instantánea de grupo de nodos.

Extensión GA
az aks nodepool snapshot list

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.

Extensión GA
az aks nodepool snapshot update

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

Extensión GA
az aks nodepool start

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.

Extensión GA
az aks nodepool update

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.

Extensión 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-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]
                    [--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.

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

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

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
                                [--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
                      [--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 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 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 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]
                       [--dcat]
                       [--disable-cluster-autoscaler]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-custom-ca-trust]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--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-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-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
--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

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.

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