安装并使用 Migration Toolkit for Virtualization

流程

1. 创建并导航到临时目录：

   $ mkdir /tmp/<dir_name> && cd /tmp/<dir_name>

   Copy to Clipboard Toggle word wrap
2. 在浏览器中，进入 VMware VDDK 版本 8 下载页面。
3. 选择版本 8.0.1，再点 Download。

1. 将 VDDK 归档文件保存到临时目录中。

2. 提取 VDDK 归档：

   $ tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gz

   Copy to Clipboard Toggle word wrap

3. 创建 Dockerfile：

   $ cat > Dockerfile <<EOF
   FROM registry.access.redhat.com/ubi8/ubi-minimal
   USER 1001
   COPY vmware-vix-disklib-distrib /vmware-vix-disklib-distrib
   RUN mkdir -p /opt
   ENTRYPOINT ["cp", "-r", "/vmware-vix-disklib-distrib", "/opt"]
   EOF

   Copy to Clipboard Toggle word wrap

4. 构建 VDDK 镜像：

   $ podman build . -t <registry_route_or_server_path>/vddk:<tag>

   Copy to Clipboard Toggle word wrap

5. 将 VDDK 镜像推送到 registry：

   $ podman push <registry_route_or_server_path>/vddk:<tag>

   Copy to Clipboard Toggle word wrap
6. 确保镜像可以被 OpenShift Virtualization 环境访问。

流程

1. 以 root 用户身份登录 ESXi 主机。

2. 在 /etc/vmware/hostd/config.xml 中将 maxMemory 改为 1000000000:

   ...
         <nfcsvc>
            <path>libnfcsvc.so</path>
            <enabled>true</enabled>
            <maxMemory>1000000000</maxMemory>
            <maxStreamMemory>10485760</maxStreamMemory>
         </nfcsvc>
   ...

   Copy to Clipboard Toggle word wrap

3. 重启 hostd ：

   # /etc/init.d/hostd restart

   Copy to Clipboard Toggle word wrap

   您不需要重启主机。

流程

1. 在 Red Hat OpenShift Web 控制台中，点 Plans for virtualization，然后点 Create Plan。

   Create migration plan 向导会打开 Select source provider 接口。

2. 选择您要迁移的虚拟机的源供应商。

   此时会打开 Select Virtual Machines 接口。

3. 选择您要迁移的虚拟机，然后点 Next。

   Create migration plan 窗格打开。它显示目标供应商和命名空间、网络映射和存储映射的源供应商名称和建议。

4. 输入 Plan 名称。
5. 对可编辑的项目进行任何需要的更改。
6. 点 Add mapping 来编辑推荐的网络映射或存储映射，或者添加一个或多个附加映射。

7. 点 Create migration plan。

   MTV 验证迁移计划，并打开 Plan details 页面，指示计划是否准备就绪以供使用或包含错误。列出计划的详细信息，您可以编辑在上一页上填写的项目。如果您进行任何更改，则 MTV 会再次验证计划。

8. 仅 VMware 源供应商（所有可选）：

   • 保留虚拟机的静态 IP ：默认情况下，虚拟网络接口控制器(vNIC)会在迁移过程中更改。这会导致在 vSphere 中使用静态 IP 设置的 vNIC 丢失其 IP。要避免这个问题，保留虚拟机的静态 IP，点 Preserve 静态 IP 旁边的 Edit 图标 ，并在打开的窗口中保留静态 IP 开关。然后点保存。

     然后，MTV 会发出有关缺少 vNIC 属性的 Windows 操作系统的警告消息。要检索任何缺少的 vNIC 属性，请在 vSphere 中运行这些虚拟机，以便向 MTV 报告 vNIC 属性。

   • 为使用 Linux Unified Key Setup (LUKS)加密的磁盘输入解密 密码短语列表： 要输入 LUKS 加密设备的解密密码短语列表，请在 Settings 部分中，单击 Disk decrypt passphrases 旁边的编辑图标，输入密码短语，然后单击 Save。您不需要以特定顺序输入密码短语 - 对于每个 LUKS 加密设备，MTV 会尝试每个密码短语，直到一个解锁该设备为止。

   • 指定根设备 ：仅适用于多引导虚拟机迁移。默认情况下，MTV 使用检测到的第一个可引导设备作为 root 设备。

     要指定不同的根设备，请在 Settings 部分中，点 Root 设备 旁边的 Edit 图标，然后从常用的选项列表中选择设备，或者在文本框中输入设备。

     MTV 对磁盘位置使用以下格式： /dev/sd<disk_identifier><disk_partition>。例如：如果第二个磁盘是 root 设备，且操作系统位于磁盘的第二个分区中，则格式将是： /dev/sdb2。输入引导设备后，点 Save。

     如果因为提供的引导设备不正确而转换失败，可以通过查看转换 pod 日志来获取正确的信息。

