分布式云原生平台可指定单集群中存量的应用进行联邦化，方便快速稳定接管存量单集群应用，本文以实际场景为例，从 0 到 1 为您详细介绍单集群资源联邦化的最佳实践。

场景介绍

分布式云原生平台提供产品化的单集群资源联邦化功能，可凭借多集群调度引擎对存量单集群资源的无缝接管能力，做到无需改造应用及不影响现有业务运行的情况下转变为多集群联邦应用，联邦化后的应用可以通过修改分发策略实现多集群应用分发，或跨集群应用迁移。

流程概述

资源联邦化核心流程：

1. 将待联邦化资源所在容器集群（以下称源集群）添加到联邦主控实例中，作为联邦集群成员集群。

2. 指定源集群中一个或多个待联邦化的资源，支持指定 Kubernetes 原生和 CRD 资源。

3. 平台自动将单集群资源转化为联邦资源定义，并关联默认部署策略将资源分发到源集群，对单集群资源进行接管。

4. 已经联邦化的资源可更新部署策略、差异化策略，实现多集群的资源分发/资源迁移。

组网说明

1. 集群纳管：DCP 创建 1 个代理模式注册集群纳管集群 A；DCP 将已创建的 VKE 集群 B 一键注册纳管。
2. 联邦集群：创建托管的联邦主控实例，并将以上集群 A、B 添加到主控实例中构建集群联邦。

前提条件

1. 已经注册火山引擎账号，并开通分布式云原生平台服务。
2. 已经在火山引擎创建 1 个 VKE 集群，已经在第三方云平台创建 1 个第三方容器集群（本场景以阿里云 ACK 为例）。

使用限制

Kubernetes 版本范围：v1.17 ~ v1.24。

操作步骤

本场景从 0 到 1 为您详细介绍单集群资源联邦化场景的操作步骤，可参考如下步骤依次执行。

步骤一：前往 ACK 创建单集群资源

参考 ACK 集群中创建资源的官方介绍，前往阿里云 ACK 进行资源创建。本场景使用的资源清单和 Yaml 定义如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: fed-dp-02
  namespace: default
spec:
  progressDeadlineSeconds: 600
  replicas: 1
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: fed-dp-02
  strategy:
    rollingUpdate:
      maxSurge: 25%
      maxUnavailable: 25%
    type: RollingUpdate
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: fed-dp-02
    spec:
      containers:
      - image: nginx
        imagePullPolicy: Always
        name: nginx
        resources: {}
        terminationMessagePath: /dev/termination-log
        terminationMessagePolicy: File
        volumeMounts:
        - mountPath: /pp
          name: v1
          readOnly: true
        - mountPath: /qq
          name: v2
          readOnly: true
      dnsPolicy: ClusterFirst
      restartPolicy: Always
      schedulerName: default-scheduler
      securityContext: {}
      terminationGracePeriodSeconds: 30
      volumes:
      - configMap:
          defaultMode: 420
          name: fed-cm-02
        name: v1
      - name: v2
        secret:
          defaultMode: 420
          secretName: fed-secret-01
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: fed-dp-01
  namespace: default
spec:
  progressDeadlineSeconds: 600
  replicas: 1
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: fed-dp-01
  strategy:
    rollingUpdate:
      maxSurge: 25%
      maxUnavailable: 25%
    type: RollingUpdate
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: fed-dp-01
    spec:
      containers:
      - image: nginx
        imagePullPolicy: Always
        name: nginx
        resources: {}
        terminationMessagePath: /dev/termination-log
        terminationMessagePolicy: File
        volumeMounts:
        - mountPath: /pp
          name: v1
          readOnly: true
        - mountPath: /aa
          name: v2
          readOnly: true
      dnsPolicy: ClusterFirst
      restartPolicy: Always
      schedulerName: default-scheduler
      securityContext: {}
      terminationGracePeriodSeconds: 30
      volumes:
      - configMap:
          defaultMode: 420
          name: fed-cm-01
        name: v1
      - name: v2
        secret:
          defaultMode: 420
          secretName: fed-secret-01
---
apiVersion: v1
kind: Service
metadata:
  annotations:
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-spec: slb.s1.small
  name: fed-service-01
  namespace: default
spec:
  ports:
    - name: test
      nodePort: 31922
      port: 80
      protocol: TCP
      targetPort: 80
  selector:
    app: fed-dp-01
  sessionAffinity: None
  type: LoadBalancer

步骤二：将容器集群注册/纳管到 DCP

将容器集群注册/纳管到分布式云原生平台统一管理，后续可直接添加到联邦主控实例作为成员集群，用于联邦制资源分发。本场景使用的参数配置如下：

1. 一键注册火山引擎 VKE 集群：VKE 和 DCP 同属火山引擎，通过容器集群页面顶部的 注册接入，即可将 VKE 集群一键注册到分布式云原生平台，详细操作步骤和配置项说明参见：注册 VKE 集群。

