Zrozumienie migawek dotyczących umieszczania zasobów w Azure Kubernetes Fleet Manager

Dotyczy: ✔️ Fleet Manager z klastrem hubów

Usługa Fleet Manager przechowuje historię 10 najnowszych zasad planowania rozmieszczenia, wraz z wybranymi wersjami zasobów. Przechowuje te zasady i wersje zasobów jako obiekty migawek:

  • W przypadku ClusterResourcePlacement (CRP): ClusterSchedulingPolicySnapshot i ClusterResourceSnapshot (obejmujący klaster)
  • Dla ResourcePlacement (RP): SchedulingPolicySnapshot i ResourceSnapshot (zakres przestrzeni nazw)

W tym artykule omawiamy te obiekty, aby móc je zrozumieć, jeśli chcesz z nimi pracować.

Uwaga

Jeśli nie znasz jeszcze rozmieszczania zasobów usługi Fleet Manager:

Jak tworzy się migawki zasobów

Każda zmiana zasobów objętych zakresem selektora zasobów CRP lub RP automatycznie wyzwala utworzenie nowej migawki zasobu w ciągu 60 sekund.

Wyświetlanie migawek zasobów

Migawki zasobów przechowywane przez usługę Fleet Manager można wyświetlić, wykonując następujące kroki po nawiązaniu połączenia z klastrem centrum Fleet Manager.

Wyświetlanie elementu ClusterResourceSnapshot (dla elementu ClusterResourcePlacement)

W przypadku umieszczeń o zakresie klastra, które używają ClusterResourcePlacement, wyświetl obiekty ClusterResourceSnapshot.

W tym przykładzie użyto zaktualizowanego obiektu ConfigMap, który tworzy dwie migawki.

kubectl get clusterresourcesnapshots --show-labels

Widzisz dwie migawki, a najnowsza jest oznaczona jako najnowsza (kubernetes-fleet.io/is-latest-snapshot=true) i ma indeks zasobów 1 (kubernetes-fleet.io/resource-index=1).

NAME                           GEN   AGE    LABELS
example-placement-0-snapshot   1     17m    kubernetes-fleet.io/is-latest-snapshot=false,kubernetes-fleet.io/parent-CRP=example-placement,kubernetes-fleet.io/resource-index=0
example-placement-1-snapshot   1     2m2s   kubernetes-fleet.io/is-latest-snapshot=true,kubernetes-fleet.io/parent-CRP=example-placement,kubernetes-fleet.io/resource-index=1

Zawartość obiektu można sprawdzić example-placement-1-snapshot w następujący sposób.

kubectl get clusterresourcesnapshots example-placement-1-snapshot -o yaml
apiVersion: placement.kubernetes-fleet.io/v1
kind: ClusterResourceSnapshot
metadata:
  ...
  labels:
    kubernetes-fleet.io/is-latest-snapshot: "true"
    kubernetes-fleet.io/parent-CRP: example-placement
    kubernetes-fleet.io/resource-index: "1"
  name: example-placement-1-snapshot
  ...
spec:
  selectedResources:
  - apiVersion: v1
    kind: Namespace
    metadata:
      labels:
        kubernetes.io/metadata.name: test-namespace
      name: test-namespace
    spec:
      finalizers:
      - kubernetes
  - apiVersion: v1
    data:
      key: value2
    kind: ConfigMap
    metadata:
      name: test-cm
      namespace: test-namespace

Wyświetlanie elementu ResourceSnapshot (dla elementu ResourcePlacement)

W przypadku umieszczeń o zakresie przestrzeni nazw, które używają ResourcePlacement, wyświetl obiekty ResourceSnapshot w przestrzeni nazw.

W tym przykładzie masz element my-app w przestrzeni nazw ResourcePlacement ze zaktualizowanymi mapami ConfigMap, który tworzy dwie migawki.

kubectl get resourcesnapshots -n my-app --show-labels

