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 |
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
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
Pares clave-valor separados por comas para especificar encabezados personalizados.
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
.
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.
Identificador crg usado para asociar el nuevo grupo de nodos con el recurso grupo de reserva de capacidad existente.
Deshabilite Windows OutboundNAT en el grupo de nodos del agente de Windows.
Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.
Habilite el escalador automático del clúster.
Enable EncryptionAtHost, el valor predeterminado es false.
Use el sistema operativo habilitado para FIPS en los nodos del agente.
Habilite la dirección IP pública del nodo VMSS.
Habilitar UltraSSD, el valor predeterminado es false.
Directiva de expulsión del grupo de nodos de spot. Solo se puede establecer cuando --priority es Spot.
Perfil de instancia de GPU para particionar gpu múltiples GPU nvidia.
Identificador de grupo host dedicado completo que se usa para aprovisionar el grupo de nodos del agente.
Ruta de acceso al archivo JSON que contiene configuraciones de Kubelet para los nodos del agente. https://aka.ms/aks/custom-node-config.
Versión de Kubernetes que se usará para crear el clúster, como "1.16.9".
Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.
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.
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%.
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.
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.
IpTags del nodo direcciones IP públicas.
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.
SKU del sistema operativo del grupo de nodos del agente. Ubuntu o CBLMariner para Linux. Windows2019 o Windows2022 para Windows.
Tipo de sistema operativo. Linux o Windows.
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).
Identificador de un PPG.
Prioridad del grupo de nodos.
Describir cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.
Identificador de instantánea de origen que se usa para crear este grupo de nodos.
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.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Identificador de recurso de una subred en una red virtual existente en la que se va a implementar el clúster.
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
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 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
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.
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.
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.
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
[--no-wait]
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
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 (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
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
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.
(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 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
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. 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
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 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
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
[--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
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 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
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
[--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
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 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
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 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
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 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
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 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
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]
[--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
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
Pares clave-valor separados por comas para especificar encabezados personalizados.
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
.
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.
Deshabilite el escalador automático del clúster.
Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.
Habilite el escalador automático del clúster.
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 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.
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. 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.
La os-sku del grupo de nodos del agente.
Describir cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.
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.
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 (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
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.
Cambie para usar el sistema operativo no habilitado para FIPS en los nodos del agente.
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.
Cambie para usar el sistema operativo habilitado para FIPS en los 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.
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.
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.
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
Pares clave-valor separados por comas para especificar encabezados personalizados.
Cuando los nodos se purgan cuánto tiempo se espera a que se desaloten todos los pods.
Versión de Kubernetes a la que actualizar el grupo de nodos, como "1.16.9".
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 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.
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 (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
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.
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á.
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.
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.
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
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
Espere hasta que se cree con "provisioningState" en "Succeeded".
Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Espere hasta que se elimine.
Espere hasta que exista el recurso.
Intervalo de sondeo en segundos.
Espera máxima en segundos.
Espere hasta que se actualice con provisioningState en "Succeeded".
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.