Propagar recursos de um cluster de hub do Gerenciador de Frota de Kubernetes do Azure para clusters membros

Artigo
01/08/2025

Este artigo descreve como propagar recursos de um cluster de hub do Gerenciador de Frota de Kubernetes do Azure (Frota de Kubernetes) para clusters membros.

Pré-requisitos

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
Leia a visão geral conceitual da propagação de recurso para entender os conceitos e a terminologia usados neste artigo.
É necessário ter um recurso da Frota de Kubernetes com um cluster de hub e clusters membros. Caso não tenha um, confira Criar um recurso do Gerenciador de Frota de Kubernetes do Azure e ingressar em clusters membros usando a CLI do Azure.
Os clusters de membro devem ser rotulados adequadamente no cluster do hub para corresponder aos critérios de seleção desejados. Os rótulos de exemplo incluem região, ambiente, equipe, zonas de disponibilidade, disponibilidade de nó ou qualquer outra coisa que você queira.
Você precisa de acesso à API do Kubernetes do cluster de hub. Caso não tenha acesso, consulte Acessar a API do Kubernetes para um cluster de hub do Gerenciador de Frota de Kubernetes do Azure.

Usar a API de ClusterResourcePlacement para propagar recursos para clusters membros

O objeto da API ClusterResourcePlacement é criado no cluster de hub e é usado para propagar recursos para clusters membros. Ela especifica os recursos a serem propagados e a política de colocação a ser usada ao selecionar clusters membros. Este exemplo demonstra como propagar um namespace para clusters membros usando o objeto da API ClusterResourcePlacement com uma política de colocação PickAll.

Para obter mais informações, consulte a Colocação de recursos do Kubernetes do cluster de hub para os clusters membros e a documentação de código aberto da Frota de Kubernetes.

CLI do Azure
Portal do Azure

Criar um namespace para colocar nos clusters membros usando o comando kubectl create namespace. O exemplo a seguir cria um namespace chamado my-namespace:
```
kubectl create namespace my-namespace
```
Criar um objeto da API ClusterResourcePlacement no cluster de hub para propagar o namespace para os clusters membros e implantá-lo usando o comando kubectl apply -f. No exemplo a seguir, ClusterResourcePlacement cria um objeto chamado crp e usa o namespace my-namespace com uma política de colocação PickAll para propagar o namespace para todos os clusters membros:
```
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
```
Verifique o progresso da propagação de recursos usando o comando kubectl get clusterresourceplacement. O exemplo a seguir verifica o status do objeto ClusterResourcePlacement chamado crp:
```
kubectl get clusterresourceplacement crp
```
Seu resultado deve ser semelhante ao seguinte exemplo:
```
NAME   GEN   SCHEDULED   SCHEDULEDGEN   APPLIED   APPLIEDGEN   AGE
crp    2     True        2              True      2            10s
```

Exiba os detalhes do objeto crp usando o comando kubectl describe crp. O exemplo a seguir descreve o objeto ClusterResourcePlacement chamado crp:

kubectl describe clusterresourceplacement crp

Seu resultado deve ser semelhante ao seguinte exemplo:

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

No portal do Azure, acesse o recurso da Frota de Kubernetes.
No menu de serviço, em Recursos da Frota, selecione Colocações de recursos>Criar.

Substitua os valores de espaço reservado com o YAML a seguir e selecione Adicionar.

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

Verifique se a colocação do recurso de cluster foi criada com sucesso.
Para ver mais detalhes sobre a colocação de um recurso de cluster individual, selecione-a na lista.
Visualize detalhes adicionais sobre instantâneos, associações, trabalhos e instantâneos política de planejamento da colocação de recurso do cluster usando os guias individuais. Por exemplo, selecione a guia Instantâneos de recursos de cluster.

Caso não queira mais usar o objeto ClusterResourcePlacement, poderá excluí-lo usando o comando kubectl delete. O exemplo a seguir exclui o objeto ClusterResourcePlacement chamado crp:

kubectl delete clusterresourceplacement crp

Para saber mais sobre a propagação de recursos, confira os seguintes recursos:

Compartilhar via

Propagar recursos de um cluster de hub do Gerenciador de Frota de Kubernetes do Azure para clusters membros

Pré-requisitos

Usar a API de ClusterResourcePlacement para propagar recursos para clusters membros

Limpar os recursos

Recursos adicionais

Compartilhar via

Propagar recursos de um cluster de hub do Gerenciador de Frota de Kubernetes do Azure para clusters membros

Pré-requisitos

Usar a API de ClusterResourcePlacement para propagar recursos para clusters membros

Limpar os recursos

Conteúdo relacionado

Recursos adicionais