Actualizaciones del grupo de nodos azul-verde en Azure Kubernetes Service (AKS) (versión preliminar)

Las actualizaciones azul-verde permiten actualizar los grupos de nodos de AKS agregando nuevos nodos verdes con la configuración actualizada (versión de imagen de kubernetes y nodo) al grupo de nodos existente, mientras que los nodos azules originales siguen ejecutándose. Esta estrategia le permite probar y validar la nueva configuración antes de confirmar la nueva versión, con la capacidad de revertir rápidamente si surgen problemas.

En este artículo se explica cuándo usar actualizaciones azul-verde, cómo funciona el proceso, las opciones de configuración y las consideraciones para usar esta estrategia de actualización.

Cuándo usar actualizaciones azul-verde

Considere las actualizaciones azul-verde cuando:

• Se requieren pruebas y verificaciones pormenorizadas de las cargas de trabajo por lotes.
• Debe validar nuevas configuraciones de nodo antes de cambiar el tráfico de producción.
• Desea una funcionalidad de reversión instantánea sin volver a aprovisionar nodos.
• Está actualizando las cargas de trabajo críticas de producción que no pueden tolerar interrupciones.
• Debe probar la compatibilidad de aplicaciones con las nuevas versiones de Kubernetes.

Si actualmente usa un proceso de implementación azul-verde manual para las actualizaciones del grupo de nodos y quiere automatizar este flujo de trabajo, considere la posibilidad de usar actualizaciones del grupo de nodos azul-verde de AKS en su lugar. Para obtener más información sobre el proceso manual de actualización azul verde, consulte Actualizaciones manuales del grupo de nodos azul-verde.

Cuándo usar actualizaciones graduales estándar

Las actualizaciones graduales estándar podrían ser más adecuadas en los escenarios siguientes:

• Entornos de desarrollo o prueba con tolerancia al tiempo de inactividad.
• Implementaciones sensibles a los costos en las que la duplicación temporal es prohibitiva.
• Aplicaciones simples sin estado con una buena gestión de interrupciones.
• Entornos con cuota o capacidad disponibles limitadas.

Prerrequisitos

• Cuota suficiente para duplicar la capacidad del grupo de nodos.
• CLI de Azure versión 2.64.0 o posterior. Busque su versión usando el comando az --version. Si necesita instalar o actualizar, consulte Install CLI de Azure.
• La extensión aks-preview CLI de Azure instalada y actualizada a la versión más reciente.
• Versión 2025-08-02-preview de la API o posterior.
• Escalador automático de clúster configurado (recomendado, pero no obligatorio).

Instalación de la extensión aks-preview CLI de Azure

Instale o actualice la aks-preview extensión mediante los az extension add comandos y az extension update .

# Install the aks-preview extension
az extension add --name aks-preview

# Update the aks-preview extension
az extension update --name aks-preview

Características compatibles para las actualizaciones azul-verde

Las actualizaciones azul-verde admiten actualmente las siguientes características:

• Actualizaciones de la versión de Kubernetes
• Actualizaciones de imágenes de nodo
• Grupos de nodos de usuario y del sistema
• Control manual de confirmación y reversión
• Escalador automático de clústeres
• Zonas de disponibilidad
• PodDisruptionBudgets
• Canales de actualización automática y ventanas de mantenimiento programado
• AKS Communication Manager

Limitaciones y consideraciones de actualización azul-verde

Las actualizaciones azul-verde no admiten actualmente las siguientes características:

• Reversión automatizada
• Uso de la estrategia azul-verde para actualizaciones fuera de Kubernetes y de la versión de la imagen del nodo (p. ej., rotación de certificados, actualizaciones de la configuración de kubelet/sistema operativo, etc.)
• Grupos de máquinas virtuales (VM)
• Configuración máxima no disponible
• Comportamiento de nodo no drenable y configuración de maxBlockedNodes

Tenga en cuenta las siguientes consideraciones al usar actualizaciones azul-verde:

Flujo de trabajo de actualización azul-verde

El proceso de actualización azul-verde crea un entorno paralelo para transiciones seguras entre las versiones del grupo de nodos. Puede actualizar y comprometerse al nuevo grupo verde después de la validación o actualizar y revertir al grupo azul original si encuentra problemas.

Escenario de actualización y confirmación

En el diagrama siguiente se muestra el flujo de trabajo de actualización y confirmación:

El proceso de actualización y confirmación es el siguiente:

