8.15. 导入虚拟机

流程

1. 确定您处于正确的命名空间中。配置映射只能被数据卷引用（如果位于同一命名空间中）。

   $ oc get ns

2. 创建配置映射：

   $ oc create configmap <configmap-name> --from-file=</path/to/file/ca.pem>

流程

1. 如果您的数据源需要身份验证，请创建一个 Secret 清单，指定数据源凭证，并将其保存为 endpoint-secret.yaml ：

   apiVersion: v1
   kind: Secret
   metadata:
     name: endpoint-secret 1
     labels:
       app: containerized-data-importer
   type: Opaque
   data:
     accessKeyId: "" 2
     secretKey:   "" 3

   1

   指定 Secret 的名称。

   2

   指定以 Base64 编码的密钥 ID 或用户名。

   3

   指定以 Base64 编码的 secret 密钥或密码。

2. 应用 Secret 清单：

   $ oc apply -f endpoint-secret.yaml

3. 编辑 VirtualMachine 清单，为要导入的虚拟机镜像指定数据源，并将其保存为 vm-fedora-datavolume.yaml ：

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     creationTimestamp: null
     labels:
       kubevirt.io/vm: vm-fedora-datavolume
     name: vm-fedora-datavolume 1
   spec:
     dataVolumeTemplates:
     - metadata:
         creationTimestamp: null
         name: fedora-dv 2
       spec:
         storage:
           resources:
             requests:
               storage: 10Gi
           storageClassName: local
         source:
           http: 3
             url: "https://mirror.arizona.edu/fedora/linux/releases/35/Cloud/x86_64/images/Fedora-Cloud-Base-35-1.2.x86_64.qcow2" 4
             secretRef: endpoint-secret 5
             certConfigMap: "" 6
       status: {}
     running: true
     template:
       metadata:
         creationTimestamp: null
         labels:
           kubevirt.io/vm: vm-fedora-datavolume
       spec:
         domain:
           devices:
             disks:
             - disk:
                 bus: virtio
               name: datavolumedisk1
           machine:
             type: ""
           resources:
             requests:
               memory: 1.5Gi
         terminationGracePeriodSeconds: 60
         volumes:
         - dataVolume:
             name: fedora-dv
           name: datavolumedisk1
   status: {}

   1

   指定虚拟机的名称。

   2

   指定数据卷的名称。

   3

   为 HTTP 或 HTTPS 端点指定 http。为从 registry 导入的容器磁盘镜像指定 registry。

   4

   要导入的虚拟机镜像的源。本例引用了 HTTPS 端点上的虚拟机镜像。容器镜像仓库端点示例为 url: "docker://kubevirt/fedora-cloud-container-disk-demo:latest"。

   5

   如果您为数据源创建 Secret，则需要此项。

   6

   可选：指定一个 CA 证书配置映射。

4. 创建虚拟机：

   $ oc create -f vm-fedora-datavolume.yaml

   注意

   oc create 命令创建数据卷和虚拟机。CDI 控制器创建一个带有正确注解和导入过程的底层 PVC。导入完成后，数据卷状态变为 Succeeded。您可以启动虚拟机。

   数据卷置备在后台进行，因此无需监控进程。

验证

1. importer pod 从指定的 URL 下载虚拟机镜像或容器磁盘，并将其存储在置备的 PV 上。运行以下命令，查看 importer pod 的状态：

   $ oc get pods

2. 运行以下命令监控数据卷，直到其状态为 Succeeded ：

   $ oc describe dv fedora-dv 1

   1

   指定您在 VirtualMachine 清单中定义的数据卷名称。

3. 通过访问其串行控制台来验证置备是否已完成，并且虚拟机是否已启动：

   $ virtctl console vm-fedora-datavolume

流程

1. 以 root 身份登录节点，在其上创建本地 PV。本流程以 node01 为例。

2. 创建一个文件并用空字符填充，以便可将其用作块设备。以下示例创建 loop10 文件，大小为 2Gb（20,100 Mb 块）：

   $ dd if=/dev/zero of=<loop10> bs=100M count=20

3. 将 loop10 文件挂载为 loop 设备。

   $ losetup </dev/loop10>d3 <loop10> 1 2

   1

   挂载 loop 设备的文件路径。

   2

   上一步中创建的文件，挂载为 loop 设备。

