Use ejecuciones de implementación por fases para controlar las ubicaciones de recursos de Azure Kubernetes Fleet Manager

• Establezca estas variables de entorno:

  export SUBSCRIPTION_ID=<subscription>
  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export MEMBER_CLUSTER_1=aks-member-1
  export MEMBER_CLUSTER_2=aks-member-2
  

• Necesita CLI de Azure instalado para completar este artículo. Para instalar o actualizar, consulte Instalar el CLI de Azure.

• Usted necesita la CLI de Azure extensión fleet. Puede instalarlo ejecutando el 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:

  az extension update --name fleet
  

• Si aún no la tiene instalada, puede instalar la CLI de Kubernetes (kubectl) mediante este comando:

  az aks install-cli
  

Aplique etiquetas a los clústeres de miembros mediante el comando siguiente.

az fleet member update \
    --resource-group ${GROUP} \
    --fleet-name ${FLEET} \
    --name ${MEMBER_CLUSTER_1} \
    --labels environment=canary

az fleet member update \
    --resource-group ${GROUP} \
    --fleet-name ${FLEET} \
    --name ${MEMBER_CLUSTER_2} \
    --labels environment=staging

1. En el portal de Azure, vaya a Fleet Manager.

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

3. En la lista de clústeres miembro, seleccione un clúster. A continuación, elija Editar etiquetas en el menú de acciones.

4. Agregue la etiqueta adecuada al clúster de miembros y, a continuación, seleccione Aplicar.

5. Repita la repetición para cada clúster miembro.

   

1. Obtenga el archivo kubeconfig del clúster del centro de Kubernetes Fleet mediante el comando az fleet get-credentials:

   az fleet get-credentials \
       --resource-group ${GROUP} \
       --name ${FLEET}
   

   La salida debe tener un aspecto similar a lo siguiente.

   Merged "hub" as current context in /home/fleet/.kube/config
   

   Note

   Si recibe un error de tipo InvalidHubOperation con un mensaje que indica que la flota no tiene concentrador, añada un clúster de concentrador. Para más información, consulte tipo de clúster del hub de actualización.

2. Crear un espacio de nombres en el clúster del centro del administrador de flota.

   kubectl create namespace test-app
   

3. Guarde el siguiente código YAML como test-workload.yaml.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
     namespace: test-app
   spec:
     selector:
       matchLabels:
         app: nginx
     replicas: 2
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: mcr.microsoft.com/azurelinux/base/nginx:1.28@sha256:3352a36cbcab4708883a3e77b64f64159e11e1aab358c010e1c4e465dbfb4f57
           ports:
           - containerPort: 80
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-service
     namespace: test-app
   spec:
     selector:
       app: nginx
     ports:
     - protocol: TCP
       port: 80
       targetPort: 80
     type: LoadBalancer
   

4. Prepare la carga de trabajo de prueba en el clúster hub de Fleet Manager usando kubectl.

   kubectl apply -f test-workload.yaml
   

1. En el portal de Azure, vaya a Fleet Manager.

2. En el menú servicio, en Recursos de flota, seleccione Espacios de nombres>+ Crear.

   Note

   Si no ve Recursos de flota, su Fleet Manager no tiene un clúster central. Para obtener más información sobre cómo agregar una, consulte upgrade hub cluster type (Tipo de clúster del centro de actualización).

3. En el menú, seleccione Espacio de nombres, escriba un nombre y, a continuación, seleccione Crear.

   

   Después de unos instantes, la página se actualiza y el espacio de nombres aparece en la lista de espacios de nombres del clúster concentrador de Fleet Manager. Ahora está listo para hospedar los recursos que quiera distribuir entre clústeres de miembros.

4. En la parte superior de la lista de espacios de nombres, seleccione + Crear>Aplicar un YAML y use los siguientes ejemplos.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
     namespace: test-app
   spec:
     selector:
       matchLabels:
         app: nginx
     replicas: 2
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: mcr.microsoft.com/azurelinux/base/nginx:1.28@sha256:3352a36cbcab4708883a3e77b64f64159e11e1aab358c010e1c4e465dbfb4f57
           ports:
           - containerPort: 80
   

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-service
     namespace: test-app
   spec:
     selector:
       app: nginx
     ports:
     - protocol: TCP
       port: 80
       targetPort: 80
     type: LoadBalancer
   

   Copie y pegue los ejemplos y aplíquelos uno a uno como se muestra en la siguiente imagen.

   

   El espacio de nombres y sus cargas de trabajo ya están listos para distribuirse a los clústeres miembro. La implementación y el servicio no están programados en el clúster del centro de Fleet Manager.

