Definición de estrategias de actualización reutilizables mediante Fleet Manager de Azure Kubernetes

Los administradores pueden controlar la secuencia de actualizaciones de los clústeres administrados por Flota mediante la definición de una serie de fases y grupos. Pueden configurar cuándo deben producirse aprobaciones y pausas dentro de esas fases y grupos. Toda la configuración se puede guardar como una estrategia de actualización que se puede administrar independientemente de las ejecuciones de actualizaciones o las actualizaciones automáticas, lo que permite reutilizar las estrategias según sea necesario.

En este artículo se explica cómo definir estrategias de actualización mediante grupos y fases.

Requisitos previos

• Lea la Introducción conceptual de las actualizaciones de Flota, que proporciona una explicación de las ejecuciones de actualizaciones, las fases, los grupos y las estrategias a las que se hace referencia en esta guía.

• Debe tener un recurso Fleet con uno o varios clústeres miembro. Si no es así, siga el inicio rápido para crear un recurso Fleet y combinar clústeres de Azure Kubernetes Service (AKS) como miembros.

• Establezca estas variables de entorno:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export CLUSTERID=<aks-cluster-resource-id>
  export STRATEGY=<strategy-name>
  

• Si sigue las instrucciones de la CLI de Azure de este artículo, necesita la versión 2.70.0 o posterior de la CLI de Azure instalada. Para la instalación o la actualización, consulte Instalación de la CLI de Azure.

• También necesita la versión 1.6.0 o posterior de la extensión de la fleet CLI de Azure, que puede instalar mediante la ejecución del siguiente comando:

  az extension add --name fleet
  

  Ejecute el comando az extension update para actualizar a la versión más reciente de la extensión publicada:

  az extension update --name fleet
  

Selección de clústeres para la estrategia

Hay dos maneras de seleccionar qué clústeres se incluyen en cada fase y grupo de la estrategia de actualización para controlar la secuencia de actualizaciones:

• Etiquetas de miembro (recomendadas): asigne etiquetas a cada miembro de flota y úselas memberSelector para seleccionar miembros por esas etiquetas. Cada miembro puede tener varias etiquetas.
• Grupos de actualización: asigne un grupo de actualizaciones a cada miembro de flota y, a continuación, defina grupos en la estrategia que coincidan con esos nombres de grupo. Cada miembro solo puede pertenecer a un grupo.

Creación de una estrategia de actualización mediante selectores de miembros (versión preliminar)

Las etiquetas de miembro son el enfoque recomendado para seleccionar clústeres en las estrategias de actualización, ya que proporcionan más flexibilidad. Para obtener detalles conceptuales, consulte Agrupación de clústeres mediante etiquetas de miembro.

Aplicación de etiquetas en clústeres de miembros

Aplicar etiquetas al agregar un clúster miembro a la flota

Aplique etiquetas a los miembros de la flota mediante el az fleet member create comando . En el ejemplo siguiente se aplican dos etiquetas al clúster miembro: env=staging y tier=frontend:

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --labels "env=staging tier=frontend"

Aplicar etiquetas a un miembro de flota existente

Aplicar etiquetas a los miembros de la flota mediante el az fleet member update comando

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --labels "env=staging tier=frontend"

Creación de una estrategia de actualización

Una estrategia de actualización consta de una o varias fases, donde una fase puede contener uno o varios grupos de actualizaciones.

1. Cree un archivo JSON para definir las fases y grupos de la ejecución de la actualización. Las fases se ejecutan secuencialmente en el orden en que aparecen en el archivo JSON. Los grupos se ejecutan en paralelo dentro de cada fase. El siguiente archivo de ejemplo (example-labels-strategy.json) define una estrategia con dos fases mediante memberSelector para seleccionar clústeres por sus etiquetas e incluye la configuración opcional maxConcurrency :

   • La staging etapa utiliza un memberSelector a nivel de etapa para seleccionar todos los clústeres con la etiqueta env=staging y crear un grupo implícito.
   • La production fase utiliza un memberSelector a nivel de fase para filtrar previamente todos los clústeres con la etiqueta env=production y, a continuación, define dos grupos, cada uno con su propio memberSelector para seleccionar clústeres por la etiqueta tier.

   Cuando se define memberSelector en un grupo, el campo name del grupo solo sirve como identificador visual para los informes de estado y el registro de eventos y ya no se usa para la selección de miembros de la flota según los cambios en el grupo.

   {
       "stages": [
           {
               "name": "staging",
               "memberSelector": { "byLabel": "env=staging" },
               "maxConcurrency": "1",
               "afterStageWaitInSeconds": 600
           },
           {
               "name": "production",
               "memberSelector": { "byLabel": "env=production" },
               "maxConcurrency": "4",
               "groups": [
                   {
                       "name": "frontend",
                       "memberSelector": { "byLabel": "tier=frontend" },
                       "maxConcurrency": "3"
                   },
                   {
                       "name": "backend",
                       "memberSelector": { "byLabel": "tier=backend" },
                       "maxConcurrency": "3"
                   }
               ]
           }
       ]
   }
   

2. Cree una nueva estrategia de actualización con el comando az fleet updatestrategy create con la marca --stages establecida en el nombre del archivo JSON.

   az fleet updatestrategy create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name $STRATEGY \
    --stages example-labels-strategy.json
   

Creación de una estrategia de actualización mediante grupos de actualizaciones

Los clústeres también se pueden seleccionar en las estrategias de actualización asignandolos a un único grupo de actualizaciones. Puede definir una estrategia de actualización que asigne estos grupos de actualizaciones a fases. Dentro de una fase de actualización, las actualizaciones se aplican a cada grupo de actualizaciones en paralelo. Dentro de un grupo de actualizaciones, los clústeres miembro se actualizan secuencialmente.

Asignación de clústeres para actualizar grupos

Asigne al grupo al agregar un clúster miembro a la flota

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --update-group group-1a

Asignar un miembro de flota existente a un grupo de actualizaciones

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --update-group group-1

Creación de una estrategia de actualización

Una estrategia de actualización consta de una o varias fases, donde una fase puede contener uno o varios grupos de actualizaciones.

Pasos siguientes

Puede usar una estrategia de actualización como parte de una ejecución de actualización manual o un perfil de actualización automática. Vea:

• Procedimientos: Actualización de varios clústeres mediante la actualización de Kubernetes Fleet Manager se ejecuta.
• Procedimiento para agregar aprobaciones a estrategias de actualización de Fleet Manager de Azure Kubernetes.
• Procedimientos: actualice automáticamente varios clústeres mediante Kubernetes Fleet Manager.
• Preguntas más frecuentes sobre las actualizaciones de varios clústeres.