4. 创建引用所挂载 loop 设备的 PersistentVolume 清单。

   kind: PersistentVolume
   apiVersion: v1
   metadata:
     name: <local-block-pv10>
     annotations:
   spec:
     local:
       path: </dev/loop10> 1
     capacity:
       storage: <2Gi>
     volumeMode: Block 2
     storageClassName: local 3
     accessModes:
       - ReadWriteOnce
     persistentVolumeReclaimPolicy: Delete
     nodeAffinity:
       required:
         nodeSelectorTerms:
         - matchExpressions:
           - key: kubernetes.io/hostname
             operator: In
             values:
             - <node01> 4

   1

   节点上的 loop 设备路径。

   2

   将其指定为块 PV。

   3

   可选：为 PV 设置存储类。如果省略此项，将使用默认集群。

   4

   挂载块设备的节点。

5. 创建块 PV。

   # oc create -f <local-block-pv10.yaml>1

   1

   上一步中创建的持久性卷的文件名。

流程

1. 如果您的数据源需要身份验证，请创建一个 Secret 清单，指定数据源凭证，并将其保存为 endpoint-secret.yaml ：

   apiVersion: v1
   kind: Secret
   metadata:
     name: endpoint-secret 1
     labels:
       app: containerized-data-importer
   type: Opaque
   data:
     accessKeyId: "" 2
     secretKey:   "" 3

   1

   指定 Secret 的名称。

   2

   指定以 Base64 编码的密钥 ID 或用户名。

   3

   指定以 Base64 编码的 secret 密钥或密码。

2. 应用 Secret 清单：

   $ oc apply -f endpoint-secret.yaml

3. 创建 DataVolume 清单，为虚拟机镜像指定数据源，并为 storage.volumeMode 指定 Block。

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: DataVolume
   metadata:
     name: import-pv-datavolume 1
   spec:
     storageClassName: local 2
       source:
         http:
           url: "https://mirror.arizona.edu/fedora/linux/releases/35/Cloud/x86_64/images/Fedora-Cloud-Base-35-1.2.x86_64.qcow2" 3
           secretRef: endpoint-secret 4
     storage:
       volumeMode: Block 5
       resources:
         requests:
           storage: 10Gi

   1

   指定数据卷的名称。

   2

   可选：设置存储类，或忽略此项，接受集群默认值。

   3

   指定要导入的镜像的 HTTP 或 HTTPS URL。

   4

   如果您为数据源创建 Secret，则需要此项。

   5

   对于已知的存储置备程序，会自动检测到卷模式和访问模式。否则，指定 Block。

4. 创建数据卷来导入虚拟机镜像：

   $ oc create -f import-pv-datavolume.yaml

1. PVC 必须请求 ReadWriteMany 访问模式。
2. PVC 必须请求 ReadWriteOnce 访问模式。

流程

1. 在 web 控制台中，点 Workloads Virtual Machines。
2. 点击 Create Virtual Machine 并选择 Import with Wizard。
3. 从 Provider 列表中选择 Red Hat Virtualization (RHV)。

4. 选择 Connect to New Instance，或一个保存的 RHV 实例。

   • 如果选择 Connect to New Instance，请填写以下字段：

     • API URL：例如 https://<RHV_Manager_FQDN>/ovirt-engine/api

     • CA certificate：点 Browse 上传 RHV Manager CA 证书或将 CA 证书粘贴到字段。

       您可以运行以下命令来查看 CA 证书：

       $ openssl s_client -connect <RHV_Manager_FQDN>:443 -showcerts < /dev/null

       CA 证书是输出中的第二个证书。

     • Username：RHV Manager 的用户名，例如 ocpadmin@internal
     • Password: RHV Manager 密码
   • 如果您选择了一个保存的 RHV 实例，向导将使用保存的凭证连接到 RHV 实例。

5. 点击 Check and Save，然后等待连接完成。

   注意

   连接详情存储在 secret 中。如果您提供的供应商带有不正确的 URL、用户名或密码，点 Workloads Secrets 并删除供应商 secret。

6. 选择一个集群和一个虚拟机。
7. 点 Next。
8. 在 Review 屏幕中，查看您的设置。
9. 可选：您可以选择 Start virtual machine on creation。

10. 点 Edit 以更新以下设置：

    • General Name：虚拟机名称限制为 63 个字符。

    • General Description: 虚拟机的描述信息（可选）。

      • Storage Class：选择 NFS 或 ocs-storagecluster-ceph-rbd。

        如果选择 ocs-storagecluster-ceph-rbd，您必须将磁盘的 Volume Mode 设置为 Block。

      • advanced Volume Mode: 选择 Block。
    • advanced Volume Mode: 选择 Block。
    • networking Network：您可以从可用网络附加定义对象列表中选择网络。