9. 仅 RHV 源提供程序（可选）：

   • 保留从 RHV 迁移的虚拟机 CPU 模型：通常，RHV 虚拟机的 CPU 模型（类型）在集群级别上设置，但可以在虚拟机级别设置，称为自定义 CPU 模型。默认情况下，MTV 在目标集群上设置 CPU 模型，如下所示： MTV 为具有它们的虚拟机保留自定义 CPU 设置，但对于没有自定义 CPU 设置的虚拟机，MTV 不会设置 CPU 模型。相反，CPU 模型稍后由 OpenShift Virtualization 设置。

     要保留 RHV 虚拟机的集群级别 CPU 模型，请在 Settings 部分中点 Preserve CPU 模型 旁边的 Edit 图标。切换 是否保留 CPU 模型 开关，然后单击 Save。

10. 如果计划有效，

    1. 现在，您可以通过点 Start migration 来运行计划。
    2. 您可以在 计划中选择虚拟化 页面并遵循运行迁移计划 中的步骤来稍后 运行计划。

流程

1. 在 Red Hat OpenShift Web 控制台中，点 Providers for virtualization。

2. 在适当的源供应商行中，单击 VMs。

   Virtual Machines 选项卡将打开。

3. 选择您要迁移的虚拟机，然后点 Create migration plan。

   Create migration plan 窗格打开。它显示目标供应商和命名空间、网络映射和存储映射的源供应商名称和建议。

4. 输入 Plan 名称。
5. 对可编辑的项目进行任何需要的更改。
6. 点 Add mapping 来编辑推荐的网络映射或存储映射，或者添加一个或多个附加映射。

7. 点 Create migration plan。

   MTV 验证迁移计划，并打开 Plan details 页面，指示计划是否准备就绪以供使用或包含错误。列出计划的详细信息，您可以编辑在上一页上填写的项目。如果您进行任何更改，则 MTV 会再次验证计划。

8. 仅 VMware 源供应商（所有可选）：

   • 保留虚拟机的静态 IP ：默认情况下，虚拟网络接口控制器(vNIC)会在迁移过程中更改。这会导致在 vSphere 中使用静态 IP 设置的 vNIC 丢失其 IP。要避免这个问题，保留虚拟机的静态 IP，点 Preserve 静态 IP 旁边的 Edit 图标 ，并在打开的窗口中保留静态 IP 开关。然后点保存。

     然后，MTV 会发出有关缺少 vNIC 属性的 Windows 操作系统的警告消息。要检索任何缺少的 vNIC 属性，请在 vSphere 中运行这些虚拟机，以便向 MTV 报告 vNIC 属性。

   • 为使用 Linux Unified Key Setup (LUKS)加密的磁盘输入解密 密码短语列表： 要输入 LUKS 加密设备的解密密码短语列表，请在 Settings 部分中，单击 Disk decrypt passphrases 旁边的编辑图标，输入密码短语，然后单击 Save。您不需要以特定顺序输入密码短语 - 对于每个 LUKS 加密设备，MTV 会尝试每个密码短语，直到一个解锁该设备为止。

   • 指定根设备 ：仅适用于多引导虚拟机迁移。默认情况下，MTV 使用检测到的第一个可引导设备作为 root 设备。

     要指定不同的根设备，请在 Settings 部分中，点 Root 设备 旁边的 Edit 图标，然后从常用的选项列表中选择设备，或者在文本框中输入设备。

     MTV 对磁盘位置使用以下格式： /dev/sd<disk_identifier><disk_partition>。例如：如果第二个磁盘是 root 设备，且操作系统位于磁盘的第二个分区中，则格式将是： /dev/sdb2。输入引导设备后，点 Save。

     如果因为提供的引导设备不正确而转换失败，可以通过查看转换 pod 日志来获取正确的信息。

9. 仅 RHV 源提供程序（可选）：

   • 保留从 RHV 迁移的虚拟机 CPU 模型：通常，RHV 虚拟机的 CPU 模型（类型）在集群级别上设置，但可以在虚拟机级别设置，称为自定义 CPU 模型。默认情况下，MTV 在目标集群上设置 CPU 模型，如下所示： MTV 为具有它们的虚拟机保留自定义 CPU 设置，但对于没有自定义 CPU 设置的虚拟机，MTV 不会设置 CPU 模型。相反，CPU 模型稍后由 OpenShift Virtualization 设置。

     要保留 RHV 虚拟机的集群级别 CPU 模型，请在 Settings 部分中点 Preserve CPU 模型 旁边的 Edit 图标。切换 是否保留 CPU 模型 开关，然后单击 Save。

