11.7. 从 Red Hat OpenShift Virtualization 源供应商迁移

流程

1. 为源供应商凭证创建 Secret 清单：

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 1
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: openshift
       createdForResourceType: providers
   type: Opaque
   stringData:
     token: <token> 2
     password: <password> 3
     insecureSkipVerify: <"true"/"false"> 4
     cacert: | 5
       <ca_certificate>
     url: <api_end_point> 6
   EOF

   1

   ownerReferences 部分是可选的。

   2

   为具有 cluster-admin 权限的服务帐户指定令牌。如果 令牌和 url 都留空，则使用本地 OpenShift 集群。

   3

   指定用户密码。

   4

   指定 "true" 以跳过证书验证，并指定 "false" 来验证证书。如果没有指定，则默认为 "false "。跳过证书验证会进行不安全的迁移，然后不需要证书。不安全的迁移意味着传输的数据通过安全连接发送，并可能会公开敏感数据。

   5

   如果没有设置此字段并禁用 跳过证书验证 时，MTV 会尝试使用系统 CA。

   6

   指定 API 服务器的端点的 URL。

2. 为源供应商创建 Provider 清单：

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: openshift
     url: <api_end_point> 1
     secret:
       name: <secret> 2
       namespace: <namespace>
   EOF

   1

   指定 API 服务器的端点的 URL。

   2

   指定供应商 Secret CR 的名称。

3. 创建 NetworkMap 清单来映射源和目标网络：

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 1
         source:
           name: <network_name>
           type: pod
       - destination:
           name: <network_attachment_definition> 2
           namespace: <network_attachment_definition_namespace> 3
           type: multus
         source:
           name: <network_attachment_definition>
           namespace: <network_attachment_definition_namespace>
           type: multus
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   允许的值是 pod 和 multus。

   2

   为每个额外 OpenShift Virtualization 网络指定网络附加定义。使用 namespace 属性 或构建的名称来指定命名空间：<network_ namespace>/<network_name >。

   3

   仅在 类型 multus 时才需要。指定 OpenShift Virtualization 网络附加定义的命名空间。

4. 创建 StorageMap 清单来映射源和目标存储：

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 1
         source:
           name: <storage_class>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   允许的值有 ReadWriteOnce 和 ReadWriteMany。

5. 可选：在 Plan CR 中指定的阶段创建一个 Hook 清单以在虚拟机中运行自定义代码：

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/kubev2v/hook-runner
     serviceAccount:<service account> 1
     playbook: |
       LS0tCi0gbm... 2
   EOF

   1

   可选： Red Hat OpenShift 服务帐户。使用 serviceAccount 参数修改任何集群资源。

   2

   base64 编码的 Ansible Playbook.如果指定了 playbook，镜像 必须包含 ansible-runner。

   注意

   您可以使用默认 hook-runner 镜像或指定自定义镜像。如果指定自定义镜像，则不需要指定 playbook。

6. 输入以下命令为 MTV 迁移创建传输网络的网络附加定义(NAD)。

   您可以使用此定义为接口配置 IP 地址，可以从 Dynamic Host Configuration Protocol (DHCP)或静态方式配置。

   配置 IP 地址可让接口访问配置的网关。

   $ oc edit NetworkAttachmentDefinitions <name_of_the_NAD_to_edit>
   apiVersion: k8s.cni.cncf.io/v1
   kind: NetworkAttachmentDefinition
   metadata:
     name: <name_of_transfer_network>
     namespace: <namespace>
     annotations:
       forklift.konveyor.io/route: <IP_address>

7. 为迁移创建 Plan 清单：

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 1
     namespace: <namespace>
   spec:
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 2
       network: 3
         name: <network_map> 4
         namespace: <namespace>
       storage: 5
         name: <storage_map> 6
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms:
       - name: <source_vm>
         namespace: <namespace>
         hooks: 7
           - hook:
               namespace: <namespace>
               name: <hook> 8
             step: <step> 9
   EOF

   1

   指定 Plan CR 的名称。

   2

   每个计划仅指定一个网络映射和一个存储映射。

   3

   指定网络映射，即使要迁移的虚拟机没有分配给网络。在这种情况下，映射可以为空。

   4

   指定 NetworkMap CR 的名称。

   5

   指定存储映射，即使要迁移的虚拟机没有使用磁盘镜像分配。在这种情况下，映射可以为空。

   6

   指定 StorageMap CR 的名称。

   7

   可选：为虚拟机指定最多两个 hook。每个 hook 必须在不同的迁移步骤中运行。

   8

   指定 Hook CR 的名称。

   9

   在迁移完成后，允许的值是 PreHook、在迁移计划启动前或 PostHook。

8. 创建运行 Plan CR 的 Migration 清单：

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   注意

   如果您指定了一个截止时间，请使用 ISO 8601 格式以及 UTC 时间偏移，例如 2024-04-04T01:23:45.678+09:00。