2. 通过代理模式注册 ACK 集群：通过容器集群页面 创建集群 > 注册集群，使用 代理连接 方式的两步操作，将 ACK 集群注册到分布式云原生平台。

本场景涉及的关键配置说明如下，其他按需配置即可，详细操作步骤和配置项说明参见：注册现有集群（代理连接）。

步骤三：搭建联邦集群基础环境

1. 创建主控实例：进入联邦主控实例页面，创建主控实例，用于实现联邦集群管理、应用调度分发功能。

本场景涉及的关键配置说明如下，其他按需配置即可，详细操作步骤和配置项说明参见：创建主控实例。

2. 创建差异化策略：进入联邦主控实例的差异化策略页面，通过 Yaml 创建一个适配火山引擎 VKE 资源的差异化策略。

以下示例为适配火山引擎 VKE LB 类型 Service 的差异化策略，可为调度到 VKE 集群的 LB Service 增加 Annotation（负载均衡名称、子网、公网访问等配置）。详细操作步骤和配置项说明参见：创建差异化策略（Yaml）。

apiVersion: core.kubeadmiral.io/v1alpha1
kind: OverridePolicy
metadata:
  name: volc-service-override
  namespace: default
spec:
  overrideRules:
  - overriders:
      jsonpatch:
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-name
        value: test-svc # 替换为您的负载均衡名称
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-subnet-id
        value: subnet-rrfc0aqw0yrkv0x58dutf68 # 替换为您的子网 ID
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-address-type
        value: PUBLIC
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-isp-type
        value: BGP
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-eip-billing-type
        value: "2"
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-bandwidth
        value: "25"
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-ip-version
        value: ipv4
      - operator: add
        path: /metadata/annotations/service.beta.kubernetes.io~1volcengine-loadbalancer-spec
        value: small_1
    targetClusters:
      clusters:
      - ccimgr0kcotmqodvr4cv0 # 替换为您的成员集群 ID

3. 添加成员集群：进入联邦主控实例的成员集群页面，将火山引擎 VKE 集群和纳管的外部 ACK 集群添加到联邦集群。

当关联状态切换为已关联时，表示集群添加成功，详细操作步骤和配置项说明参见：添加成员集群。

步骤四：ACK 集群资源联邦化

在分布式云原生平台，将联邦成员集群 ACK 中的资源联邦化。

1. 登录 分布式云原生控制台，在左侧导航栏选择 联邦主控实例，进入主控实例管理页面。
2. 在主控实例列表，单击目标主控实例名称，进入主控实例配置页面。
3. 在左侧导航栏选择 成员集群，进入成员集群列表，单击目标成员集群（本场景为上述添加的 ACK 集群）右侧操作列...图标中的 资源联邦化。
4. 在弹出的资源联邦化界面，配置 目标资源选择 相关信息，完成后单击 下一步：发布策略配置。

5. 配置 发布策略配置 相关信息，完成后单击 确定，开始执行资源联邦化。

分发策略配置步骤可配置 接管资源跟随调度，开启后工作负载挂载的卷（ConfigMap、Secret等）信息可自动识别后一并进行联邦化。

资源联邦化操作提交成功后，会自动生成部署策略与联邦资源关联，该部署策略目标分发集群为联邦化资源源集群。

结果验证

上述配置完成后，可通过修改部署策略来验证跨集群迁移和多集群分发功能，详细介绍如下。

修改部署策略实现跨集群迁移

将已经联邦化的 Service 资源关联火山引擎 VKE 集群适配的差异化策略，并将部署策略中分发的成员集群从 ACK 调整为 VKE 集群。

• 新增差异化策略

  1. 登录 分布式云原生控制台，在左侧导航栏选择 联邦主控实例，进入主控实例管理页面。
  2. 在主控实例列表，单击目标主控实例名称，进入主控实例配置页面。
  3. 在左侧导航栏选择 工作负载 > 无状态负载，进入无状态负载管理页面。
  4. 单击目标工作负载右侧操作列...中的 新增差异化策略，完成后单击 确定。

  

• 更新部署策略

  1. 登录 分布式云原生控制台，在左侧导航栏选择 联邦主控实例。
  2. 单击目标主控实例名称，进入主控实例配置页面，在左侧导航栏选择 策略管理 > 部署策略。
  3. 在部署策略列表，单击目标部署策略右侧操作列的 更新策略。
  4. 完成部署策略更新后，单击 确定，保存配置并开始资源重新分发。

  

可以看到资源已经从 ACK 集群迁移到 VKE 集群，且 VKE 集群中的 LB Service 资源已经进行差异化适配（新增 Annotation 配置）。

修改部署策略实现多集群分发

重复更新部署策略操作，同时指定 VKE 集群 和 ACK 集群，资源将会同时分发到两个成员集群中。