10. 如果计划有效，

    1. 现在，您可以通过点 Start migration 来运行计划。
    2. 您可以在 计划中选择虚拟化 页面并遵循运行迁移计划 中的步骤来稍后 运行计划。

流程

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   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/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to Clipboard Toggle word wrap

   其中：

   Playbook 指的是可选的 Base64 编码的 Ansible Playbook。如果指定 playbook，image 必须是 hook-runner。

   注意

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

7. 为迁移创建 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>
     targetNamespace: <target_namespace>
     vms: 

   8

   
       - id: <source_vm> 

   9

   
       - name: <source_vm>
         hooks: 

   10

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

   11

   
             step: <step> 

   12

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   指定 Plan CR 的名称。

   2

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

   3

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

   4

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

   5

   指定 NetworkMap CR 的名称。

   6

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

   7

   指定 StorageMap CR 的名称。

   8

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

   9

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

   10

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

   11

   指定 Hook CR 的名称。

   12

   迁移完成后，允许的值是 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

   Copy to Clipboard Toggle word wrap
   注意

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

流程

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: ovirt
       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

   Copy to Clipboard Toggle word wrap

   1

   ownerReferences 部分是可选的。

   2

   指定 RHV Manager 用户。

   3

   指定用户密码。

   4

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

   5

   输入 Manager CA 证书，除非它被第三方证书替代，否则请输入 Manager Apache CA 证书。您可以在 https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA 中检索 Manager CA 证书。

   6

   指定 API 端点 URL，例如 https://<engine_host>/ovirt-engine/api。

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

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

   1

   
     secret:
       name: <secret> 

   2

   
       namespace: <namespace>
   EOF

   Copy to Clipboard Toggle word wrap

   1

   指定 API 端点的 URL，例如 https://<engine_host>/ovirt-engine/api。

   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: 

   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

   Copy to Clipboard Toggle word wrap

   1

   允许的值是 pod 和 multus。

   2

   您可以使用 id 或 name 参数来指定源网络。对于 id，指定 RHV 网络通用唯一 ID (UUID)。

   3

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

   4

   仅在 类型为 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:
           id: <source_storage_domain> 

   2

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

   Copy to Clipboard Toggle word wrap

   1

   允许的值有 ReadWriteOnce 和 ReadWriteMany。

   2

   指定 RHV 存储域 UUID。例如，f2737930-b567-451a-9ceb-2887f6207009。

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/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to Clipboard Toggle word wrap

   其中：

   Playbook 指的是可选的 Base64 编码的 Ansible Playbook。如果指定 playbook，image 必须是 hook-runner。

   注意

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

6. 为迁移创建 Plan 清单：

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

   1

   
     namespace: <namespace>
     preserveClusterCpuModel: true 

   2

   
   spec:
     warm: false 

   3

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

   4

   
       network: 

   5

   
         name: <network_map> 

   6

   
         namespace: <namespace>
       storage: 

   7

   
         name: <storage_map> 

   8

   
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 

   9

   
       - id: <source_vm> 

   10

   
       - name: <source_vm>
         hooks: 

   11

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

   12

   
             step: <step> 

   13

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   指定 Plan CR 的名称。

   2

   请参见以下备注。

   3

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

   4

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

   5

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

   6

   指定 NetworkMap CR 的名称。

   7

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

   8

   指定 StorageMap CR 的名称。

   9

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

   10

   指定 RHV VM UUID。

   11

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

   12

   指定 Hook CR 的名称。

   13

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

   注意
   • 如果使用自定义 CPU 模型设置了迁移的机器，它将在目标集群中使用该 CPU 模型设置，而不考虑 preserveClusterCpuModel 的设置。

   • 如果没有使用 自定义 CPU 模型设置迁移的机器：

     • 如果将 preserveClusterCpuModel 设置为 'true'，则 MTV 会根据集群的配置在 RHV 中运行时检查虚拟机的 CPU 模型，然后使用该 CPU 模型设置迁移的虚拟机。
     • 如果将 preserveClusterCpuModel 设置为 'false'，则 MTV 不会设置 CPU 类型，并使用目标集群的默认 CPU 模型设置虚拟机。

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

   Copy to Clipboard Toggle word wrap
   注意

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