1. Guarde el siguiente código YAML como crp-two-stages-strategy.yaml.

   apiVersion: placement.kubernetes-fleet.io/v1
   kind: ClusterStagedUpdateStrategy
   metadata:
     name: two-stages-strategy
   spec:
     stages:
       - name: staging
         labelSelector:
           matchLabels:
             environment: staging
         afterStageTasks:
           - type: TimedWait
             waitTime: 4m
       - name: canary
         labelSelector:
           matchLabels:
             environment: canary
         beforeStageTasks:
           - type: Approval
   

2. Aplique el manifiesto de estrategia al clúster del centro de Fleet Manager.

   kubectl apply -f crp-two-stages-strategy.yaml
   

3. Compruebe el estado del recurso de estrategia.

   kubectl get clusterstagedupdatestrategy two-stages-strategy
   

   La salida debe tener un aspecto similar a lo siguiente.

   NAME                  AGE
   two-stages-strategy   47m
   

Use el siguiente proceso para crear una estrategia que contenga las dos fases Staging y Canary con un tiempo de espera de 4 minutos y una aprobación previa para la Canary fase.

1. En el portal de Azure, vaya a Fleet Manager.

2. En el menú de servicio, en Recursos de flota, seleccione Ubicaciones de recursos>Estrategias de lanzamiento preconfigurado y, a continuación, Crear.

3. Escriba un nombre para la estrategia.

4. Seleccione el ámbito de la estrategia y elija entre de ámbito de clúster o de ámbito de espacio de nombres.

   • En Espacio de nombres con ámbito, seleccione el espacio de nombres existente en el clúster del centro de Fleet Manager donde se almacenan provisionalmente los recursos de Kubernetes que se van a distribuir.

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.
   • (Opcional) Espere después de la fase : seleccione esta opción si desea definir una pausa antes de pasar a la siguiente fase.
   • (Opcional) Duración de espera: seleccione una duración predefinida o escriba un valor personalizado en segundos.
   • Selector de etiquetas de clúster: elija una etiqueta de clúster miembro existente que se usará para seleccionar clústeres para esta fase.
   • (Opcional) Etiqueta de ordenación de clústeres: elija una etiqueta de clúster miembro existente que se usará para ordenar los clústeres dentro de la fase.
   • (Opcional) Simultaneidad de fases: establezca el número de clústeres que se deben actualizar simultáneamente en la fase actual.

   

   Note

   El número máximo de fases de cada estrategia es 31.

6. Repita hasta que se agreguen todas las fases a la estrategia. Seleccione Crear para crear la estrategia.

   

7. La página se actualiza y la lista muestra la estrategia recién creada.

   

1. Guarde el siguiente código YAML como crp-distribute-workload-ext.yaml.

   apiVersion: placement.kubernetes-fleet.io/v1
   kind: ClusterResourcePlacement
   metadata:
     name: distribute-test-app
   spec:
     resourceSelectors:
       - group: ""
         kind: Namespace
         version: v1          
         name: test-app
     policy:
       placementType: PickAll
     strategy:
       type: External
   

   Importante

   Si no establece el tipo de strategy en External, la implementación de recursos comienza en cuanto aplique el manifiesto mediante una estrategia RollingUpdate.

2. Aplique el manifiesto de ubicación al clúster central de Fleet Manager.

   kubectl apply -f crp-distribute-workload-ext.yaml
   

3. Compruebe el estado de la ubicación del recurso.

   kubectl get clusterresourceplacement distribute-test-app
   

   La salida debe tener un aspecto similar a lo siguiente.

   NAME                  GEN   SCHEDULED   SCHEDULED-GEN   AVAILABLE   AVAILABLE-GEN   AGE
   distribute-test-app   1     True        1                                           60s
   

1. En el portal de Azure, vaya a Fleet Manager.

2. En el menú servicio, en Recursos de flota, seleccione Ubicación de recursos>+ Crear.

3. En la pestaña Información básica, configure las siguientes opciones:

   • En Detalles de la ubicación, introduzca un nombre para la ubicación.

   • En Detalles del recurso, deje Ámbito como Ámbito de clúster y escriba el Tipo de versión de grupo (GVK) y el nombre del recurso que se va a distribuir. En este ejemplo, use los valores siguientes.

     group: ""
     kind: Namespace
     version: v1          
     name: test-app
     

   • En Selección de clúster miembro, en Tipo de selección de ubicación , elija Todos los clústeres.

   • En Implementación, seleccione Externo. Use la estrategia de actualización por fases para seleccionar la estrategia de despliegue que creó anteriormente.

   • Deje desactivada la casilla Iniciar lanzamiento automáticamente .

   