1. Acordonar nodos azules: los nodos azules existentes se marcan como no programables.
2. Agregar nodos verdes: se agregan nuevos nodos verdes con la configuración actualizada al grupo de nodos existente.
3. Operación paralela: los nodos azul y verde se ejecutan simultáneamente dentro del mismo grupo de nodos.
4. Migración gradual: las cargas de trabajo se purgan progresivamente de nodos azules y se vuelven a programar a los nodos verdes en lotes.
5. Validar nodos verdes: supervise y pruebe las cargas de trabajo en los nuevos nodos durante la migración.
6. Transición completa: después del período de validación final, los nodos azules se eliminan y los nodos verdes se convierten en principales.

Escenario de actualización y reversión

En el diagrama siguiente se muestra el flujo de trabajo de actualización y retroceso.

El proceso de actualización y reversión es el siguiente:

1. Acordonar nodos azules: los nodos azules existentes se marcan como no programables.
2. Agregar nodos verdes: se agregan nuevos nodos verdes con la configuración actualizada al grupo de nodos existente.
3. Operación paralela: los nodos azul y verde se ejecutan simultáneamente dentro del mismo grupo de nodos.
4. Detectar problemas: identifique problemas durante la validación en nodos verdes .
5. Ejecutar reversión: descordonar nodos azules, drenar nodos verdes y migrar las cargas de trabajo de vuelta a nodos azules.
6. Estado de restauración: se eliminan los nodos verdes y el grupo de nodos vuelve a su configuración original.

Elección de la estrategia de actualización

Al crear o actualizar un grupo de nodos de AKS, puede especificar la estrategia de actualización (upgradeStrategy) que se va a usar. Las estrategias disponibles incluyen:

Personalizar propiedades de actualización azul-verde

Puede personalizar las siguientes propiedades de actualización azul-verde (NodePoolBlueGreenUpgradeSettings):

Creación de un grupo de nodos con la configuración de actualización azul-verde predeterminada

• Cree un grupo de nodos con la estrategia de actualización predeterminada azul-verde y sus configuraciones usando el comando az aks nodepool add con el parámetro --upgrade-strategy establecido en bluegreen. En el ejemplo siguiente se crea un nuevo grupo de nodos denominado myNodePool en el clúster myAKSCluster de AKS dentro del grupo myResourceGroupde recursos :

  az aks nodepool add \
      --name myNodePool \
      --cluster-name myAKSCluster \
      --resource-group myResourceGroup \
      --upgrade-strategy bluegreen
  

Creación de un grupo de nodos con la configuración de actualización azul-verde personalizada

• Cree un grupo de nodos con configuraciones de actualización azul-verde personalizadas usando el comando az aks nodepool add con el parámetro --upgrade-strategy establecido en bluegreen y configure cualquier otra opción de actualización azul-verde personalizada deseada. En el ejemplo siguiente se crea un nuevo grupo de nodos denominado myNodePool en el clúster myAKSCluster de AKS dentro del grupo myResourceGroupde recursos , con la configuración de actualización azul-verde personalizada:

  az aks nodepool add \
      --name myNodePool \
      --cluster-name myAKSCluster \
      --resource-group myResourceGroup \
      --upgrade-strategy bluegreen \
      --drain-timeout-bg 5 \
      --batch-soak-duration 5 \
      --drain-batch-size 50% \
      --final-soak-duration 180
  

Iniciar una actualización azul-verde para un grupo de nodos existente

• Inicie una actualización azul-verde para un grupo de nodos existente utilizando el comando az aks nodepool upgrade con el parámetro --kubernetes-version establecido en su versión deseada. Puede iniciar una actualización azul-verde para un grupo de nodos que ya usa la estrategia azul-verde o para un grupo de nodos aún no configurado con la estrategia azul-verde. En los ejemplos siguientes se muestran ambos escenarios:

  # Start a blue-green upgrade for an existing node pool already using blue-green strategy
  az aks nodepool upgrade \
      --name myNodePool \
      --cluster-name myAKSCluster \
      --resource-group myResourceGroup \
      --kubernetes-version <kubernetes-version>
  
  # Start a blue-green upgrade for an existing node pool not yet using blue-green strategy
  az aks nodepool upgrade \
      --name myNodePool \
      --cluster-name myAKSCluster \
      --resource-group myResourceGroup \
      --kubernetes-version <kubernetes-version> \
      --upgrade-strategy bluegreen
  

Pausar o cancelar una actualización azul-verde

