了解 Azure Kubernetes Fleet Manager 中资源放置的快照功能

适用于:✔️具有中心群集的 Fleet Manager

舰队管理器保留最近使用的 10 个放置计划策略的历史记录,以及所选放置的资源版本。 它将这些策略和资源版本保存为快照对象:

  • 对于 ClusterResourcePlacement (CRP): ClusterSchedulingPolicySnapshot 和 ClusterResourceSnapshot (群集范围)
  • 对于 ResourcePlacement (RP): SchedulingPolicySnapshot 和 ResourceSnapshot (命名空间范围)

本文将介绍这些对象,帮助你在需要使用它们时理解其含义。

注释

如果你还不熟悉 Fleet Manager 的资源放置:

如何创建资源快照

对 CRP 或 RP 资源选择器涵盖的资源所做的任何更改都会在 60 秒内自动触发新资源快照的创建。

查看资源快照

连接到 Fleet Manager 中心群集时,可以使用以下步骤查看 Fleet Manager 持有的资源快照。

查看 ClusterResourceSnapshot(用于 ClusterResourcePlacement)

对于使用 ClusterResourcePlacement 的群集范围放置,请查看 ClusterResourceSnapshot 对象。

在此示例中,我们使用了更新后的 ConfigMap,它会创建两个快照。

kubectl get clusterresourcesnapshots --show-labels

你会看到两个快照,最新的快照被标记为“最新”(kubernetes-fleet.io/is-latest-snapshot=true),并且资源索引为 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

可以按如下方式检查 example-placement-1-snapshot 对象的内容。

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

查看 ResourceSnapshot(适用于 ResourcePlacement)

对于使用 ResourcePlacement 的命名空间范围放置,请查看该命名空间中的 ResourceSnapshot 对象。

在此示例中,在 my-app 命名空间中,有一个 ResourcePlacement,其 ConfigMaps 已更新,这会创建两个快照。

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

你会看到两个快照,最新的快照被标记为“最新”(kubernetes-fleet.io/is-latest-snapshot=true),并且资源索引为 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

可以按如下方式检查 app-configs-rp-1-snapshot 对象的内容。

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

使用资源快照

使用快照作为运行管理更新的分阶段发布的一部分。 它们还充当回滚机制。 ClusterResourcePlacement和ResourcePlacement均支持分阶段推出,并使用各自的快照类型。

  • ClusterResourcePlacement 使用带有 ClusterStagedUpdateRun 的 ClusterResourceSnapshot 对象。
  • ResourcePlacement 使用带有 StagedUpdateRun 的 ResourceSnapshot 对象。

有关如何为这两种资源放置类型实现分阶段推出的详细信息,请参阅 分阶段推出策略。

修改快照历史记录限制

若要更改历史记录中保存的项数,请将字段 revisionHistoryLimit 添加到位置并提供整数值。 默认值为 10。

对于 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%

对于 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%

后续步骤