批量迁移及回滚

场景

假设用户安装了一个 Kubernetes 单集群，该集群已经部署了很多资源。

用户希望通过 Karmada 将单集群扩展成多集群，并将已部署的资源从原集群迁移到 Karmada。 用户要求已经存在的 Pod 在迁移过程中不受影响，或者说相关容器不会重新启动。

那么，如何实现资源的平滑迁移呢？

推荐的迁移方式

如果用户只需迁移个别资源，参考 promote-legacy-workload 逐个资源迁移即可。

如果用户想批量迁移资源，例如以下两种场景：

• 以资源为粒度，迁移某种类型的全部资源
• 以应用为粒度，迁移某个应用涉及的所有类型的资源

那么，您需要通过配置 PropagationPolicy 来接管相应资源，可以按如下操作：

步骤一

由于现有资源将由 Karmada 接管，因此不再需要将相关的YAML配置应用于成员集群。 也就是说，您可以停止相应的操作或流水线。

步骤二

将所有资源的 YAML 配置应用到 Karmada 控制面, 作为 Karmada 的 ResourceTemplate。

步骤三

编写 PropagationPolicy, 并将其应用到 Karmada 控制面。 您需要注意以下两个字段：

• spec.conflictResolution: Overwrite：该字段的值必须是 Overwrite。
• spec.resourceSelectors：指定哪些资源需要被迁移。

这里提供三个例子：

示例 1. 迁移 Deployment 类型的全部资源

如果您希望把所有的 Deployment 从 member1 集群迁移到 Karmada，你需要应用以下配置:

apiVersion: policy.karmada.io/v1alpha1
kind: PropagationPolicy
metadata:
  name: deployments-pp
spec:
  conflictResolution: Overwrite
  placement:
    clusterAffinity:
      clusterNames:
      - member1
  priority: 0
  resourceSelectors:
  - apiVersion: apps/v1
    kind: Deployment
  schedulerName: default-scheduler

示例 2. 迁移 Service 类型的全部资源

如果您希望把所有的 Service 从 member1 集群迁移到 Karmada，你需要应用以下配置:

apiVersion: policy.karmada.io/v1alpha1
kind: PropagationPolicy
metadata:
  name: services-pp
spec:
  conflictResolution: Overwrite
  placement:
    clusterAffinity:
      clusterNames:
      - member1
  priority: 0
  resourceSelectors:
  - apiVersion: v1
    kind: Service
  schedulerName: default-scheduler

示例 3. 迁移某个应用涉及的所有资源

假设某个应用由 deployment/nginx 和 service/nginx-svc 组成， 您希望把该应用涉及的资源从 member1 集群一起迁移到 Karmada，你需要应用以下配置:

apiVersion: policy.karmada.io/v1alpha1
kind: PropagationPolicy
metadata:
  name: nginx-pp
spec:
  conflictResolution: Overwrite
  placement:
    clusterAffinity:
      clusterNames:
      - member1
  resourceSelectors:
  - apiVersion: apps/v1
    kind: Deployment
    name: nginx
  - apiVersion: v1
    kind: Service
    name: nginx-svc

步骤四

余下的迁移操作将由Karmada自动完成。

迁移操作如何回滚

资源被迁移到 Karmada 后，若用户删除资源模板，默认情况下成员集群的资源也会随之删除。然而在某些场景下，用户希望资源模板删除后， 成员集群资源依然保留。

例如，作为管理员，在工作负载迁移过程中可能遇到意外情况（如云平台无法发布应用程序或 Pod 异常）， 需要回滚机制立刻恢复到迁移之前的状态，以便快速止损。

为了满足以上场景，Karmada 在 PropagationPolicy 中提供了 spec.preserveResourcesOnDeletion 字段来控制删除资源模板时， 成员集群上的资源是否应被保留。如果设置为 true，资源将在成员集群上被保留。默认值为 false，即资源将与资源模板一起被删除。

使用该字段请注意以下两点：

• 该配置对所有成员集群中统一生效，不会仅针对某些集群进行选择性控制。
• 该配置不适用于 Policy 本身的删除，当 Policy 被删除时，资源模板及已分发的成员集群资源将保持不变，除非被显式删除。

以 示例 3 的 PropagationPolicy 为例，用户删除资源模板前需将 PropagationPolicy 修改成如下所示：

apiVersion: policy.karmada.io/v1alpha1
kind: PropagationPolicy
metadata:
  name: nginx-pp
spec:
  conflictResolution: Overwrite
  preserveResourcesOnDeletion: true  # 资源模板删除后，成员集群资源依然保留
  placement:
    clusterAffinity:
      clusterNames:
      - member1
  resourceSelectors:
  - apiVersion: apps/v1
    kind: Deployment
    name: nginx
  - apiVersion: v1
    kind: Service
    name: nginx-svc

以上就是批量迁移及回滚的介绍，详细的 Demo 可以参考教程：平滑迁移及回滚。