Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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
- Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.
- Läs den konceptuella översikten över resursplacering för att förstå begreppen och terminologin som används i den här artikeln.
- Du behöver en Fleet Manager med ett navkluster och medlemskluster. Om du inte har en kan du läsa Skapa en Azure Kubernetes Fleet Manager-resurs och ansluta till medlemskluster med hjälp av Azure CLI.
- Du behöver åtkomst till Kubernetes API för hubbklustret. Om du inte har åtkomst läser du Åtkomst till Kubernetes API för ett Azure Kubernetes Fleet Manager-hubbkluster.
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.
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>Ange standardprenumerationen Azure med kommandot [
az account set][az-account-set] :az account set \ --subscription ${SUBSCRIPTION_ID}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/configNote
Om du får ett fel av typen
InvalidHubOperationmed ett meddelande om att flottan saknar hubb, lägger du till ett hubbkluster. Mer information finns i Uppgradera hubbklustertyp.Skapa ett namnområde i hubbklustret.
kubectl create namespace test-appSpara 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: LoadBalancerDistribuera testarbetsbelastningen till Fleet Managers hubbkluster med
kubectl.kubectl apply -f test-workload.yamlSpara 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: PickAllTillämpa placeringsmanifestet på Fleet Manager-hubbklustret.
kubectl apply -f crp-distribute-workload.yamlNote
Utrullningen av resursen börjar så snart manifestet har tillämpats. En implicit
RollingUpdatestrategi används. Mer information om hur du har ytterligare kontroll över distributionen finns i definiera en distributionsstrategi för resursplacering.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
- 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
Gå till din Fleet Manager i Azure-portalen.
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.
På menyn väljer du Namnområde, anger ett Namn och väljer sedan Skapa.
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.
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: 80apiVersion: v1 kind: Service metadata: name: nginx-service namespace: test-app spec: selector: app: nginx ports: - protocol: TCP port: 80 targetPort: 80 type: LoadBalancerKopiera och klistra in exemplen och tillämpa dem en i taget enligt följande bild.
Namnområdet och dess arbetsbelastningar är nu redo att distribueras till medlemskluster. Distributionen och tjänsten är inte schemalagda i Fleet Manager-hubbklustret.
På tjänstmenyn går du till Fleet Resources och väljer Resursplaceringar>+ Skapa.
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-appI Val av medlemskluster väljer du Alla kluster för Placeringstyp.
För utrullning låter du strategin Rullande uppdatering vara vald.
Välj Nästa för att granska det resulterande
ClusterResourcePlacementmanifestet. 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.Välj Skapa för att starta fördelningen av namnområdet omedelbart.
Note
Resursdistributionen börjar omedelbart när du tillämpar resursplaceringen med hjälp av den valda
RollingUpdatestrategin. Mer information om hur du har ytterligare kontroller över distributionen finns i definiera en distributionsstrategi för resursplacering.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.
Visa placeringens utrullningsstatus genom att välja placeringens namn i listan. Välj enskilda kluster för att visa resursdistributionen i klustret.
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
På tjänstmenyn går du till Fleet Resources och väljer Resursplaceringar.
I listan med resursplaceringar väljer du placeringen och väljer Ta bort.
På Ta bort kontrollerar du att du har valt rätt placering. När du är klar väljer du Bekräfta borttagning>.
Sidan uppdateras och placeringen visas inte längre i listan. Resurserna tas bort från medlemskluster.
Relaterat innehåll
Mer information om resursplacering finns i följande resurser:
- Distribuera namnområdesomfångsbegränsade resurser i flera kluster
- Förstå utdata för resursplaceringsstatus.
- Intelligent kubernetes-resursplacering mellan kluster baserat på medlemsklusters egenskaper.
- Kontroll av utestängning och störningar vid placering av klusterresurser.
- Definiera en distributionsstrategi för en klusterresursplacering.
- Vanliga frågor och svar om placering av klusterresurser.
- Dokumentation om KubeFleet ClusterResourcePlacement med öppen källkod.