使用群集资源替代自定义 Azure Kubernetes 舰队管理器中的群集范围资源

本文概述了如何使用 ClusterResourceOverride API 自定义 Azure Kubernetes Fleet Manager 中的群集范围资源。

可以跨群集资源修改或替代特定属性。 使用 ClusterResourceOverride，可以根据群集标签定义规则，指定要应用于各种群集范围的资源的更改。 这些资源包括命名空间、群集角色、群集角色绑定或自定义资源定义。

这些修改可能包括对权限、配置或其他参数的更新。 此类更新有助于确保跨通过机群管理器管理的群集中的配置进行一致的管理和强制实施。

API 组件

ClusterResourceOverride API 包含以下组成部分：

• clusterResourceSelectors：指定要替代的群集资源集。
• policy：指定要应用于所选群集资源的规则集。

群集资源选择器

ClusterResourceOverride 对象可以包含一个或多个群集资源选择器，以指定要替代的资源。 ClusterResourceSelector 对象支持以下字段。

• group：资源的 API 组。
• version：资源的 API 版本。
• kind：资源的种类。
• name：资源的名称。

若要将群集资源选择器添加到 ClusterResourceOverride 对象，请使用具有以下 YAML 格式的 clusterResourceSelectors 字段：

apiVersion: placement.kubernetes-fleet.io/v1alpha1
kind: ClusterResourceOverride
metadata:
  name: example-cro
spec:
  clusterResourceSelectors:
    - group: rbac.authorization.k8s.io
      kind: ClusterRole
      version: v1
      name: secret-reader

此示例从 ClusterRole API 组中选择一个名为 secret-reader 的 rbac.authorization.k8s.io/v1 对象进行替代：

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: secret-reader
rules:
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get", "watch", "list"]

策略

Policy 对象由一组规则 (overrideRules) 组成，这些规则指定要应用于所选群集资源的更改。 每个 overrideRules 对象都支持以下字段：

• clusterSelector：指定替代规则要应用于的群集集。
• jsonPatchOverrides：指定要应用于所选资源的更改。

若要将替代规则添加到 ClusterResourceOverride 对象，请使用具有以下 YAML 格式的 policy 字段：

apiVersion: placement.kubernetes-fleet.io/v1alpha1
kind: ClusterResourceOverride
metadata:
  name: example-cro
spec:
  clusterResourceSelectors:
    - group: rbac.authorization.k8s.io
      kind: ClusterRole
      version: v1
      name: secret-reader
  policy:
    overrideRules:
      - clusterSelector:
          clusterSelectorTerms:
            - labelSelector:
                matchLabels:
                  env: prod
        jsonPatchOverrides:
          - op: remove
            path: /rules/0/verbs/2

此示例在具有标签 ClusterRole 的群集上删除名为 secret-reader 的 env: prod 对象中的谓词“list”。

群集选择器

可以使用 clusterSelector 对象中的 overrideRules 字段来指定替代规则要应用于的群集。 ClusterSelector 对象支持以下字段：

• clusterSelectorTerms：指定选择群集的条件的术语列表。 每个术语都包含一个 labelSelector 字段，用于定义一组要匹配的标签。

JSON 补丁替代

可以使用 jsonPatchOverrides 对象中的 overrideRules 来指定要应用于所选资源的更改。 JsonPatch 对象支持以下字段：

• op：要执行的操作。 支持的操作包括：

  • add：向指定路径添加新值。
  • remove：移除位于指定路径处的值。
  • replace：替换位于指定路径处的值。

• path：要修改的字段的路径。 有关指定路径的指南包括：

  • 必须以斜杠 (/) 字符开头。
  • 不能为空或包含空字符串。
  • 不能是 TypeMeta 字段（/kind 或 /apiVersion）。
  • 不能是 Metadata 字段（/metadata/name 或 /metadata/namespace），/metadata/labels 和 /metadata/annotations 字段除外。
  • 不能是资源状态中的任何字段。

  有效路径的示例包括：

  • /metadata/labels/new-label
  • /metadata/annotations/new-annotation
  • /spec/template/spec/containers/0/resources/limits/cpu
  • /spec/template/spec/containers/0/resources/requests/memory

• value：要添加、删除或替换的值。 如果 op 为 remove，则无法指定 value。

jsonPatchOverrides 字段根据 RFC 6902 对所选资源应用 JSON 补丁。

多个替代补丁

你可以将多个 jsonPatchOverrides 字段添加到 overrideRules 对象，以对所选群集资源应用多个修改。 下面是一个示例：

apiVersion: placement.kubernetes-fleet.io/v1alpha1
kind: ClusterResourceOverride
metadata:
  name: cro-1
spec:
  clusterResourceSelectors:
    - group: rbac.authorization.k8s.io
      kind: ClusterRole
      version: v1
      name: secret-reader
  policy:
    overrideRules:
      - clusterSelector:
          clusterSelectorTerms:
            - labelSelector:
                matchLabels:
                  env: prod
        jsonPatchOverrides:
          - op: remove
            path: /rules/0/verbs/2
          - op: remove
            path: /rules/0/verbs/1

此示例在具有标签 ClusterRole 的群集上删除名为 secret-reader 的 env: prod 对象中的谓词“list”或“watch”：

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: secret-reader
rules:
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get", "watch", "list"]

应用群集资源放置

相关内容

• KubeFleet 替代文档
• Azure Kubernetes 舰队管理器概述