4. Seleccione Siguiente para revisar el manifiesto resultante ClusterResourcePlacement . Puede modificar el manifiesto si es necesario, validar mediante la opción Validar (ejecución seca) o seleccionar Revisar y crear para continuar con la confirmación final.

   

5. Seleccione Crear para crear la ejecución de la implementación sin iniciarla.

   

6. La página se actualiza y la lista Ubicaciones de recursos muestra la ubicación recién creada. Muestra el número de clústeres seleccionados y si el planificador de flotas puede cumplir la política de ubicación. Observe que el tipo de lanzamiento está establecido en Externo.

   

Cuando usas el portal de Azure para crear una asignación con una estrategia de implementación, se crea automáticamente una ejecución de implementación por fases para ti.

Usa una implementación gradual para controlar la distribución

En este artículo, creas la implementación por fases con un state de Initialize para que puedas iniciar la implementación cuando quieras, en lugar de que la ejecución se inicie inmediatamente al aplicar el manifiesto. Establezca el estado en Run para iniciarse inmediatamente.

1. Guarde el siguiente código YAML como staged-rollout-test-app.yaml.

   apiVersion: placement.kubernetes-fleet.io/v1
   kind: ClusterStagedUpdateRun
   metadata:
     name: staged-rollout-test-app
   spec:
     placementName: distribute-test-app
     stagedRolloutStrategyName: two-stages-strategy
     state: Initialize
   

   Note

   Si no establece el tipo de strategy en External, la implementación de recursos comienza en cuanto aplique el manifiesto mediante una estrategia RollingUpdate.

2. Aplique el manifiesto de despliegue por fases al clúster central de Fleet Manager.

   kubectl apply -f staged-rollout-test-app.yaml
   

3. Compruebe el estado del recurso de ejecución del despliegue. Se inicializa pero no progresa.

   kubectl get clusterstagedupdaterun staged-rollout-test-app
   

   La salida debe tener un aspecto similar a lo siguiente.

   NAME                      PLACEMENT             RESOURCE-SNAPSHOT-INDEX   POLICY-SNAPSHOT-INDEX   INITIALIZED   PROGRESSING   SUCCEEDED   AGE
   staged-rollout-test-app   distribute-test-app                             0                       True                                    101s
   

Para iniciar un despliegue por fases, modifique el campo state de la especificación a Run.

kubectl patch clusterstagedupdaterun staged-rollout-test-app --type merge -p '{"spec":{"state":"Run"}}'

Compruebe el estado del recurso de ejecución del despliegue. Se inicializa pero no progresa.

kubectl get clusterstagedupdaterun staged-rollout-test-app

La salida debe ser similar a la siguiente, teniendo en cuenta que el progreso es ahora True.

NAME                      PLACEMENT             RESOURCE-SNAPSHOT-INDEX   POLICY-SNAPSHOT-INDEX   INITIALIZED   PROGRESSING   SUCCEEDED   AGE
staged-rollout-test-app   distribute-test-app                             0                       True          True                      36m

Vea el estado detallado de la implementación describiendo el ClusterStagedUpdateRun.

kubectl describe clusterstagedupdaterun staged-rollout-test-app

En la respuesta, revise Status, observando Conditions y Stages Status para comprender qué fase y clúster se están procesando actualmente, o si hay una tarea TimedWait o Approval activa en este momento.

Name:         staged-rollout-test-app
Namespace:
Labels:       <none>
Annotations:  <none>
API Version:  placement.kubernetes-fleet.io/v1
Kind:         ClusterStagedUpdateRun
Metadata:
  Creation Timestamp:  2026-07-27T04:25:14Z
  Finalizers:
    kubernetes-fleet.io/stagedupdaterun-finalizer
  Generation:        3
  Resource Version:  2684410
  UID:               5e20d0a1-515a-4f1c-b566-89676100a968
Spec:
  Placement Name:                distribute-test-app
  Resource Snapshot Index:
  Staged Rollout Strategy Name:  two-stages-strategy
  State:                         Run