流程

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

   2

   
     password: <password> 

   3

   
     insecureSkipVerify: <"true"/"false"> 

   4

   
     domainName: <domain_name>
     projectName: <project_name>
     regionName: <region_name>
     cacert: | 

   5

   
       <ca_certificate>
     url: <api_end_point> 

   6

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   ownerReferences 部分是可选的。

   2

   指定 OpenStack 用户。

   3

   指定用户 OpenStack 密码。

   4

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

   5

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

   6

   指定 API 端点 URL，例如 https://<identity_service>/v3。

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

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

   1

   
     secret:
       name: <secret> 

   2

   
       namespace: <namespace>
   EOF

   Copy to Clipboard Toggle word wrap

   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:

   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

   Copy to Clipboard Toggle word wrap

   1

   允许的值是 pod 和 multus。

   2

   您可以使用 id 或 name 参数来指定源网络。对于 id，指定 OpenStack 网络 UUID。

   3

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

   4

   仅在 类型为 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:
           id: <source_volume_type> 

   2

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

   Copy to Clipboard Toggle word wrap

   1

   允许的值有 ReadWriteOnce 和 ReadWriteMany。

   2

   指定 OpenStack volume_type UUID。例如，f2737930-b567-451a-9ceb-2887f6207009。

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/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to Clipboard Toggle word wrap

   其中：

   Playbook 指的是可选的 Base64 编码的 Ansible Playbook。如果指定 playbook，image 必须是 hook-runner。

   注意

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

6. 为迁移创建 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: 

   7

   
       - id: <source_vm> 

   8

   
       - name: <source_vm>
         hooks: 

   9

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

   10

   
             step: <step> 

   11

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   指定 Plan CR 的名称。

   2

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

   3

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

   4

   指定 NetworkMap CR 的名称。

   5

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

   6

   指定 StorageMap CR 的名称。

   7

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

   8

   指定 OpenStack 虚拟机 UUID。

   9

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

   10

   指定 Hook CR 的名称。

   11

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

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

   Copy to Clipboard Toggle word wrap
   注意

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

流程

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: ova
       createdForResourceType: providers
   type: Opaque
   stringData:
     url: <nfs_server:/nfs_path> 

   2

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   ownerReferences 部分是可选的。

   2

   其中： nfs_server 是创建共享的服务器的 IP 或主机名，nfs_path 是存储 OVA 文件在服务器上的路径。

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

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

   1

   
     secret:
       name: <secret> 

   2

   
       namespace: <namespace>
   EOF

   Copy to Clipboard Toggle word wrap

   1

   其中： nfs_server 是创建共享的服务器的 IP 或主机名，nfs_path 是存储 OVA 文件在服务器上的路径。

   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:
           id: <source_network_id> 

   2

   
       - destination:
           name: <network_attachment_definition> 

   3

   
           namespace: <network_attachment_definition_namespace> 

   4

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

   Copy to Clipboard Toggle word wrap

   1

   允许的值是 pod 和 multus。

   2

   指定 OVA 网络通用唯一 ID (UUID)。

   3

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

   4

   仅在 类型为 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:  Dummy storage for source provider <provider_name> 

   2

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

   Copy to Clipboard Toggle word wrap

   1

   允许的值有 ReadWriteOnce 和 ReadWriteMany。

   2

   对于 OVA，StorageMap 只能将单个存储（来自 OVA 的所有磁盘都与之关联）映射到目的地上的存储类。因此，存储在 UI 中被称为 "Dummy storage for source provider <provider_name>"。在 YAML 中，按上面显示的编写短语，没有引号，并将 <provider_name> 替换为供应商的实际名称。

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/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   Copy to Clipboard Toggle word wrap

   其中：

   Playbook 指的是可选的 Base64 编码的 Ansible Playbook。如果指定 playbook，image 必须是 hook-runner。

   注意

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

6. 为迁移创建 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: 

   7

   
       - id: <source_vm> 

   8

   
       - name: <source_vm>
         hooks: 

   9

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

   10

   
             step: <step> 

   11

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   指定 Plan CR 的名称。

   2

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

   3

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

   4

   指定 NetworkMap CR 的名称。

   5

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

   6

   指定 StorageMap CR 的名称。

   7

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

   8

   指定 OVA 虚拟机 UUID。

   9

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

   10

   指定 Hook CR 的名称。

   11

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

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

   Copy to Clipboard Toggle word wrap
   注意

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

流程

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

   Copy to Clipboard Toggle word wrap

   1

   ownerReferences 部分是可选的。

   2

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

   3

   指定用户密码。

   4

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

   5

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

   6

   指定 API 服务器端点的 URL。