Šíření prostředků z clusteru centra Azure Kubernetes Fleet Manager do členských clusterů

Tento článek popisuje, jak rozšířit prostředky z clusteru centra Azure Kubernetes Fleet Manager (Kubernetes Fleet) do členských clusterů.

Požadavky

• Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.
• Přečtěte si koncepční přehled šíření prostředků a seznamte se s koncepty a terminologií používanými v tomto článku.
• Potřebujete prostředek Kubernetes Fleet s clusterem centra a členskými clustery. Pokud ho nemáte, přečtěte si téma Vytvoření prostředku Azure Kubernetes Fleet Manageru a připojení k členským clusterům pomocí Azure CLI.
• Členské clustery musí být v clusteru rozbočovačů označené odpovídajícím způsobem, aby odpovídaly požadovaným kritériím výběru. Mezi příklady popisků patří oblast, prostředí, tým, zóny dostupnosti, dostupnost uzlu nebo cokoli jiného, co chcete.
• Potřebujete přístup k rozhraní Kubernetes API clusteru centra. Pokud nemáte přístup, přečtěte si téma Přístup k rozhraní API Kubernetes pro cluster centra Azure Kubernetes Fleet Manager.

Použití rozhraní API ClusterResourcePlacement k rozšíření prostředků do členských clusterů

Objekt ClusterResourcePlacement rozhraní API se vytvoří v clusteru centra a slouží k šíření prostředků do členských clusterů. Určuje prostředky, které se mají rozšířit, a zásady umístění, které se mají použít při výběru členských clusterů. Tento příklad ukazuje, jak rozšířit obor názvů na členské clustery pomocí objektu ClusterResourcePlacement rozhraní API se PickAll zásadami umístění.

Další informace najdete v tématu Umístění prostředků Kubernetes z clusteru rozbočovače do členských clusterů a opensourcové dokumentace kubernetes Fleet.

Azure CLI

1. Pomocí příkazu vytvořte obor názvů, který se umístí do členských clusterů kubectl create namespace . Následující příklad vytvoří obor názvů s názvem my-namespace:

   kubectl create namespace my-namespace
   

2. Vytvořte ClusterResourcePlacement objekt rozhraní API v clusteru centra, který rozšíří obor názvů do členských clusterů a nasadí ho kubectl apply -f pomocí příkazu. V následujícím příkladu ClusterResourcePlacement vytvoří objekt s názvem crp a použije my-namespace obor názvů se zásadou PickAll umístění k rozšíření oboru názvů do všech členských clusterů:

   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
   

3. Pomocí příkazu zkontrolujte průběh šíření kubectl get clusterresourceplacement prostředku. Následující příklad zkontroluje stav objektu ClusterResourcePlacement s názvem crp:

   kubectl get clusterresourceplacement crp
   

   Výstup by měl vypadat podobně jako v následujícím příkladu:

   NAME   GEN   SCHEDULED   SCHEDULEDGEN   APPLIED   APPLIEDGEN   AGE
   crp    2     True        2              True      2            10s
   

4. Pomocí příkazu zobrazte podrobnosti crp objektu kubectl describe crp . Následující příklad popisuje ClusterResourcePlacement objekt s názvem crp:

   kubectl describe clusterresourceplacement crp
   

   Výstup by měl vypadat podobně jako v následujícím příkladu:

   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
   

Azure Portal

1. Na webu Azure Portal přejděte k prostředku Kubernetes Fleet.

2. V nabídce služby v části Prostředky vozového parku vyberte Umístění>prostředků Vytvořit.

3. Nahraďte zástupné hodnoty následujícím kódem YAML a pak vyberte Přidat.

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

4. Ověřte, že se umístění prostředků clusteru úspěšně vytvořilo.

   

5. Pokud chcete zobrazit další podrobnosti o umístění jednotlivých prostředků clusteru, vyberte ho ze seznamu.

   

6. Pomocí jednotlivých karet můžete zobrazit další podrobnosti o snímcích, vazbách, práci a plánování snímků zásad umístění prostředků clusteru. Vyberte například kartu Snímky prostředků clusteru .

   

Vyčištění prostředků

Azure CLI

Pokud už objekt nechcete používat ClusterResourcePlacement , můžete ho kubectl delete odstranit pomocí příkazu. Následující příklad odstraní ClusterResourcePlacement objekt s názvem crp:

kubectl delete clusterresourceplacement crp

Azure Portal

Pokud už nechcete používat umístění prostředků clusteru, můžete ho odstranit z webu Azure Portal:

1. V nabídce služby v části Prostředky flotily vyberte Umístění prostředků.
2. Vyberte objekty umístění prostředků clusteru, které chcete odstranit, a pak vyberte Odstranit.
3. Na kartě Odstranit ověřte, že jste zvolili správné objekty. Až budete připraveni, vyberte Potvrdit odstranění>.

Související obsah

Další informace o šíření prostředků najdete v následujících zdrojích informací:

• Inteligentní umístění prostředků Kubernetes mezi clustery na základě vlastností členských clusterů
• Opensourcová dokumentace ke službě Kubernetes Fleet