Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 5 章 从命令行迁移虚拟机

您可以使用命令行将虚拟机迁移到 OpenShift Virtualization。

重要

5.1. 迁移虚拟机
复制链接

您可以通过创建 MTV 自定义资源(CR)从命令行(CLI)迁移虚拟机。

重要

您必须为集群范围的 CR 指定一个名称。

您必须为命名空间范围 CR 指定名称和命名空间。

作为技术预览，MTV 支持使用 OpenStack 源供应商的迁移。

重要

使用 OpenStack 源供应商进行迁移只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的详情，请参考 https://access.redhat.com/support/offerings/techpreview/。

注意

使用 OpenStack 源提供程序进行迁移只支持仅使用 Cinder 卷的虚拟机。

先决条件

  • 仅 VMware：在所有集群可以访问的安全 registry 中必须有 VMware Virtual Disk Development Kit(VDDK)镜像。

流程

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

    $ cat << EOF | oc apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: <secret>
  namespace: openshift-mtv
  ownerReferences:
    1 
    
    - apiVersion: forklift.konveyor.io/v1beta1
      kind: Provider
      name: <provider_name>
      uid: <provider_uid>
  labels:
    createdForProviderType: <provider_type>
    2 
    
type: Opaque
stringData:
  user: <user>
    3 
    
  password: <password>
    4 
    
  insecureSkipVerify: <true/false>
    5 
    
  domainName: <domain_name>
    6 
    
  projectName: <project_name>
    7 
    
  regionName: <region name>
    8 
    
  cacert: |
    9 
    
    <ca_certificate>
  url: <api_end_point>
    10 
    
  thumbprint: <vcenter_fingerprint>
    11 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    ownerReferences 部分是可选的。
    2
    指定源供应商的类型。允许的值有 ovirt、vsphere 和 openstack。当访问远程系统时，需要此标签来验证凭据是否正确，并在指定第三方证书时检索 Manager CA 证书。
    3
    指定 vCenter 用户、RHV Manager 用户或 OpenStack 用户。
    4
    指定用户密码。
    5
    指定 <true > 来跳过证书验证，它会进行不安全的迁移，然后不需要证书。不安全的迁移意味着传输的数据通过不安全的连接发送，并可能会公开潜在的敏感数据。指定 & lt;false& gt; 验证证书。
    6
    仅 OpenStack：指定域名。
    7
    仅 OpenStack：指定项目名称。
    8
    仅 OpenStack：指定 OpenStack 区域的名称。
    9
    仅 RHV 和 OpenStack：对于 RHV，请输入 Manager CA 证书，除非被第三方证书替代，在这种情况下，输入 Manager Apache CA 证书。您可以在 https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA 中检索 Manager CA 证书。对于 OpenStack，请输入用于连接到源环境的 CA 证书。当 insecureSkipVerify 设置为 < true> 时，不使用该证书。
    10
    指定 API 端点 URL，例如 https://<vCenter_host>/sdk 用于 vSphere、https://<engine_host>/ovirt-engine/api/ 用于 RHV，或 OpenStack 的 https://<identity_service>/v3。
    11
    仅 VMware：指定 vCenter SHA-1 指纹。

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

    $ cat << EOF | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Provider
metadata:
  name: <provider>
  namespace: openshift-mtv
spec:
  type: <provider_type>
    1 
    
  url: <api_end_point>
    2 
    
  settings:
    vddkInitImage: <registry_route_or_server_path>/vddk:<tag>
    3 
    
  secret:
    name: <secret>
    4 
    
    namespace: openshift-mtv
EOF
    Copy to Clipboard Toggle word wrap
    1
    允许的值有 ovirt、vsphere 和 openstack。
    2
    指定 API 端点 URL，例如 https://<vCenter_host>/sdk 用于 vSphere、https://<engine_host>/ovirt-engine/api/ 用于 RHV，或 OpenStack 的 https://<identity_service>/v3。
    3
    仅 VMware：指定您创建的 VDDK 镜像。
    4
    指定供应商 Secret CR 的名称。

  3. 仅限 VMware：创建一个 Host 清单： 

    $ cat << EOF | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Host
metadata:
  name: <vmware_host>
  namespace: openshift-mtv
spec:
  provider:
    namespace: openshift-mtv
    name: <source_provider>
    1 
    
  id: <source_host_mor>
    2 
    
  ipAddress: <source_network_ip>
    3 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    指定 VMware Provider CR 的名称。
    2
    指定 VMware 主机的受管对象引用 (MOR)。
    3
    指定 VMware 迁移网络的 IP 地址。

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

    $  cat << EOF | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: NetworkMap
metadata:
  name: <network_map>
  namespace: openshift-mtv
