Propagación de recursos de un clúster central de Azure Kubernetes Fleet Manager a clústeres miembros

Artículo
01/10/2025

En este artículo se proporciona información general sobre cómo propagar recursos de un clúster central de Azure Kubernetes Fleet Manager (Kubernetes Fleet) a clústeres miembros.

Requisitos previos

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Lea la introducción conceptual de la propagación de recursos para comprender los conceptos y la terminología que se usan en este artículo.
Necesita un recurso de Kubernetes Fleet con un clúster central y clústeres miembros. Si no tiene ninguno, consulte Creación de un recurso de Azure Kubernetes Fleet Manager y unión a clústeres miembros mediante la CLI de Azure.
Los clústeres miembro deben etiquetarse correctamente en el clúster de centro para que coincidan con los criterios de selección deseados. En las etiquetas de ejemplo, se incluyen las de región, entorno, equipo, zonas de disponibilidad, disponibilidad del nodo o cualquier otra que se quiera.
Necesita acceso a la API de Kubernetes del clúster de centros. Si no tiene acceso, consulte Acceso a la API de Kubernetes para un clúster central de Azure Kubernetes Fleet Manager.

Uso de la API ClusterResourcePlacement para propagar recursos a clústeres miembros

El objeto de API ClusterResourcePlacement se crea en el clúster del concentrador y se usa para propagar recursos a clústeres de miembros. Especifica los recursos que se propagan y la directiva de colocación que se va a usar al seleccionar clústeres miembros. En este ejemplo se muestra cómo propagar un espacio de nombres a los clústeres de miembros mediante el objeto de API ClusterResourcePlacement con una directiva de colocación de PickAll.

Para más información, vea Ubicación de recursos de Kubernetes del clúster de concentrador a clústeres miembro y la documentación de Kubernetes Fleet de código abierto.

CLI de Azure
Azure Portal

Cree un espacio de nombres para colocarlo en los clústeres de miembros mediante el comando kubectl create namespace. En el ejemplo siguiente se crea un espacio de nombres denominado my-namespace:
```
kubectl create namespace my-namespace
```
Cree un objeto de API ClusterResourcePlacement en el clúster central para propagar el espacio de nombres a los clústeres de miembros e impleméntelo mediante el comando kubectl apply -f. En el ejemplo siguiente, ClusterResourcePlacement crea un objeto denominado crp y usa el espacio de nombres my-namespace con una directiva de selección de ubicación de PickAll para propagar el espacio de nombres a todos los clústeres de miembros:
```
kubectl apply -f - <<EOF
apiVersion: placement.kubernetes-fleet.io/v1
kind: ClusterResourcePlacement
metadata:
  name: crp
spec:
  resourceSelectors:
    - group: ""
      kind: Namespace
      version: v1          
      name: my-namespace
  policy:
    placementType: PickAll
EOF
```
Compruebe el progreso de la propagación de recursos mediante el comando kubectl get clusterresourceplacement. En el ejemplo siguiente se comprueba el estado del objeto ClusterResourcePlacement denominado crp:
```
kubectl get clusterresourceplacement crp
```
La salida debería similar al siguiente ejemplo:
```
NAME   GEN   SCHEDULED   SCHEDULEDGEN   APPLIED   APPLIEDGEN   AGE
crp    2     True        2              True      2            10s
```

Vea los detalles del objeto crp mediante el comando kubectl describe crp. En el ejemplo siguiente se describe el objeto ClusterResourcePlacement denominado crp:

kubectl describe clusterresourceplacement crp

La salida debería similar al siguiente ejemplo:

Name:         crp
Namespace:    
Labels:       <none>
Annotations:  <none>
API Version:  placement.kubernetes-fleet.io/v1
Kind:         ClusterResourcePlacement
Metadata:
  Creation Timestamp:  2024-04-01T18:55:31Z
  Finalizers:
    kubernetes-fleet.io/crp-cleanup
    kubernetes-fleet.io/scheduler-cleanup
  Generation:        2
  Resource Version:  6949
  UID:               815b1d81-61ae-4fb1-a2b1-06794be3f986
Spec:
  Policy:
    Placement Type:  PickAll
  Resource Selectors:
    Group:                 
    Kind:                  Namespace
    Name:                  my-namespace
    Version:               v1
  Revision History Limit:  10
  Strategy:
    Type:  RollingUpdate
