3. Federation 核心概念：FederatedDeployment、FederatedService、ReplicaSchedulingPreference、OverridePolicy

KubeFed（Kubernetes Federation v2）通过一组 Federation 核心 API 将多个独立 Kubernetes 集群抽象为一个统一控制面。理解这些核心资源是掌握版本漂移治理的前提——它们决定了工作负载如何分发、服务如何暴露、副本如何调度以及如何针对不同集群进行差异化覆盖。

3.1 FederatedDeployment：跨集群工作负载分发

FederatedDeployment 是 Federation 中最核心的工作负载资源。它封装了标准的 Deployment 定义，并附加了跨集群分发策略。

• 模板（Template）：包含标准的 Deployment 规范（Pod 模板、副本数、镜像等），是跨集群同步的“黄金配置”。
• 放置策略（Placement）：定义该 Deployment 应该被分发到哪些成员集群（通过 clusterSelector 或 clusterNames 指定）。
• 覆盖策略（Overrides）：允许针对特定集群调整模板中的字段（如镜像标签、环境变量），用于处理集群间差异。

apiVersion: types.kubefed.io/v1beta1
kind: FederatedDeployment
metadata:
  name: app-frontend
  namespace: production
spec:
  template:
    metadata:
      labels:
        app: frontend
    spec:
      replicas: 3
      template:
        spec:
          containers:
          - name: nginx
            image: nginx:1.25.0
            ports:
            - containerPort: 80
  placement:
    clusters:
    - name: cluster-01
    - name: cluster-02
    - name: cluster-03
  overrides:
  - clusterName: cluster-03
    clusterOverrides:
    - path: /spec/replicas
      value: 5
    - path: /spec/template/spec/containers/0/image
      value: nginx:1.25.0-staging

3.2 FederatedService：跨集群服务发现与暴露

FederatedService 负责将 Service 资源同步到多个集群，并结合 DNS 联邦（如 CoreDNS + kube-dns）实现跨集群的服务发现。

apiVersion: types.kubefed.io/v1beta1
kind: FederatedService
metadata:
  name: app-frontend-svc
  namespace: production
spec:
  template:
    spec:
      selector:
        app: frontend
      ports:
      - name: http
        port: 80
        targetPort: 80
      type: ClusterIP
  placement:
    clusters:
    - name: cluster-01
    - name: cluster-02

3.3 ReplicaSchedulingPreference：智能副本调度

ReplicaSchedulingPreference（RSP） 是 Federation 中用于跨集群副本数调度的策略资源。它解决了“每个集群应该运行多少个 Pod 副本”的问题，是版本漂移治理中控制副本分布的关键。

apiVersion: scheduling.kubefed.io/v1alpha1
kind: ReplicaSchedulingPreference
metadata:
  name: app-frontend-rsp
  namespace: production
spec:
  targetTemplate:
    # 关联的 FederatedDeployment
    apiVersion: types.kubefed.io/v1beta1
    kind: FederatedDeployment
    name: app-frontend
  totalReplicas: 10
  clusters:
    cluster-01:
      minReplicas: 2
      maxReplicas: 8
      weight: 6
    cluster-02:
      minReplicas: 1
      maxReplicas: 5
      weight: 3
    cluster-03:
      minReplicas: 0
      maxReplicas: 2
      weight: 1
  rebalance: true  # 当集群加入/离开时自动重新平衡

3.4 OverridePolicy：集群差异化覆盖

OverridePolicy 允许 Federation 管理员针对特定集群覆盖 FederatedDeployment 或 FederatedService 模板中的字段。这是处理集群间差异（如不同硬件架构、不同网络插件、不同存储类）的核心机制。

apiVersion: types.kubefed.io/v1beta1
kind: OverridePolicy
metadata:
  name: app-frontend-override
  namespace: production
spec:
  overrideRules:
  - clusterSelector:
      matchLabels:
        region: us-east
    overrides:
    - path: /spec/template/spec/containers/0/image
      value: registry.us-east.example.com/nginx:1.25.0
    - path: /spec/template/spec/containers/0/env/0
      value:
        name: DB_HOST
        value: db.us-east.example.com
  - clusterSelector:
      matchLabels:
        region: eu-west
    overrides:
    - path: /spec/template/spec/containers/0/image
      value: registry.eu-west.example.com/nginx:1.25.0
    - path: /spec/template/spec/containers/0/env/0
      value:
        name: DB_HOST
        value: db.eu-west.example.com

3.5 核心资源关系总结

以下表格总结了四种核心资源在版本漂移治理中的角色与协作关系：