Använd Azure Kubernetes Fleet Manager-resursplacering för att distribuera klusteromfattande resurser i flera kluster

Gäller för: ✔️ Fleet Manager med hubbkluster

Azure Med Kubernetes Fleet Manager-resursplacering kan du distribuera och synkronisera klusteromfattande resurser – inklusive namnområden och deras underordnade resurser – över flera kluster i din flotta. Den här funktionen förenklar distributioner av flera kluster genom att säkerställa konsekvent resurskonfiguration i infrastrukturen, minska manuella omkostnader och göra det möjligt för dig att hantera komplexa arbetsbelastningar i stor skala med en enda sanningskälla. Den här artikeln går igenom hur du använder ClusterResourcePlacement för att distribuera ett namnområde och dess arbetsbelastningar till medlemskluster.

Information om hur du distribuerar enskilda resurser i ett namnområde finns i dokumentationen om resursplacering med namnområdesomfång.

Du kan utföra stegen i den här artikeln med hjälp av antingen Azure-portalen eller Azure CLI.

Note

Du kan använda Fleet Managers resursplacering med AKS- och Azure Arc-aktiverade Kubernetes-kluster.

Innan du börjar

Distribuera ett namnområde och dess resurser till medlemskluster

Använd det enkla scenariot med att ha en Deployment och Service för att distribuera över alla kluster i flottan. Skapa ett namnområde i ditt Fleet Manager-hubbkluster, lägg till arbetsbelastningarna i det och använd sedan ett ClusterResourcePlacement för att distribuera namnområdet och allt dess innehåll till alla medlemskluster med hjälp PickAll av placeringsprincipen.

  1. Ange följande miljövariabler för ditt prenumerations-ID, resursgrupp och Kubernetes Fleet-resurs:

    export SUBSCRIPTION_ID=<subscription-id>
    export GROUP=<resource-group-name>
    export FLEET=<fleet-name>
    
  2. Ange standardprenumerationen Azure med kommandot [az account set][az-account-set] :

    az account set \
        --subscription ${SUBSCRIPTION_ID}
    
  3. Hämta kubeconfig-filen för Kubernetes Fleet Hub-klustret med hjälp av kommandot [az fleet get-credentials][az-fleet-get-credentials] :

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

    Dina utdata bör se ut ungefär så här.

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

    Note

    Om du får ett fel av typen InvalidHubOperation med ett meddelande om att flottan saknar hubb, lägger du till ett hubbkluster. Mer information finns i Uppgradera hubbklustertyp.

  4. Skapa ett namnområde i hubbklustret.

    kubectl create namespace test-app
    
  5. Spara följande YAML som 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
    
  6. Distribuera testarbetsbelastningen till Fleet Managers hubbkluster med kubectl.

    kubectl apply -f test-workload.yaml
    
  7. Spara följande YAML som crp-distribute-workload.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
    
  8. Tillämpa placeringsmanifestet på Fleet Manager-hubbklustret.

    kubectl apply -f crp-distribute-workload.yaml
    

    Note

    Utrullningen av resursen börjar så snart manifestet har tillämpats. En implicit RollingUpdate strategi används. Mer information om hur du har ytterligare kontroll över distributionen finns i definiera en distributionsstrategi för resursplacering.

  9. Kontrollera statusen för resursplaceringen.

kubectl get clusterresourceplacement distribute-test-app

Din utdata bör likna det följande exemplet:

NAME                   GEN   SCHEDULED   SCHEDULEDGEN   APPLIED   APPLIEDGEN   AGE
distribute-test-app    2     True        2              True      2            10s
  1. Visa information om placeringen.
kubectl describe clusterresourceplacement distribute-test-app

Din utdata bör likna det följande exemplet:

