Schnellstart: Verteilen von Ressourcen aus einem Azure Kubernetes Fleet Manager (Fleet)-Hubcluster an Membercluster

In dieser Schnellstartanleitung erfahren Sie, wie Sie Ressourcen aus einem Azure Kubernetes Fleet Manager (Fleet)-Hubcluster an Membercluster verteilen.

Voraussetzungen

Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.

• Lesen Sie die konzeptionelle Übersicht über die Ressourcenverteilung, um die in dieser Schnellstartanleitung verwendeten Konzepte und Terminologie zu verstehen.
• Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
• Sie müssen über eine Fleet-Ressource mit einem Hubcluster und Mitgliedsclustern verfügen. Wenn Sie keins haben, lesen Sie Erstellen einer Azure Kubernetes Fleet Manager-Ressource und Einbinden von Mitgliedsclustern mithilfe der Azure CLI.
• Member-Cluster müssen entsprechend im Hub-Cluster beschriftet werden, um den gewünschten Auswahlkriterien zu entsprechen. Beispielbezeichnungen umfassen Region, Umgebung, Team, Verfügbarkeitszonen, Knotenverfügbarkeit oder andere gewünschte Elemente.
• Sie benötigen Zugriff auf die Kubernetes-API des Hubclusters. Wenn Sie keinen Zugriff haben, lesen Sie Zugreifen auf die Kubernetes-API der Fleet-Ressource mit Azure Kubernetes Fleet Manager.

Verwenden der ClusterResourcePlacement-API zum Verteilen von Ressourcen an Membercluster

Das ClusterResourcePlacement-API-Objekt wird verwendet, um Ressourcen aus einem Hubcluster an Membercluster zu verteilen. Das ClusterResourcePlacement-API-Objekt gibt die Ressourcen an, die weitergegeben werden sollen, und die Platzierungsrichtlinie, die beim Auswählen von Memberclustern verwendet werden soll. Das ClusterResourcePlacement-API-Objekt wird im Hubcluster erstellt und wird verwendet, um Ressourcen an Membercluster zu verteilen. In diesem Beispiel wird veranschaulicht, wie ein Namespace mithilfe des ClusterResourcePlacement-API-Objekts mit einer PickAll-Platzierungsrichtlinie an Membercluster verteilt wird.

Weitere Informationen finden Sie in Kubernetes-Ressourcenverteilung von Hubclustern zu Mitgliedsclustern und der Open-Source-Fleet-Dokumentation.

Azure-Befehlszeilenschnittstelle

1. Erstellen Sie einen Namespace, der mithilfe des kubectl create namespace-Befehls in den Memberclustern platziert werden soll. Im folgenden Beispiel wird ein Namespace mit dem Namen my-namespace erstellt:

   kubectl create namespace my-namespace
   

2. Erstellen Sie ein ClusterResourcePlacement-API-Objekt im Hubcluster, um den Namespace an die Membercluster zu verteilen und mithilfe des kubectl apply -f-Befehls bereitzustellen. Das folgende Beispiel ClusterResourcePlacement erstellt ein Objekt namens crp und verwendet den my-namespace-Namespace mit einer PickAll-Platzierungsrichtlinie, um den Namespace an alle Membercluster zu verteilen:

   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. Überprüfen Sie den Fortschritt der Ressourcenverteilung mithilfe des kubectl get clusterresourceplacement-Befehls. Im folgenden Beispiel wird der Status des ClusterResourcePlacement-Objekts namens crp überprüft:

   kubectl get clusterresourceplacement crp
   

   Ihre Ausgabe sollte in etwa dem folgendem Beispiel entsprechen:

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

4. Zeigen Sie die Details des crp-Objekts mithilfe des kubectl describe crp-Befehls an. Im folgenden Beispiel wird das ClusterResourcePlacement-Objekt namens crpbeschrieben:

   kubectl describe clusterresourceplacement crp
   

   Ihre Ausgabe sollte in etwa dem folgendem Beispiel entsprechen:

   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. Navigieren Sie im Azure-Portal zu der Fleet-Ressource.

2. Wählen Sie im Dienstmenü unter Fleet Resources Ressourcenplatzierungen>Erstellen aus.

3. Ersetzen Sie die Platzhalterwerte durch den folgenden YAML-Code, und wählen Sie dann Hinzufügen aus.

   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. Bestätigen Sie, dass die Clusterressourcenplatzierung erfolgreich erstellt wurde.

   

5. Wenn Sie weitere Details zu einer einzelnen Clusterressourcenplatzierung anzeigen möchten, wählen Sie sie aus der Liste aus.

   

6. Mithilfe der einzelnen Registerkarten können Sie zusätzliche Details zu den Momentaufnahmen, Bindungen, Arbeiten und Momentaufnahmen von Planungsrichtlinien für die Clusterressourcenplatzierung anzeigen. Wählen Sie z. B. die Registerkarte Clusterressourcenmomentaufnahmen aus.

   

Bereinigen von Ressourcen

Azure-Befehlszeilenschnittstelle

Wenn Sie das ClusterResourcePlacement-Objekt nicht mehr verwenden möchten, können Sie es mit dem kubectl delete-Befehl löschen. Im folgenden Beispiel wird das ClusterResourcePlacement-Objekt namens crp gelöscht:

kubectl delete clusterresourceplacement crp

Azure portal

Wenn Sie Ihre Clusterressourcenplatzierung nicht mehr verwenden möchten, können Sie sie aus dem Azure-Portal löschen:

1. Wählen Sie im Dienstmenü unter Fleet Resources Ressourcenplatzierungen aus.
2. Wählen Sie die Objekte der Clusterressourcenplatzierung aus, die Sie löschen möchten, und wählen Sie dann Löschen aus.
3. Überprüfen Sie auf der Registerkarte Löschen, ob die richtigen Objekte ausgewählt sind. Nachdem Sie fertig sind, wählen Sie Löschen bestätigen>Löschen aus.

Nächste Schritte

Weitere Informationen zur Ressourcenverteilung finden Sie in den folgenden Artikeln:

• Intelligente clusterübergreifende Kubernetes-Ressourcenplatzierung basierend auf Mitgliedsclustereigenschaften
• Open-Source-Fleet-Dokumentation