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

1. En Azure Portal, vaya al recurso de Azure Kubernetes Fleet Manager.

2. En el menú del servicio, en Configuración, seleccione Clústeres de miembros>Agregar.

   

3. Seleccione el clúster que desea agregar y, a continuación, seleccione Siguiente: revisar y agregar.

4. Escriba el nombre del grupo de actualizaciones al que desea asignar el clúster y, a continuación, seleccione Agregar.

   

Asigne un clúster miembro a un grupo de actualización al agregar el clúster miembro a la flota mediante el comando az fleet member create con el parámetro --update-group establecido en el nombre del grupo de actualización.

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

1. En Azure Portal, vaya al recurso de Azure Kubernetes Fleet Manager.

2. En el menú del servicio, en Configuración, seleccione Clústeres de miembros.

3. Seleccione los clústeres que desea asignar a un grupo de actualización y luego seleccione Asignar grupo de actualización

   

4. Escriba el nombre del grupo de actualizaciones al que desea asignar el clúster y, a continuación, seleccione Asignar.

   

Asigne un miembro de flota existente a un grupo de actualizaciones mediante el comando az fleet member update con la marca --update-group establecida en el nombre del grupo de actualizaciones.

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

1. En Azure Portal, vaya al recurso de Azure Kubernetes Fleet Manager.

2. En el menú de servicios, en Configuración, seleccione Actualización de varios clústeres>Estrategias, y a continuación, Crear.

3. Escriba un nombre para la estrategia.

4. La primera vez que vea la página, se muestra un diagrama de explicación de la estrategia de actualización que puede ayudar a visualizar cómo funcionan las estrategias.

   

5. Seleccione Crear fase y escriba:

   • Nombre de la fase: asigne un nombre a la fase; debe ser único en todos los nombres de fase de la estrategia.
   • (Opcional) Aprobaciones de fase: seleccione esta opción si desea esperar una aprobación antes de que se inicie esta fase o después de que se complete. Para obtener más información, consulte Agregar aprobaciones para actualizar grupos y fases.
   • (Opcional) Pausar después de la fase: seleccione esta opción si desea definir una pausa antes de pasar a la siguiente fase.
   • (Opcional) Pausar duración: seleccione una duración predefinida o escriba un valor personalizado en segundos.

   

6. Asigne uno o varios grupos de actualización a la fase y, a continuación, seleccione Crear.

   Nota:

   El número máximo de grupos de actualizaciones en cada fase de actualización es 50.

   

En este escenario, creamos fases y grupos para que coincidan con los detalles usados para el proceso de Azure Portal.

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, por lo que la ordenación no es importante. El siguiente archivo de ejemplo (example-stages.json) define una estrategia con dos fases e incluye maxConcurrency opciones y maxAllowedFailures opciones:

   {
       "stages": [
           {
               "name": "stage-1",
               "maxConcurrency": "7",
               "maxAllowedFailures": "2",
               "groups": [
                   {
                       "name": "group-1",
                       "maxConcurrency": "3",
                       "maxAllowedFailures": "1"
                   },
                   {
                       "name": "group-2",
                       "maxConcurrency": "50%",
                       "maxAllowedFailures": "25%"
                   }
               ],
               "afterStageWaitInSeconds": 300
           },
           {
               "name": "stage-2",
               "maxConcurrency": "100%",
               "maxAllowedFailures": "0",
               "groups": [
                   {
                       "name": "group-3",
                       "maxConcurrency": "2",
                       "maxAllowedFailures": "0"
                   }
               ]
           }
       ]
   }
   

   maxConcurrency

   El maxConcurrency campo es opcional y controla el número de clústeres que se pueden actualizar simultáneamente en el nivel de fase o grupo. Use un valor mayor para actualizar clústeres más rápido a través de la flota o un valor menor para un lanzamiento más controlado que limite el radio de explosión si surgen problemas.

   En este ejemplo, stage-1 asigna maxConcurrency a "7", lo que permite que hasta "7" clústeres en esta etapa se actualicen simultáneamente. Dentro de stage-1, group-1 limita la simultaneidad a los clústeres "3", lo que significa que hasta "3" en este grupo se pueden actualizar simultáneamente. group-2 permite que los "50%" clústeres se actualicen simultáneamente (por ejemplo, si el grupo contiene 4 clústeres, hasta 2 pueden actualizarse al mismo tiempo).

   Los valores pueden ser un entero fijo (por ejemplo, "3") o un porcentaje (por ejemplo, "100%"). Si se omite, el sistema aplica valores predeterminados. Para más información sobre cómo se resuelven estos valores y sus límites superiores, consulte Simultaneidad máxima (versión preliminar).

   maxAllowedFailures

   El campo maxAllowedFailures es opcional y controla cuántos errores en la actualización de clústeres miembros se toleran antes de que el grupo o la fase se marque como fallido. De forma predeterminada (cuando no se establece o "0"), un único error detiene toda la ejecución de la actualización.

   Esta configuración solo evalúa el recuento de errores. No aplica una tasa de éxito mínima. Por lo tanto, un grupo o una fase pueden, por tanto, finalizar en Completed incluso si algunos o todos sus miembros hayan fallado, siempre que no se hubiera superado el umbral de fallos cuando Fleet tomó sus decisiones de planificación.

   En este ejemplo, stage-1 configura maxAllowedFailures en "2", tolerando hasta dos fallos de miembros en toda la fase. Dentro de stage-1, group-1 tolera el fallo de "1" y group-2 tolera el fallo de "25%" de sus miembros (por ejemplo, si el grupo contiene 4 clústeres, se tolera hasta 1 fallo). stage-2 establece maxAllowedFailures a "0", lo que significa que cualquier fallo detiene inmediatamente la ejecución y suele ser útil en fases de producción.

   Para la mayoría de los despliegues, es preferible usar valores porcentuales porque se adaptan mejor a distintos tamaños de grupo. Evite establecer el valor igual al recuento total de miembros, a menos que desee de forma intencionada un comportamiento de "nunca falla" para ese segmento.

   Los valores pueden ser un entero fijo (por ejemplo, "3") o un porcentaje (por ejemplo, "25%"). Para más información sobre cómo se resuelven estos valores, consulte Errores máximos permitidos (versión preliminar).

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-stages.json