11. 如果您编辑了导入设置，点 Import 或 Review and Import。

    此时会显示 Successfully created virtual machine 消息以及为虚拟机创建的资源列表。虚拟机会出现在 Workloads Virtual Machines 中。

1. 您可以使用命令行界面更改访问模式。

流程

1. 运行以下命令来创建 Secret CR:

   $ cat <<EOF | oc create -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: rhv-credentials
     namespace: default 1
   type: Opaque
   stringData:
     ovirt: |
       apiUrl: <api_endpoint> 2
       username: ocpadmin@internal
       password: 3
       caCert: |
         -----BEGIN CERTIFICATE-----
         4
         -----END CERTIFICATE-----
   EOF

   1

   可选。您可以在所有 CR 中指定不同的命名空间。

   2

   指定 RHV Manager 的 API 端点，如 \"https://www.example.com:8443/ovirt-engine/api"。

   3

   指定 ocpadmin@internal 的密码。

   4

   指定 RHV Manager CA 证书。您可以运行以下命令来获取 CA 证书：

   $ openssl s_client -connect :443 -showcerts < /dev/null

2. 可选：运行以下命令，创建 ResourceMapping CR，以将资源映射与 VirtualMachineImport CR 分开：

   $ cat <<EOF | kubectl create -f -
   apiVersion: v2v.kubevirt.io/v1alpha1
   kind: ResourceMapping
   metadata:
     name: resourcemapping_example
     namespace: default
   spec:
     ovirt:
       networkMappings:
         - source:
             name: <rhv_logical_network>/<vnic_profile> 1
           target:
             name: <target_network> 2
           type: pod
       storageMappings: 3
         - source:
             name: <rhv_storage_domain> 4
           target:
             name: <target_storage_class> 5
           volumeMode: <volume_mode> 6
   EOF

   1

   指定 RHV 逻辑网络和 vNIC 配置集。

   2

   指定 OpenShift Virtualization 网络。

   3

   如果在 ResourceMapping 和 VirtualMachineImport CR 中都指定了存储映射，则 VirtualMachineImport CR 将具有优先权。

   4

   指定 RHV 存储域。

   5

   指定 nfs 或 ocs-storagecluster-ceph-rbd。

   6

   如果指定了 ocs-storagecluster-ceph-rbd 存储类，则必须将 Block 指定为卷模式。

3. 运行以下命令来创建 VirtualMachineImport CR:

   $ cat <<EOF | oc create -f -
   apiVersion: v2v.kubevirt.io/v1beta1
   kind: VirtualMachineImport
   metadata:
     name: vm-import
     namespace: default
   spec:
     providerCredentialsSecret:
       name: rhv-credentials
       namespace: default
   # resourceMapping: 1
   #   name: resourcemapping-example
   #   namespace: default
     targetVmName: vm_example 2
     startVm: true
     source:
       ovirt:
         vm:
           id: <source_vm_id> 3
           name: <source_vm_name> 4
         cluster:
           name: <source_cluster_name> 5
         mappings: 6
           networkMappings:
             - source:
                 name: <source_logical_network>/<vnic_profile> 7
               target:
                 name: <target_network> 8
               type: pod
           storageMappings: 9
             - source:
                 name: <source_storage_domain> 10
               target:
                 name: <target_storage_class> 11
               accessMode: <volume_access_mode> 12
           diskMappings:
             - source:
                 id: <source_vm_disk_id> 13
               target:
                 name: <target_storage_class> 14
   EOF

   1

   如果创建一个 ResourceMapping CR，取消 resourceMapping 部分的注释。

   2

   指定目标虚拟机名称。

   3

   指定源虚拟机 ID，例如 80554327-0569-496b-bdeb-fcbbf52b827b。您可以通过在 Manager 机器的网页浏览器中输入 https://www.example.com/ovirt-engine/api/vms/ 来列出所有虚拟机来获取虚拟机 ID。找到您要导入的虚拟机及其对应的虚拟机 ID。您不需要指定虚拟机名称或集群名称。

   4

   如果指定源虚拟机名称，还必须同时指定源集群。不要指定源虚拟机 ID。

   5

   如果指定源集群，还必须指定源虚拟机名称。不要指定源虚拟机 ID。

   6

   如果创建一个 ResourceMapping CR，注释掉 mappings 部分。

   7

   指定源虚拟机的逻辑网络和 vNIC 配置集。

   8

   指定 OpenShift Virtualization 网络。

   9

   如果在 ResourceMapping 和 VirtualMachineImport CR 中都指定了存储映射，则 VirtualMachineImport CR 将具有优先权。

   10

   指定源存储域。

   11

   指定目标存储类。

   12

   指定 ReadWriteOnce、ReadWriteMany 或 ReadOnlyMany。如果没有指定访问模式，{virt} 会根据 RHV VM 的 Host Migration 模式 或虚拟磁盘访问模式决定正确的卷访问模式：

   • 如果 RHV VM 迁移模式是 Allow manual and automatic migration，则默认访问模式为 ReadWriteMany。
   • 如果 RHV 虚拟磁盘访问模式是 ReadOnly，则默认访问模式为 ReadOnlyMany。
   • 对于所有其他设置，默认的访问模式为 ReadWriteOnce。

   13

   指定源虚拟机磁盘 ID，例如 8181ecc1-5db8-4193-9c92-3ddab3be7b05。您可以通过在 Manager 机器的网页浏览器中输入 https://www.example.com/ovirt-engine/api/vms/vm23 并查看虚拟机详情来获取磁盘 ID。

   14

   指定目标存储类。