Widzisz dwie migawki, a najnowsza jest oznaczona jako najnowsza (kubernetes-fleet.io/is-latest-snapshot=true) i ma indeks zasobów 1 (kubernetes-fleet.io/resource-index=1).

NAME                               GEN   AGE    LABELS
app-configs-rp-0-snapshot          1     15m    kubernetes-fleet.io/is-latest-snapshot=false,kubernetes-fleet.io/parent-CRP=app-configs-rp,kubernetes-fleet.io/resource-index=0
app-configs-rp-1-snapshot          1     1m3s   kubernetes-fleet.io/is-latest-snapshot=true,kubernetes-fleet.io/parent-CRP=app-configs-rp,kubernetes-fleet.io/resource-index=1

Zawartość obiektu app-configs-rp-1-snapshot można sprawdzić w następujący sposób.

kubectl get resourcesnapshots app-configs-rp-1-snapshot -n my-app -o yaml
apiVersion: placement.kubernetes-fleet.io/v1
kind: ResourceSnapshot
metadata:
  ...
  labels:
    kubernetes-fleet.io/is-latest-snapshot: "true"
    kubernetes-fleet.io/parent-CRP: app-configs-rp
    kubernetes-fleet.io/resource-index: "1"
  name: app-configs-rp-1-snapshot
  namespace: my-app
  ...
spec:
  selectedResources:
  - apiVersion: v1
    data:
      config: updated-value
    kind: ConfigMap
    metadata:
      name: app-config
      namespace: my-app
      labels:
        app: my-application

Używanie migawek zasobów

Użyj migawek w ramach wdrożeń etapowych, którymi zarządzają uruchomienia aktualizacji. Służą one również jako mechanizm wycofania. Zarówno ClusterResourcePlacement, jak i ResourcePlacement obsługują wdrożenia etapowe przy użyciu ich odpowiednich typów migawek.

  • ClusterResourcePlacement używa obiektów ClusterResourceSnapshot z elementem ClusterStagedUpdateRun.
  • ResourcePlacement używa obiektów ResourceSnapshot z StagedUpdateRun.

Aby uzyskać szczegółowe informacje na temat implementowania wdrożeń etapowych dla obu typów rozmieszczenia zasobów, zobacz Strategia wdrażania etapowego.

Modyfikowanie limitu historii migawek

Aby zmienić liczbę elementów przechowywanych w historii, dodaj pole revisionHistoryLimit do swojej konfiguracji i podaj wartość całkowitą. Wartość domyślna to 10.

W przypadku ClusterResourcePlacement

apiVersion: placement.kubernetes-fleet.io/v1
kind: ClusterResourcePlacement
metadata:
  name: crp-example
spec:
  revisionHistoryLimit: 20   # keep 20 items in history
  resourceSelectors:
    - group: ""
      kind: Namespace
      name: test-namespace
      version: v1
  policy:
    placementType: PickN
    numberOfClusters: 2
    affinity:
      clusterAffinity:
        requiredDuringSchedulingIgnoredDuringExecution:
          clusterSelectorTerms:
            - labelSelector:
                matchLabels:
                  fleet.azure.com/location: westus
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: 1
      maxSurge: 50%

W przypadku ResourcePlacement

apiVersion: placement.kubernetes-fleet.io/v1
kind: ResourcePlacement
metadata:
  name: rp-example
  namespace: my-app
spec:
  revisionHistoryLimit: 20   # keep 20 items in history
  resourceSelectors:
    - group: ""
      kind: ConfigMap
      version: v1
      labelSelector:
        matchLabels:
          app: my-application
  policy:
    placementType: PickN
    numberOfClusters: 2
    affinity:
      clusterAffinity:
        requiredDuringSchedulingIgnoredDuringExecution:
          clusterSelectorTerms:
            - labelSelector:
                matchLabels:
                  fleet.azure.com/location: westus
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: 1
      maxSurge: 50%

Następne kroki