Status:
  Applied Strategy:
    Comparison Option:  PartialComparison
    Type:               ClientSideApply
    When To Apply:      Always
    When To Take Over:  Always
  Conditions:
    Last Transition Time:  2026-07-27T04:25:14Z
    Message:               The UpdateRun initialized successfully
    Observed Generation:   3
    Reason:                UpdateRunInitializedSuccessfully
    Status:                True
    Type:                  Initialized
    Last Transition Time:  2026-07-27T05:01:56Z
    Message:               The update run is making progress
    Observed Generation:   3
    Reason:                UpdateRunProgressing
    Status:                True
    Type:                  Progressing
  Deletion Stage Status:
    Clusters:
    Stage Name:                   kubernetes-fleet.io/deleteStage
  Policy Observed Cluster Count:  2
  Policy Snapshot Index Used:     0
  Resource Snapshot Index Used:   0
  Staged Update Strategy Snapshot:
    Stages:
      After Stage Tasks:
        Type:       TimedWait
        Wait Time:  1h0m0s
      Label Selector:
        Match Labels:
          Environment:  staging
      Max Concurrency:  1
      Name:             staging
      Before Stage Tasks:
        Type:  Approval
      Label Selector:
        Match Labels:
          Environment:  canary
      Max Concurrency:  1
      Name:             canary
  Stages Status:
    After Stage Task Status:
      Type:  TimedWait
    Clusters:
      Cluster Name:  aks-place-member-02-fm
      Conditions:
        Last Transition Time:  2026-07-27T05:01:56Z
        Message:               Cluster update started
        Observed Generation:   3
        Reason:                ClusterUpdatingStarted
        Status:                True
        Type:                  Started
    Conditions:
      Last Transition Time:  2026-07-27T05:01:56Z
      Message:               Clusters in the stage started updating
      Observed Generation:   3
      Reason:                StageUpdatingStarted
      Status:                True
      Type:                  Progressing
    Stage Name:              staging
    Start Time:              2026-07-27T05:01:56Z
    Before Stage Task Status:
      Approval Request Name:  staged-rollout-test-app-before-canary
      Type:                   Approval
    Clusters:
      Cluster Name:  aks-place-member-01-fm
    Stage Name:      canary
Events:              <none>

1. En el portal de Azure, vaya a Fleet Manager.

2. En el menú de servicio, en la sección Recursos de flota, seleccione Ejecuciones de implementación gradual.

3. En la lista, seleccione la ejecución de lanzamiento preconfigurada que se creó automáticamente en el paso anterior y, a continuación, seleccione Iniciar en el menú de acciones.

   

4. La página se actualiza y la lista de ejecuciones de implementación por fases muestra la ejecución de implementación por fases con el estado Progressing, y se muestra la fase que se está ejecutando actualmente.

   

5. Cuando el despliegue alcanza un TimedWait, el estado cambia a En espera. Puede colocar el cursor sobre el icono de información para confirmar que este estado se debe a TimedWait.

   

Para detener un despliegue gradual en ejecución, aplique un parche al campo state de spec para establecerlo en Stop. Esta acción detiene de forma ordenada la ejecución de la implementación gradual, de modo que los clústeres con actualizaciones en curso terminen sus actualizaciones antes de que se detenga el proceso.

kubectl patch clusterstagedupdaterun staged-rollout-test-app --type merge -p '{"spec":{"state":"Stop"}}'

La ejecución de la actualización por etapas se ha inicializado, pero ya no está en ejecución.

kubectl get clusterstagedupdaterun staged-rollout-test-app

La salida debe tener un aspecto similar al siguiente, teniendo en cuenta que progressing ahora Falsees .

NAME                      PLACEMENT             RESOURCE-SNAPSHOT-INDEX   POLICY-SNAPSHOT-INDEX   INITIALIZED   PROGRESSING   SUCCEEDED   AGE
staged-rollout-test-app   distribute-test-app                             0                       True          False                     46m

Para detener una implementación por fases en curso, siga estos pasos. Esta acción detiene de forma ordenada la implementación por fases, de modo que los clústeres en proceso completen sus actualizaciones antes de que se detenga el proceso.

1. En el portal de Azure, vaya a Fleet Manager.

2. En el menú de servicio, en la sección Recursos de flota, seleccione Ejecuciones de implementación gradual.

3. En la lista, seleccione la ejecución de lanzamiento preconfigurada que desea detener. A continuación, elija Detener en el menú de acciones.

   

4. La página se actualiza y la lista de ejecuciones de lanzamiento preconfigurado muestra la ejecución de lanzamiento preconfigurada con el estado Detenido.

   