4. 按照虚拟机导入的过程，以验证导入是否成功：

   $ oc get vmimports vm-import -n default

   显示成功导入的输出结果类似如下：

   输出示例

   ...
   status:
     conditions:
     - lastHeartbeatTime: "2020-07-22T08:58:52Z"
       lastTransitionTime: "2020-07-22T08:58:52Z"
       message: Validation completed successfully
       reason: ValidationCompleted
       status: "True"
       type: Valid
     - lastHeartbeatTime: "2020-07-22T08:58:52Z"
       lastTransitionTime: "2020-07-22T08:58:52Z"
       message: 'VM specifies IO Threads: 1, VM has NUMA tune mode specified: interleave'
       reason: MappingRulesVerificationReportedWarnings
       status: "True"
       type: MappingRulesVerified
     - lastHeartbeatTime: "2020-07-22T08:58:56Z"
       lastTransitionTime: "2020-07-22T08:58:52Z"
       message: Copying virtual machine disks
       reason: CopyingDisks
       status: "True"
       type: Processing
     dataVolumes:
     - name: fedora32-b870c429-11e0-4630-b3df-21da551a48c0
     targetVmName: fedora32

1. PVC 必须请求 ReadWriteMany 访问模式。
2. PVC 必须请求 ReadWriteOnce 访问模式。

流程

1. 在 web 控制台中，点 Workloads Virtual Machines。
2. 点击 Create Virtual Machine 并选择 Import with Wizard。
3. 从 Provider 列表中选择 VMware。

4. 选择 Connect to New Instance 或一个保存的 vCenter 示例。

   • 如果您选择 Connect to New Instance，输入 vCenter hostname、Username 和 Password。
   • 如果您选择了一个保存的 vCenter 实例，向导将使用保存的凭证连接到 vCenter 实例。

5. 点击 Check and Save，然后等待连接完成。

   注意

   连接详情存储在 secret 中。如果您添加的供应商带有不正确的主机名、用户名或密码，点 Workloads Secrets 并删除供应商 secret。

6. 选择一个虚拟机或一个模板。
7. 点 Next。
8. 在 Review 屏幕中，查看您的设置。

9. 点 Edit 以更新以下设置：

   • General:

     • 描述
     • 操作系统
     • Flavor
     • 内存
     • CPU
     • Workload Profile

   • Networking:

     • 名称
     • Model
     • 网络
     • 类型
     • MAC 地址

   • Storage：点击 VM 磁盘 的 Options 菜单，然后选择 Edit 来更新以下字段：

     • 名称
     • Source：例如 Import Disk。
     • Size
     • Interface

     • Storage Class:选择 NFS 或 ocs-storagecluster-ceph-rbd(ceph-rbd)。

       如果选择 ocs-storagecluster-ceph-rbd，您必须将磁盘的 Volume Mode 设置为 Block。

       其他存储类可能会正常工作，但不被正式支持。

     • advanced Volume Mode: 选择 Block。
     • Advanced Access Mode

   • Advanced Cloud-init:

     • Form: 输入 Hostname 和 Authenticated SSH Keys.
     • Custom script: 在文本字段中输入 cloud-init 脚本。
   • Advanced Virtual Hardware：您可以将虚拟 CD-ROM 附加到导入的虚拟机。

10. 如果您编辑了导入设置，点 Import 或 Review and Import。

    此时会显示 Successfully created virtual machine 消息以及为虚拟机创建的资源列表。虚拟机会出现在 Workloads Virtual Machines 中。