Name:         distribute-test-app
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:                  test-app
    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
  1. Gå till din Fleet Manager i Azure-portalen.

  2. På tjänstmenyn går du till Fleet Resources och väljer Namnområden>+ Skapa.

    Note

    Om du inte ser Fleet Resources, har din Fleet Manager inget hubbkluster. Mer information om hur du lägger till en finns i Uppgradera hubbklustertyp.

  3. På menyn väljer du Namnområde, anger ett Namn och väljer sedan Skapa.

    Skärmbild av Azure-portalen som visar ett namnområde med namnet test-app som skapas i Fleet Manager-hubbklustret.

    Efter en liten stund uppdateras sidan och namnområdet visas i listan över namnområden i Fleet Manager-hubbklustret. Nu är den redo att vara värd för alla resurser som du vill distribuera mellan medlemskluster.

  4. Längst upp i namnområdeslistan väljer du + Skapa>Tillämpa en YAML och använder följande exempel.

    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
    

    Kopiera och klistra in exemplen och tillämpa dem en i taget enligt följande bild.

    Skärmbild av Azure-portalen som visar dialogrutan Tillämpa med YAML ifylld med en distribution som är redo att tillämpas på Fleet Manager-hubbklustret.

    Namnområdet och dess arbetsbelastningar är nu redo att distribueras till medlemskluster. Distributionen och tjänsten är inte schemalagda i Fleet Manager-hubbklustret.

  5. På tjänstmenyn går du till Fleet Resources och väljer Resursplaceringar>+ Skapa.

  6. På fliken Grundläggande konfigurerar du följande alternativ:

    • I Placeringsinformation anger du ett namn för placeringen.

    • Under Resursdetaljer låter du Omfattning vara Klusteromfattande och anger Group Version Kind (GVK) och namnet på resursen som ska distribueras. I det här exemplet använder du följande värden.

      group: ""
      kind: Namespace
      version: v1          
      name: test-app
      
    • I Val av medlemskluster väljer du Alla kluster för Placeringstyp.

    • För utrullning låter du strategin Rullande uppdatering vara vald.

    Skärmbild av Azure-portalen som visar fliken Slutförda grunder för resursplacering med klusteromfattning för ett namnområde med namnet test-app.

  7. Välj Nästa för att granska det resulterande ClusterResourcePlacement manifestet. Du kan ändra manifestet om det behövs, verifiera med alternativet Verifiera (torrkörning) eller välja Granska + skapa för att fortsätta till den slutliga bekräftelsen.

    Skärmbild av Azure-portalen som visar fliken Granska YAML med en lyckad validering vid en torrkörning för resursplacering på klusternivå för en namnrymd med namnet test-app.

  8. Välj Skapa för att starta fördelningen av namnområdet omedelbart.

    Skärmbild av Azure-portalen som visar fliken Granska och skapa för en resursplacering med klusteromfattning för ett namnområde med namnet test-app.

    Note

    Resursdistributionen börjar omedelbart när du tillämpar resursplaceringen med hjälp av den valda RollingUpdate strategin. Mer information om hur du har ytterligare kontroller över distributionen finns i definiera en distributionsstrategi för resursplacering.

  9. Sidan uppdateras och listan Resursplaceringar visar den nyligen skapade placeringen. Den visar antalet valda kluster och om schemaläggaren för flottan kan uppfylla placeringsprincipen.

    Skärmbild av Azure-portalen som visar listan över resursplaceringar med en enskild resursplacering som kallas distribuera-test-app.

  10. Visa placeringens utrullningsstatus genom att välja placeringens namn i listan. Välj enskilda kluster för att visa resursdistributionen i klustret.

    Skärmbild av Azure-portalen som visar detaljerad distributionsinformation för en resursplacering med namnet distribute-test-app.

I de valda Kubernetes-klustren hittar du namnrymden, distributionen och tjänsten distribuerad och i drift.

Ta bort placeringen om du vill ta bort resurserna

När du tar bort resursplaceringen i Fleet Manager-hubbklustret tar du bort de distribuerade resurserna från valda medlemskluster.

Om du vill ta bort distribuerade resurser utan att ta bort placeringen använder du PickFixed med en tom array clusterNames. Mer information finns i avsnittet PickFixed-placeringstyp.

kubectl delete clusterresourceplacement distribute-test-app
  1. På tjänstmenyn går du till Fleet Resources och väljer Resursplaceringar.

  2. I listan med resursplaceringar väljer du placeringen och väljer Ta bort.

  3. På Ta bort kontrollerar du att du har valt rätt placering. När du är klar väljer du Bekräfta borttagning>.

    Skärmbild av Azure-portalen som visar en resursplacering med namnet distribute-test-app som tas bort.

  4. Sidan uppdateras och placeringen visas inte längre i listan. Resurserna tas bort från medlemskluster.

Mer information om resursplacering finns i följande resurser: