12.2. 从 VMware vSphere 源供应商迁移

流程

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: vsphere
       createdForResourceType: providers
   type: Opaque
   stringData:
     user: <user> 

   2

   
     password: <password> 

   3

   
     insecureSkipVerify: <"true"/"false"> 

   4

   
     cacert: | 

   5

   
       <ca_certificate>
     url: <api_end_point> 

   6

   
   EOF

   1

   ownerReferences 部分是可选的。

   2

   指定 vCenter 用户或 ESX/ESXi 用户。

   3

   指定 vCenter 用户或 ESX/ESXi 用户的密码。

   4

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

   5

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

   6

   指定 vCenter 的 API 端点 URL 或 ESX/ESXi，例如 https://<vCenter_host>/sdk。

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

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

   1

   
     settings:
       vddkInitImage: <VDDK_image> 

   2

   
       sdkEndpoint: vcenter 

   3

   
     secret:
       name: <secret> 

   4

   
       namespace: <namespace>
   EOF

   1

   指定 API 端点的 URL，例如 https://<vCenter_host>/sdk。

   2

   可选，但强烈建议创建一个 VDDK 镜像来加快迁移。按照 OpenShift 文档指定您创建的 VDDK 镜像。

   3

   选项： vcenter 或 esxi。

   4

   指定供应商 Secret CR 的名称。

3. 创建 主机清单 ：

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Host
   metadata:
     name: <vmware_host>
     namespace: <namespace>
   spec:
     provider:
       namespace: <namespace>
       name: <source_provider> 

   1

   
     id: <source_host_mor> 

   2

   
     ipAddress: <source_network_ip> 

   3

   
   EOF

   1

   指定 VMware vSphere Provider CR 的名称。

   2

   指定 VMware vSphere 主机的 Managed Object Reference (moRef)。要检索 moRef，请参阅 检索 VMware vSphere moRef。

   3

   指定 VMware vSphere 迁移网络的 IP 地址。

4. 创建 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: 

   2

   
           id: <source_network_id>
           name: <source_network_name>
       - destination:
           name: <network_attachment_definition> 

   3

   
           namespace: <network_attachment_definition_namespace> 

   4

   
           type: multus
         source:
           id: <source_network_id>
           name: <source_network_name>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   允许的值有 pod、multus，并忽略。使用 忽略 以避免在此迁移中将虚拟机附加到这个网络。

   2

   您可以使用 id 或 name 参数来指定源网络。对于 id，指定 VMware vSphere 网络受管对象参考(moRef)。要检索 moRef，请参阅 检索 VMware vSphere moRef。

   3

   为每个额外 OpenShift Virtualization 网络指定网络附加定义。

   4

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

5. 创建 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:
           id: <source_datastore> 

   2

   
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   允许的值有 ReadWriteOnce 和 ReadWriteMany。

   2

   指定 VMware vSphere 数据存储 moRef。例如，f2737930-b567-451a-9ceb-2887f6207009。要检索 moRef，请参阅 检索 VMware vSphere moRef。

6. 可选：在 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。

7. 输入以下命令为 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>

8. 为迁移创建 Plan 清单：

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 

   1

   
     namespace: <namespace>
   spec:
     warm: false 

   2

   
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 

   3

   
       network: 

   4

   
         name: <network_map> 

   5

   
         namespace: <namespace>
       storage: 

   6

   
         name: <storage_map> 

   7

   
         namespace: <namespace>
     preserveStaticIPs: 

   8

   
     networkNameTemplate: <network_interface_template> 

   9

   
     pvcNameTemplate: <pvc_name_template> 

   10

   
     pvcNameTemplateUseGenerateName: true 

   11

   
     skipGuestConversion: false 

   12

   
     targetNamespace: <target_namespace>
     useCompatibilityMode: true 

   13

   
     volumeNameTemplate: <volume_name_template> 

   14

   
     vms: 

   15

   
       - id: <source_vm1> 

   16

   
       - name: <source_vm2>
         networkNameTemplate: <network_interface_template_for_this_vm> 

   17

   
         pvcNameTemplate: <pvc_name_template_for_this_vm> 

   18

   
         volumeNameTemplate: <volume_name_template_for_this_vm> 

   19

   
         targetName: <target_name> 

   20

   
         hooks: 

   21

   
           - hook:
               namespace: <namespace>
               name: <hook> 

   22

   
             step: <step> 

   23

   
   
   EOF

   1

   指定 Plan CR 的名称。

   2

   指定迁移是 warm - true - 或 cold - false。如果您指定了 warm 迁移，且没有为 Migration 清单中的 cutover 参数指定一个值，则只有 precopy 阶段将运行。

   3

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

   4

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

   5

   指定 NetworkMap CR 的名称。

   6

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

   7

   指定 StorageMap CR 的名称。

   8

   默认情况下，虚拟网络接口控制器(vNIC)在迁移过程中会改变。因此，使用链接到客户端虚拟机中接口名称的静态 IP 地址的 vNIC 会丢失其 IP 地址。要避免这种情况，请将 preserveStaticIPs 设置为 true。MTV 对缺少 vNIC 属性的任何虚拟机发出警告消息。要检索任何缺少的 vNIC 属性，请在 vSphere 中运行这些虚拟机，以便向 MTV 报告 vNIC 属性。

   9

   可选。在计划中为虚拟机指定网络接口模板。模板遵循 Go 模板语法，并可访问以下变量：

   • .networkName: 如果目标网络是 multus，请添加 Multus 网络附加定义的名称。否则，将此变量留空。
   • .networkNamespace ：如果目标网络是 multus，请添加 Multus 网络附加定义所在的命名空间。
   • .networkType ：指定网络类型。选项： multus 或 pod。

   • .NetworkIndex ：网络接口的序列索引(0-based)。

     例子

   • "net-{{.NetworkIndex}}"

   • {{if eq .NetworkType "pod"}}pod{{else}}multus-{{.NetworkIndex}}{{end}}"

     变量名称不能超过 63 个字符。此规则适用于网络名称网络模板、PVC 名称模板、虚拟机名称模板和卷名称模板。

   10

   可选。为计划指定持久性卷声明(PVC)名称模板。模板遵循 Go 模板语法，并可访问以下变量：

   • .vmname: 虚拟机的名称。
   • .PlanName: 迁移计划的名称。
   • .DiskIndex ：磁盘的初始卷索引。
   • .RootDiskIndex ：根磁盘索引。

   • . shared : Options: true，用于非共享卷的共享卷为 false。

     例子

   • "{{.vmname}}-disk-{{.DiskIndex}}"
   • "{{if eq .DiskIndex .RootDiskIndex}}root{{else}}data{{end}}-{{.DiskIndex}}"
   • "{{if .Shared}}shared-{{end}}{{.VmName}}-{{.DiskIndex}}"

   11

   可选：

   • 当设置为 true 时，MTV 会将一个或多个随机生成的字母数字字符添加到 PVC 名称中，以确保所有 PVC 都有唯一的名称。

   • 当设置为 false 时，如果您指定了 pvcNameTemplate，则 MTV 不会将此类字符添加到 PVC 的名称中。

     警告

     如果将 pvcNameTemplateUseGenerateName 设置为 false，则生成的 PVC 名称可能不是唯一的，并可能导致冲突。

   12

   确定在使用 virt-v2v 工具迁移前是否转换虚拟机，从而使虚拟机与 OpenShift Virtualization 兼容。

   • 当设置为 false 时，默认值 MTV 使用 virt-v2v 迁移虚拟机。

   • 当设置为 true 时，MTV 使用原始复制模式迁移虚拟机，该模式可在不首先转换虚拟机的情况下复制它们。

     原始复制模式可在不使用 virt-v2v 转换虚拟机的情况下复制虚拟机。这可以加快转换速度，迁移运行更广泛的操作系统的虚拟机，并支持使用 Linux Unified Key Setup (LUKS)加密的磁盘，而无需密钥。但是，使用原始复制模式迁移的虚拟机在 OpenShift Virtualization 中可能无法正常工作。有关 virt-v2v 的更多信息，请参阅 MTV 如何使用 virt-v2v 工具。

   13

   确定当 skipGuestConversion 为 true 时，迁移是否使用 VirtIO 设备或兼容性设备(SATA 总线、E1000E NIC)，即原始副本模式用于迁移时。当 skipGuestConversion 为 false 时，useCompatibilityMode 的设置无效，因为 virt-v2v 转换始终使用 VirtIO 设备。

   • 当设置为 true 时，SPM 使用迁移过程中的兼容性设备(SATA 总线、E1000E NIC)，以确保虚拟机在迁移后可以引导。
   • 当设置为 false 时，MTV 在迁移过程中使用高性能 VirtIO 设备，virt-v2v 则确保虚拟机可在迁移后引导。在使用这个选项前，请验证源虚拟机中已安装了 VirtIO 驱动程序。

   14

   可选：在计划中为虚拟机指定卷接口名称模板。模板遵循 Go 模板语法，并可访问以下变量：

   • .PVCName: 使用这个卷挂载到虚拟机的 PVC 名称。

   • .VolumeIndex ：卷接口(0)的 Sequential 索引。

     例子

   • "disk-{{.VolumeIndex}}"
   • "pvc-{{.PVCName}}"

   15

   您可以使用 id 或 name 参数指定源虚拟机。

   16

   指定 VMware vSphere VM moRef。要检索 moRef，请参阅 检索 VMware vSphere moRef。

   17

   可选：指定特定虚拟机的网络接口名称。覆盖 spec:networkNameTemplate 中设置的值。变量和示例，如调用 9 所示。

   18

   可选：指定特定虚拟机的 PVC 名称。覆盖 spec:pvcNameTemplate 中设置的值。变量和示例如调用 10 所示。

   19

   可选：指定特定虚拟机的卷名称。覆盖 spec:volumeNameTemplate 中设置的值。变量和示例，如调用 14 所示。

   20

   可选： MTV 会自动为目标虚拟机的名称。您可以使用此参数并输入新名称来覆盖此名称。您输入的名称必须是唯一的，且它必须是有效的 Kubernetes 子域。否则，迁移会自动失败。

   21

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

   22

   指定 Hook CR 的名称。

   23

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

   重要

   当您将 VMware 7 虚拟机迁移到使用 CentOS 7.9 的 OpenShift 4.13+ 平台时，网络接口的名称会改变，虚拟机的静态 IP 配置无法正常工作。

9. 创建运行 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。