Cuando una ejecución de lanzamiento preconfigurada alcanza una aprobación, crea una solicitud de aprobación (ClusterApprovalRequest o ApprovalRequest). Debe aplicar un parche a esta solicitud. Después de aplicarle el parche, la ejecución del despliegue continúa.

Compruebe si hay aprobaciones pendientes mediante los siguientes comandos.

kubectl get clusterapprovalrequest

Al comprobar si hay recursos pendientes ApprovalRequest , asegúrese de proporcionar el espacio de nombres en el que residen los recursos.

kubectl get clusterapprovalrequest -n test-app

Si recibe una respuesta de No resources found, actualmente no hay aprobaciones de ámbito de clúster pendientes.

Si hay aprobaciones pendientes, la respuesta debe ser similar al ejemplo siguiente.

NAME                                    UPDATE-RUN                STAGE    APPROVED   AGE
staged-rollout-test-app-before-canary   staged-rollout-test-app   canary              4m13s

Puede aprobar el ClusterApprovalRequest creando un archivo de parche JSON y aplicándolo.

cat << EOF > approval.json
"status": {
    "conditions": [
        {
            "lastTransitionTime": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
            "message": "lgtm",
            "observedGeneration": 1,
            "reason": "testPassed",
            "status": "True",
            "type": "Approved"
        }
    ]
}
EOF

Envíe una solicitud de revisión para aprobar la solicitud mediante el archivo JSON que creó.

kubectl patch clusterapprovalrequests staged-rollout-test-app-before-canary --type='merge' --subresource=status --patch-file approval.json

Compruebe que la aprobación se aplicó a la solicitud.

kubectl get clusterapprovalrequest staged-rollout-test-app-before-canary

La salida debe tener un aspecto similar a lo siguiente. Tenga en cuenta que APPROVED está establecido en True.

NAME                                    UPDATE-RUN                STAGE    APPROVED   AGE
staged-rollout-test-app-before-canary   staged-rollout-test-app   canary   True       6m

La ejecución del despliegue continúa.

kubectl get clusterstagedupdaterun staged-rollout-test-app

La salida debe ser similar a la siguiente, que muestra una ejecución completada con SUCCEEDED establecida en True.

NAME                      PLACEMENT             RESOURCE-SNAPSHOT-INDEX   POLICY-SNAPSHOT-INDEX   INITIALIZED   PROGRESSING   SUCCEEDED   AGE
staged-rollout-test-app   distribute-test-app                             0                       True          False         True        9m

Cuando una ejecución de implementación por fases llega a un paso de aprobación, use el siguiente proceso para resolver la aprobación y permitir que la ejecución continúe.

1. En el portal de Azure, vaya a Fleet Manager.

2. En el menú de servicio, en la sección Recursos de flota, seleccione Ejecuciones de implementación gradual.

3. En la lista, busque la ejecución de lanzamiento preconfigurada que tiene un estado de Aprobación pendiente.

   

4. Puede abrir el cuadro de diálogo de aprobación desde cualquiera de las tres ubicaciones:

   • Integrado en la vista de lista de ejecuciones de la implementación gradual (mostrada anteriormente).
   • Desde la vista de detalles de la ejecución de la implementación por fases:
     • En el campo State de la sección Datos esenciales.
     • Integrado en la vista Escenario.

   

5. Seleccione una opción para abrir el cuadro de diálogo Aprobación . Escriba un mensaje opcional y elija Aprobar.

   

6. La página se actualiza y la lista de ejecuciones de implementación gradual muestra la ejecución de implementación gradual con el estado En curso.

   

7. La ejecución de implementación gradual continúa hasta que finaliza, y la lista Ejecuciones de implementación gradual muestra la ejecución de implementación gradual con el estado Correcto.

   

Elimine un despliegue por fases eliminando el recurso de Kubernetes en el clúster central de Fleet Manager.

kubectl delete clusterstagedupdaterun staged-rollout-test-app

1. En el portal de Azure, vaya a Fleet Manager.

2. En el menú de servicio, en la sección Recursos de flota, seleccione Ejecuciones de implementación gradual.

3. En la lista, seleccione la ejecución de lanzamiento preconfigurada para eliminar y, a continuación, elija Eliminar en el menú de acciones.

4. En el cuadro de diálogo Eliminar , confirme que el recurso es correcto y, a continuación, seleccione Confirmar eliminación. Por último, elija Eliminar.

   

5. La página se vuelve a cargar y la ejecución eliminada de la implementación gradual ya no aparece.