Actualización de imágenes de nodo de Azure Kubernetes Service (AKS)

Azure Kubernetes Service (AKS) proporciona periódicamente nuevas imágenes de node, por lo que resulta beneficioso actualizar las imágenes de nodo con frecuencia para usar las características más recientes de AKS. Las imágenes de nodo de Linux se actualizan semanalmente y las imágenes de nodo de Windows se actualizan mensualmente. Los anuncios de actualización de imágenes se incluyen en las notas de la versión de AKS, y estas actualizaciones pueden tardar hasta una semana en implementarse en todas las regiones. Consulte el seguimiento de versiones para ver el estado de implementación. También puede realizar actualizaciones de imágenes de nodo automáticamente y programarlas mediante el mantenimiento planeado. Para más información, vea Actualización automática de imágenes de nodo.

AKS recomienda los canales de actualización automática que pueden actualizar automáticamente las imágenes de nodo o aplicar revisiones de seguridad durante las ventanas de mantenimiento. Si desea actualizar manualmente las imágenes de nodo, puede hacerlo siguiendo las instrucciones de este artículo. En este artículo se muestra cómo actualizar las imágenes de nodo de un clúster de AKS y cómo actualizar las imágenes de grupo de nodos sin actualizar la versión de Kubernetes. Para obtener información sobre la actualización de la versión del clúster de Kubernetes, vea Actualización de un clúster de AKS.

Conectarse al clúster AKS

1. Conectar al clúster de AKS mediante el comando .

   az aks get-credentials \
       --resource-group $AKS_RESOURCE_GROUP \
       --name $AKS_CLUSTER
   

Comprobar las actualizaciones de imágenes de nodo disponibles

1. Compruebe si hay actualizaciones de imágenes de nodo disponibles mediante el comando .

   az aks nodepool get-upgrades \
       --nodepool-name $AKS_NODEPOOL \
       --cluster-name $AKS_CLUSTER \
       --resource-group $AKS_RESOURCE_GROUP
   

2. En la salida, busque y anote el valor . Este valor es la versión más reciente de la imagen de nodo disponible para el grupo de nodos.

3. Compruebe la versión actual de su imagen de nodo para compararla con la última versión mediante el comando .

   az aks nodepool show \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --query nodeImageVersion
   

4. Si el valor es diferente de , puede actualizar la imagen del nodo.

Actualización de todas las imágenes de nodos de todos los grupos de nodos

1. Actualice todas las imágenes de nodo de todos los grupos de nodos del clúster mediante el comando con la marca .

   az aks upgrade \
       --resource-group $AKS_RESOURCE_GROUP \
       --name $AKS_CLUSTER \
       --node-image-only \
       --yes
   

2. Puede comprobar el estado de las imágenes de nodo mediante el comando .

   Nota:

   Este comando puede diferir ligeramente en función del shell que use. Para más información sobre los entornos de Windows y PowerShell, consulte la documentación de JSONPath de Kubernetes.

   kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
   

3. Una vez completada la actualización, use el comando para obtener los detalles actualizados del grupo de nodos. La imagen del nodo actual se muestra en la propiedad .

   az aks show \
       --resource-group $AKS_RESOURCE_GROUP \
       --name $AKS_CLUSTER  \
       --query "agentPoolProfiles[].{Name:name, NodeImageVersion:nodeImageVersion}"
   

Actualización de un grupo de nodos específico

1. Actualice la imagen del sistema operativo de un grupo de nodos sin realizar una actualización del clúster de Kubernetes, utilizando el comando con la marca .

   az aks nodepool upgrade \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --node-image-only
   

2. Puede comprobar el estado de las imágenes de nodo con el comando .

   Nota:

   Este comando puede diferir ligeramente en función del shell que use. Para más información sobre los entornos de Windows y PowerShell, consulte la documentación de JSONPath de Kubernetes.

   kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
   

3. Una vez completada la actualización, use el comando para obtener los detalles actualizados del grupo de nodos. La imagen del nodo actual se muestra en la propiedad .

   az aks nodepool show \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --query nodeImageVersion
   

Actualización de imágenes de nodo con sobrecarga de nodos

Para acelerar el proceso de actualización de la imagen de nodo, puede actualizar las imágenes de nodo mediante un valor de sobrecarga de nodo personalizable. De forma predeterminada, AKS usa un nodo adicional para configurar las actualizaciones.

1. Actualice las imágenes de nodo con sobrecarga de nodos mediante el comando con la marca para configurar el número de nodos usados para las actualizaciones.

   Nota:

   Para obtener más información sobre las ventajas e inconvenientes de varias configuraciones de , consulte Personalización de la actualización de sobrecargas de nodo.

   az aks nodepool update \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --max-surge 33% \
       --no-wait
   

2. Puede comprobar el estado de las imágenes de nodo con el comando .

   kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
   

3. Obtenga los detalles actualizados del grupo de nodos mediante el comando . La imagen del nodo actual se muestra en la propiedad .

   az aks nodepool show \
       --resource-group $AKS_RESOURCE_GROUP \
       --cluster-name $AKS_CLUSTER \
       --name $AKS_NODEPOOL \
       --query nodeImageVersion
   

Pasos siguientes

• Para obtener información sobre las imágenes de nodo más recientes, consulte las notas de la versión de AKS.
• Obtenga información sobre cómo actualizar la versión de Kubernetes con Actualización de un clúster de AKS.
• Aplicar automáticamente actualizaciones de clúster y grupo de nodos con Acciones de GitHub.
• Obtenga más información sobre varios grupos de nodos con Creación de varios grupos de nodos.
• Obtenga información sobre cómo actualizar los procedimientos recomendados con guía de actualización y revisión de AKS.