Status:
  Conditions:
    Last Transition Time:   2024-04-01T18:55:31Z
    Message:                found all the clusters needed as specified by the scheduling policy
    Observed Generation:    2
    Reason:                 SchedulingPolicyFulfilled
    Status:                 True
    Type:                   ClusterResourcePlacementScheduled
    Last Transition Time:   2024-04-01T18:55:36Z
    Message:                All 3 cluster(s) are synchronized to the latest resources on the hub cluster
    Observed Generation:    2
    Reason:                 SynchronizeSucceeded
    Status:                 True
    Type:                   ClusterResourcePlacementSynchronized
    Last Transition Time:   2024-04-01T18:55:36Z
    Message:                Successfully applied resources to 3 member clusters
    Observed Generation:    2
    Reason:                 ApplySucceeded
    Status:                 True
    Type:                   ClusterResourcePlacementApplied
  Observed Resource Index:  0
  Placement Statuses:
    Cluster Name:  membercluster1
    Conditions:
      Last Transition Time:  2024-04-01T18:55:31Z
      Message:               Successfully scheduled resources for placement in membercluster1 (affinity score: 0, topology spread score: 0): picked by scheduling policy
      Observed Generation:   2
      Reason:                ScheduleSucceeded
      Status:                True
      Type:                  ResourceScheduled
      Last Transition Time:  2024-04-01T18:55:36Z
      Message:               Successfully Synchronized work(s) for placement
      Observed Generation:   2
      Reason:                WorkSynchronizeSucceeded
      Status:                True
      Type:                  WorkSynchronized
      Last Transition Time:  2024-04-01T18:55:36Z
      Message:               Successfully applied resources
      Observed Generation:   2
      Reason:                ApplySucceeded
      Status:                True
      Type:                  ResourceApplied
    Cluster Name:            membercluster2
    Conditions:
      Last Transition Time:  2024-04-01T18:55:31Z
      Message:               Successfully scheduled resources for placement in membercluster2 (affinity score: 0, topology spread score: 0): picked by scheduling policy
      Observed Generation:   2
      Reason:                ScheduleSucceeded
      Status:                True
      Type:                  ResourceScheduled
      Last Transition Time:  2024-04-01T18:55:36Z
      Message:               Successfully Synchronized work(s) for placement
      Observed Generation:   2
      Reason:                WorkSynchronizeSucceeded
      Status:                True
      Type:                  WorkSynchronized
      Last Transition Time:  2024-04-01T18:55:36Z
      Message:               Successfully applied resources
      Observed Generation:   2
      Reason:                ApplySucceeded
      Status:                True
      Type:                  ResourceApplied
    Cluster Name:            membercluster3
    Conditions:
      Last Transition Time:  2024-04-01T18:55:31Z
      Message:               Successfully scheduled resources for placement in membercluster3 (affinity score: 0, topology spread score: 0): picked by scheduling policy
      Observed Generation:   2
      Reason:                ScheduleSucceeded
      Status:                True
      Type:                  ResourceScheduled
      Last Transition Time:  2024-04-01T18:55:36Z
      Message:               Successfully Synchronized work(s) for placement
      Observed Generation:   2
      Reason:                WorkSynchronizeSucceeded
      Status:                True
      Type:                  WorkSynchronized
      Last Transition Time:  2024-04-01T18:55:36Z
      Message:               Successfully applied resources
      Observed Generation:   2
      Reason:                ApplySucceeded
      Status:                True
      Type:                  ResourceApplied
  Selected Resources:
    Kind:     Namespace
    Name:     my-namespace
    Version:  v1
Events:
  Type    Reason                     Age   From                                   Message
  ----    ------                     ----  ----                                   -------
  Normal  PlacementScheduleSuccess   108s  cluster-resource-placement-controller  Successfully scheduled the placement
  Normal  PlacementSyncSuccess       103s  cluster-resource-placement-controller  Successfully synchronized the placement
  Normal  PlacementRolloutCompleted  103s  cluster-resource-placement-controller  Resources have been applied to the selected clusters

En Azure Portal, vaya al recurso de Kubernetes Fleet.
En el menú servicio, en Recursos de Fleet, seleccione Ubicaciones de recursos>Crear.

Reemplace los valores de marcador de posición por el código YAML siguiente y, después, seleccione Agregar.

apiVersion: placement.kubernetes-fleet.io/v1
kind: ClusterResourcePlacement
metadata:
  name: crp
spec:
  resourceSelectors:
    - group: ""
      kind: Namespace
      version: v1          
      name: my-namespace
  policy:
    placementType: PickAll

Compruebe que la colocación de recursos del clúster se creó correctamente.
Para ver más detalles sobre la colocación de un recurso de clúster individual, selecciónelo en la lista.
Puede ver detalles adicionales sobre las instantáneas, los enlaces, los trabajos y las instantáneas de directiva de programación de la colocación del clúster mediante las pestañas individuales. Por ejemplo, seleccione la pestaña Instantáneas de recursos de clúster.

Si ya no quiere usar el objeto ClusterResourcePlacement, puede eliminarlo mediante el comando kubectl delete. En el ejemplo siguiente se elimina el objeto ClusterResourcePlacement denominado crp:

kubectl delete clusterresourceplacement crp

Para más información sobre la propagación de recursos, consulte los siguientes recursos:

Compartir a través de

Propagación de recursos de un clúster central de Azure Kubernetes Fleet Manager a clústeres miembros

Requisitos previos

Uso de la API ClusterResourcePlacement para propagar recursos a clústeres miembros

Limpieza de recursos

Recursos adicionales

Compartir a través de

Propagación de recursos de un clúster central de Azure Kubernetes Fleet Manager a clústeres miembros

Requisitos previos

Uso de la API ClusterResourcePlacement para propagar recursos a clústeres miembros

Limpieza de recursos

Contenido relacionado

Recursos adicionales