• Pause o cancele una actualización azul-verde en curso con el comando az aks nodepool operation-abort. En el ejemplo siguiente se pausa o se cancela la actualización azul-verde para el grupo de nodos denominado myNodePool en el clúster myAKSCluster de AKS dentro del grupo myResourceGroupde recursos :

  az aks nodepool operation-abort \
      --name myNodePool \
      --cluster-name myAKSCluster \
      --resource-group myResourceGroup
  

Reversión de una actualización azul-verde

Una vez cancelada una actualización azul-verde en curso, la reversión se puede iniciar mediante el az aks nodepool rollback comando .

La reversión solo está disponible durante el período de reposo final, como se describe en la propiedad finalSoakDurationInMinutes .

En el ejemplo siguiente se realiza una reversión de la actualización azul-verde para el grupo de nodos denominado myNodePool en el clúster myAKSCluster de AKS dentro del grupo myResourceGroupde recursos :

az aks nodepool rollback \
    --name myNodePool \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup

Preguntas más frecuentes (FAQ)

¿Admiten las implementaciones azul-verde la configuración maxUnavailable?

No, la maxUnavailable configuración no se aplica a las actualizaciones azul-verde. Los nuevos nodos verdes se agregan al grupo de nodos existente junto con los nodos azules existentes, lo que garantiza que todos los nodos originales permanezcan disponibles durante el proceso de actualización.

¿Se pueden utilizar las actualizaciones azul-verde para actualizaciones de grupos de nodos más allá de Kubernetes y la versión de la imagen del nodo?

No, la estrategia de actualización azul-verde es específica para Kubernetes y las actualizaciones de la versión de la imagen del nodo en este momento. Otros cambios, como la rotación de certificados o kubelet y los cambios de configuración del sistema operativo no se pueden ejecutar a través de la estrategia de actualización azul-verde.

¿Qué versiones de Kubernetes son compatibles con las actualizaciones azul-verde?

Las actualizaciones azules y verdes funcionan con todas las versiones de Kubernetes compatibles con AKS, incluidas las versiones compatibles con la comunidad y las versiones de soporte técnico a largo plazo (LTS), siempre y cuando use la versión 2025-08-02-preview de API o posterior.

¿Puedo usar el canal de revisiones de seguridad automáticas con actualizaciones azul-verde?

Sí, siempre que la estrategia de actualización del grupo de nodos esté configurada para usar azul-verde. Cuando se configura, las revisiones de seguridad siguen el proceso de actualización azul-verde en lugar del mecanismo de actualización gradual predeterminado.

¿Qué ocurre con los volúmenes persistentes durante las actualizaciones azules y verdes?

Los volúmenes persistentes siguen siendo accesibles. Los pods se purgan y se vuelven a programar correctamente, manteniendo sus datos adjuntos de volumen.

¿Puedo realizar actualizaciones azules y verdes en varios grupos de nodos simultáneamente?

Sí, los distintos grupos de nodos pueden someterse a actualizaciones azules y verdes en paralelo, pero cada grupo solo puede tener una actualización activa. Actualmente no puede controlar el orden de las actualizaciones en varios grupos.

¿Cómo gestionan las actualizaciones azul-verde las configuraciones propias del nodo, como tolerancias y etiquetas?

Todas las configuraciones de nodo, incluidas las tolerancias, etiquetas y anotaciones, se replican automáticamente en el grupo verde.

¿Cuál es el impacto en el costo de las actualizaciones azules y verdes?

Se le cobra por los nodos azules originales y los nuevos nodos verdes durante la ventana de actualización, por lo que debe asegurarse de planear la duplicación de costos temporales durante el período de transición.

¿Qué ocurre durante un error de capacidad?

En caso de que se produzca un error de capacidad al agregar los nodos verdes , se produce un error en la actualización y los nodos azules no se ven afectados. Puede volver a intentar la actualización una vez que haya suficiente capacidad disponible o optar por revertirla.

¿Qué ocurre durante la reversión?

Si el número de nodos verdes es menor o igual al de los nodos azules cuando se inicia la reversión, los nodos verdes se eliminan y los nodos azules se desacordonan y vuelven a activar para reanudar el funcionamiento normal.

Contenido relacionado

Para más información sobre las actualizaciones del grupo de nodos en AKS, consulte los artículos siguientes:

• Reversión de versiones del grupo de nodos en Azure Kubernetes Service (AKS) (versión preliminar)
• Configurar actualizaciones graduales para grupos de nodos de Azure Kubernetes Service (AKS)
• Actualización automática de imágenes del sistema operativo de nodos en Azure Kubernetes Service (AKS)