spec:
  map:
    - destination:
        name: <pod>
        namespace: openshift-mtv
        type: pod
    1 
    
      source:
    2 
    
        id: <source_network_id>
    3 
    
        name: <source_network_name>
    - destination:
        name: <network_attachment_definition>
    4 
    
        namespace: <network_attachment_definition_namespace>
    5 
    
        type: multus
      source:
        id: <source_network_id>
        name: <source_network_name>
  provider:
    source:
      name: <source_provider>
      namespace: openshift-mtv
    destination:
      name: <destination_cluster>
      namespace: openshift-mtv
EOF
    Copy to Clipboard Toggle word wrap
    1
    允许的值是 pod 和 multus。
    2
    您可以使用 id 或 name 参数来指定源网络。
    3
    指定 VMware 网络 MOR、RHV 网络 UUID 或 OpenStack 网络 UUID。
    4
    为每个额外 OpenShift Virtualization 网络指定网络附加定义。
    5
    指定 OpenShift Virtualization 网络附加定义的命名空间。

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

    $ cat << EOF | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: StorageMap
metadata:
  name: <storage_map>
  namespace: openshift-mtv
spec:
  map:
    - destination:
        storageClass: <storage_class>
        accessMode: <access_mode>
    1 
    
      source:
        id: <source_datastore>
    2 
    
    - destination:
        storageClass: <storage_class>
        accessMode: <access_mode>
      source:
        id: <source_datastore>
  provider:
    source:
      name: <source_provider>
      namespace: openshift-mtv
    destination:
      name: <destination_cluster>
      namespace: openshift-mtv
EOF
    Copy to Clipboard Toggle word wrap
    1
    允许的值有 ReadWriteOnce 和 ReadWriteMany。
    2
    指定 VMware 数据存储 MOR、RHV 存储域 UUID 或 OpenStack volume_type UUID。例如： f2737930-b567-451a-9ceb-2887f6207009。

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

    $  cat << EOF | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Hook
metadata:
  name: <hook>
  namespace: openshift-mtv
spec:
  image: quay.io/konveyor/hook-runner
    1 
    
  playbook: |
    2 
    
    LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
    YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
    IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
    cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
    bG9hZAoK
EOF
    Copy to Clipboard Toggle word wrap
    1
    您可以使用默认 hook-runner 镜像或指定自定义镜像。如果指定自定义镜像，则不需要指定 playbook。
    2
    可选： Base64 编码的 Ansible playbook。如果指定 playbook，image 必须是 hook-runner。

  7. 为迁移创建 Plan 清单： 

    $ cat << EOF | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Plan
metadata:
  name: <plan>
    1 
    
  namespace: openshift-mtv
spec:
  warm: true
    2 
    
  provider:
    source:
      name: <source_provider>
      namespace: openshift-mtv
    destination:
      name: <destination_cluster>
      namespace: openshift-mtv
  map:
    network:
    3 
    
      name: <network_map>
    4 
    
      namespace: openshift-mtv
    storage:
      name: <storage_map>
    5 
    
      namespace: openshift-mtv
  targetNamespace: openshift-mtv
  vms:
    6 
    
    - id: <source_vm>
    7 
    
    - name: <source_vm>
      hooks:
    8 
    
        - hook:
            namespace: openshift-mtv
            name: <hook>
    9 
    
          step: <step>
    10 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    指定 Plan CR 的名称。
    2
    指定迁移是温迁移还是冷迁移。如果您指定了 warm 迁移，且没有为 Migration 清单中的 cutover 参数指定一个值，则只有 precopy 阶段将运行。
    3
    您可以添加多个网络映射。
    4
    指定 NetworkMap CR 的名称。
    5
    指定 StorageMap CR 的名称。
    6
    您可以使用 id 或 name 参数来指定源虚拟机。
    7
    指定 VMware VM MOR、RHV VM UUID 或 OpenStack VM UUID。
    8
    可选：为虚拟机指定最多两个 hook。每个 hook 必须在不同的迁移步骤中运行。
    9
    指定 Hook CR 的名称。
    10
    在迁移完成后，允许的值是 PreHook （迁移计划启动或 PostHook ）。

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

    $ cat << EOF | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Migration
metadata:
  name: <migration>
    1 
    
  namespace: openshift-mtv
spec:
  plan:
    name: <plan>
    2 
    
    namespace: openshift-mtv
  cutover: <cutover_time>
    3 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    指定 Migration CR 的名称。
    2
    指定正在运行的 Plan CR 的名称。Migration CR 为每个迁移的虚拟机创建一个 VirtualMachine CR。
    3
    可选：指定 ISO 8601 格式的大约带有 UTC 时间偏移的时间，例如 2021-04-04T01:23:45.678+09:00。

    您可以将多个 Migration CR 与一个 Plan CR 关联。如果迁移没有完成，您可以在不更改 Plan CR 的情况下创建新的 Migration CR，以迁移剩余的虚拟机。

  9. 检索 Migration CR 以监控迁移的进度： 

    $ oc get migration/<migration> -n openshift-mtv -o yaml
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat