Actualice automáticamente un clúster de Azure Kubernetes Service (AKS)

Parte del ciclo de vida del clúster de AKS implica efectuar actualizaciones periódicas a la versión más reciente de Kubernetes. Es importante aplicar las versiones de seguridad más recientes o actualizar para obtener las características más recientes. Antes de obtener información sobre las actualizaciones automáticas, asegúrese de comprender los aspectos básicos de la actualización del clúster de AKS.

¿Por qué usar la actualización automática del clúster?

La actualización automática del clúster proporciona un mecanismo establecido una vez y olvida que produce beneficios tangibles de tiempo y costo operativo. No es necesario detener las cargas de trabajo, volver a implementar las cargas de trabajo ni crear un nuevo clúster de AKS. Al habilitar la actualización automática, puede asegurarse de que los clústeres están actualizados y no se pierdan las características o revisiones más recientes desde AKS y Kubernetes ascendente.

AKS sigue una ventana de control de versiones de compatibilidad estricta. Con los canales de actualización automática seleccionados correctamente, puede evitar que los clústeres caigan en una versión no admitida. Para más información sobre la ventana de soporte técnico de AKS, consulte Versiones menores de alias.

Clientes frente a actualizaciones automáticas iniciadas por AKS

Puede especificar detalles de la actualización automática del clúster mediante las instrucciones siguientes. Las actualizaciones se producen en función de la cadencia especificada y se recomienda permanecer en las versiones de Kubernetes compatibles.

AKS también inicia las actualizaciones automáticas para clústeres no compatibles. Cuando un clúster de una versión n-3 (donde n es la versión secundaria de disponibilidad general de AKS más reciente compatible) está a punto de pasar a n-4, AKS actualiza automáticamente el clúster a n-2 para permanecer en una directiva de soporte técnico de AKS. La actualización automática de un clúster compatible con la plataforma a una versión compatible está habilitada de manera predeterminada. Los grupos de nodos detenidos se actualizan durante una operación de actualización automática. La actualización se aplica a los nodos cuando se inicie el grupo de nodos. Para minimizar las interrupciones, configure las ventanas de mantenimiento.

Limitaciones de la actualización automática del clúster

Si usa la actualización automática del clúster, ya no puede actualizar primero el plano de control y, a continuación, actualizar los grupos de nodos individuales. La actualización automática del clúster siempre actualiza el plano de control y los grupos de nodos juntos. No se puede actualizar solo el plano de control. Al ejecutar el comando se produce el az aks upgrade --control-plane-only siguiente error:

NotAllAgentPoolOrchestratorVersionSpecifiedAndUnchanged: Using managed cluster api, all Agent pools' OrchestratorVersion must be all specified or all unspecified. If all specified, they must be stay unchanged or the same with control plane.

Si usa el node-image canal de actualización automática del clúster (heredado y que no debe utilizarse) o el NodeImage canal de actualización automática de la imagen de nodo, las actualizaciones desatendidas de Linux se deshabilitarán de manera predeterminada.

Canales de actualización automática del clúster

Las actualizaciones completadas automáticamente son funcionalmente las mismas que las actualizaciones manuales. El canal de actualización automática seleccionado determina el tiempo de actualización. Al realizar cambios en la actualización automática, permita 24 horas para que los cambios surtan efecto. La actualización automática de un clúster sigue el mismo proceso que la manual. Para más información, consulte Actualización de un clúster de Azure Kubernetes Service.

Están disponibles los siguientes canales de actualización:

Uso de la actualización automática del clúster con un nuevo clúster de AKS

export RANDOM_SUFFIX=$(openssl rand -hex 3)
export RESOURCE_GROUP="myResourceGroup$RANDOM_SUFFIX"
export AKS_CLUSTER_NAME="myAKSCluster"
az aks create --resource-group $RESOURCE_GROUP --name $AKS_CLUSTER_NAME --auto-upgrade-channel stable --generate-ssh-keys

Uso de la actualización automática del clúster con un clúster de AKS existente

az aks update --resource-group $RESOURCE_GROUP --name $AKS_CLUSTER_NAME --auto-upgrade-channel stable

{
  "id": "/subscriptions/aaaa6a6a-bb7b-cc8c-dd9d-eeeeee0e0e0e/resourceGroups/myResourceGroupabc123/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "properties": {
    "autoUpgradeChannel": "stable",
    "provisioningState": "Succeeded"
  }
}

Uso de la actualización automática con mantenimiento planeado

Si usa Mantenimiento planeado y actualización automática del clúster, la actualización se inicia durante la ventana de mantenimiento especificada.

Para obtener más información sobre cómo establecer una ventana de mantenimiento con el mantenimiento planeado, consulte Uso del mantenimiento planeado a fin de programar ventanas de mantenimiento para el clúster de Azure Kubernetes Service (AKS).

Procedimientos recomendados para la actualización automática del clúster

Use los procedimientos recomendados siguientes para ayudar a maximizar el éxito al usar la actualización automática:

• Para asegurarse de que el clúster siempre está en una versión compatible, por ejemplo, dentro de la regla N-2, elija los canales stable o rapid.
• Si está interesado en obtener las revisiones más recientes tan pronto como sea posible, use el canal patch. El canal node-image es una buena opción si desea que los grupos de agentes siempre ejecuten las imágenes de nodo más recientes.
• Para actualizar automáticamente las imágenes de nodo al usar un canal de actualización de clúster diferente, considere la posibilidad de usar el canal de actualización automática de la NodeImage.
• Siga los Procedimientos recomendados para operadores.
• Siga los procedimientos recomendados de PodDisruptionBudget (PDB).
• Para obtener información sobre la solución de problemas de actualización, consulte la documentación de solución de problemas de AKS.

Para obtener una explicación detallada de los procedimientos recomendados de actualización y otras consideraciones, consulte Guía de actualización y revisión de AKS.