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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.
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.
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.
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.
Deshabilite Windows OutboundNAT en el grupo de nodos del agente de Windows. Debe usar el tipo de grupo de agentes de VMSS.
Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.
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.
Habilite el escalador automático del clúster. Debe usar el tipo de grupo de agentes de VMSS.
Habilite Confianza de CA personalizada en el grupo de nodos del agente.
Habilite EncryptionAtHost en el grupo de nodos del agente.
Use el sistema operativo habilitado para FIPS en los nodos del agente.
Habilite la dirección IP pública del nodo VMSS. Debe usar el tipo de grupo de agentes de VMSS.
Habilite el arranque seguro en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.
Habilite UltraSSD en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.
Habilite vTPM en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.
Directiva de expulsión del grupo de nodos de spot. Solo se puede establecer cuando --priority es Spot.
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.
Perfil de instancia de GPU para particionar gpu múltiples GPU nvidia.
(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.
Configuraciones de Kubelet para nodos de agente.
Versión de Kubernetes que se usará para crear el clúster, como "1.7.12" o "1.8.7".
Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.
Configuraciones del sistema operativo para nodos del agente de Linux.
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.
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".
Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.
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.
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.
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.
No espere hasta que finalice la operación de ejecución prolongada.
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
.
Tamaño en GiB del disco del sistema operativo para cada nodo del grupo de agentes. Mínimo 30 GiB.
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').
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.
IpTags del nodo direcciones IP públicas. Debe usar el tipo de grupo de agentes de VMSS.
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.
Las intolerancias de nodo del grupo de nodos.
Tamaño de las máquinas virtuales que se van a crear como nodos de Kubernetes.
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.
Tipo de sistema operativo. Linux o Windows. Windows aún no se admite para el tipo de conjunto de máquinas virtuales "VirtualMachines".
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.
El identificador de una subred de una red virtual existente en la que asignar pods en el clúster (requiere azure network-plugin).
Identificador de un PPG. Debe usar el tipo de grupo de agentes de VMSS.
Prioridad del grupo de nodos.
Describe cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.
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.
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.
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.
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.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Tipo de conjunto de máquinas virtuales del grupo de agentes. VirtualMachineScaleSets, AvailabilitySet o VirtualMachines(Preview).
Lista separada por comas de tamaños. Debe usar el tipo de grupo de agentes VirtualMachines.
Identificador de la subred de una red virtual existente en la que se va a implementar el clúster.
Determina el tipo de carga de trabajo que puede ejecutar un nodo. El valor predeterminado es OCIContainer.
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
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
(VERSIÓN PRELIMINAR) ignore-pod-disruption-budget elimina un grupo de nodos existente sin tener en cuenta el presupuesto de interrupciones del pod.
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Lista separada por espacios de nombres de máquina del grupo de agentes que se va a eliminar.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.
No espere hasta que finalice la operación de ejecución prolongada.
Número de nodos del grupo de nodos de Kubernetes.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.
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.
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.
Deshabilite Confianza de CA personalizada en el grupo de nodos del agente.
Deshabilite el escalador automático del clúster.
Deshabilite el arranque seguro en un grupo de nodos de agente habilitado para inicio seguro existente.
Deshabilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente.
Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.
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.
Habilite el escalador automático del clúster. Debe usar el tipo de grupo de agentes de VMSS.
Habilite Confianza de CA personalizada en el grupo de nodos del agente.
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.
Habilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente. Debe usar el tipo de grupo de agentes de VMSS.
Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.
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.
Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.
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.
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.
No espere hasta que finalice la operación de ejecución prolongada.
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.
Las intolerancias de nodo del grupo de nodos.
La os-sku del grupo de nodos del agente.
Describe cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.
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.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Actualice min-count o max-count para el escalador automático del clúster.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
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
El nombre del clúster.
Nombre del grupo de nodos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.
Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.
Versión de Kubernetes a la que actualizar el grupo de nodos, como "1.11.12".
Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.
No espere hasta que finalice la operación de ejecución prolongada.
Actualice solo la imagen de nodo del grupo de agentes.
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.
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.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de