Verständnis von Snapshots für die Ressourcenplatzierung im Azure Kubernetes Fleet Manager

Gilt für: ✔️ Flottenmanager mit Hubcluster

Flottenmanager behält eine Geschichte der 10 zuletzt verwendeten Platzierungsplanungsrichtlinien zusammen mit den ausgewählten Ressourcenversionen bei. Sie enthält diese Richtlinien- und Ressourcenversionen als Snapshotobjekte:

  • Für ClusterResourcePlacement (CRP): ClusterSchedulingPolicySnapshot und ClusterResourceSnapshot (Clusterbereich)
  • Für ResourcePlacement (RP): SchedulingPolicySnapshot und ResourceSnapshot (namespace-basiert)

In diesem Artikel untersuchen wir diese Objekte, damit Sie sie verstehen können, wenn Sie mit ihnen arbeiten möchten.

Hinweis

Wenn Sie noch nicht mit der Ressourcenplatzierung von Fleet Manager vertraut sind:

Wie Ressourcen-Schnappschüsse erstellt werden

Jede Änderung an Ressourcen, die vom Umfang der CRP- oder RP-Ressourcenauswahl abgedeckt werden, löst die Erstellung einer neuen Ressourcenmomentaufnahme innerhalb von 60 Sekunden automatisch aus.

Anzeigen von Ressourcenmomentaufnahmen

Sie können die vom Fleet Manager gehaltenen Ressourcenmomentaufnahmen anzeigen, indem Sie die folgenden Schritte ausführen, wenn sie mit dem Fleet Manager Hub Cluster verbunden sind.

Anzeigen von ClusterResourceSnapshot (für ClusterResourcePlacement)

Zeigen Sie für clusterbezogene Platzierungen, die ClusterResourcePlacement verwenden, ClusterResourceSnapshot-Objekte an.

In diesem Beispiel verwenden wir eine aktualisierte ConfigMap, die zwei Snapshots erstellt.

kubectl get clusterresourcesnapshots --show-labels

Es werden zwei Momentaufnahmen angezeigt, und die neueste wird als neueste (kubernetes-fleet.io/is-latest-snapshot=true) markiert und weist einen Ressourcenindex von 1 (kubernetes-fleet.io/resource-index=1) auf.

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

Sie können den Inhalt des example-placement-1-snapshot Objekts wie folgt prüfen.

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

Anzeigen von ResourceSnapshot (für ResourcePlacement)

Zeigen Sie für Namespacebereichsplatzierungen, die ResourcePlacement verwenden, ResourceSnapshot-Objekte im Namespace an.

In diesem Beispiel sehen Sie eine ResourcePlacement im my-app-Namespace, mit aktualisierten ConfigMaps, was zwei Momentaufnahmen erstellt.

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

Es werden zwei Momentaufnahmen angezeigt, und die neueste wird als neueste (kubernetes-fleet.io/is-latest-snapshot=true) markiert und weist einen Ressourcenindex von 1 (kubernetes-fleet.io/resource-index=1) auf.

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

Sie können den Inhalt des app-configs-rp-1-snapshot Objekts wie folgt prüfen.

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

Verwendung von Ressourcenschnappschüssen

Verwenden Sie Momentaufnahmen als Teil von mehrstufigen Rollouts, die durch Aktualisierungsausführungen verwaltet werden. Sie dienen auch als Rollbackmechanismus. Sowohl ClusterResourcePlacement als auch ResourcePlacement unterstützen mehrstufige Rollouts mit ihren jeweiligen Snapshot-Typen.

  • ClusterResourcePlacement verwendet ClusterResourceSnapshot Objekte mit ClusterStagedUpdateRun.
  • ResourcePlacement verwendet ResourceSnapshot Objekte mit StagedUpdateRun.

Ausführliche Informationen zum Implementieren von mehrstufigen Rollouts für beide Ressourcenplatzierungstypen finden Sie unter "Mehrstufige Rolloutstrategie".

Ändern des Grenzwerts für die Schnappschrithistorie

Um die Anzahl der im Verlauf gehaltenen Elemente zu ändern, fügen Sie Ihrer Platzierung ein revisionHistoryLimit-Feld hinzu und geben einen ganzzahligen Wert an. Der Standardwert ist 10.

Für 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%

Für 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%

Nächste Schritte