6.2. 从自定义镜像创建虚拟机

流程

1. 创建 Dockerfile 以将虚拟机镜像构建到容器镜像中。虚拟机镜像必须由 QEMU 所有，其 UID 为 107，并放置在容器内的 /disk/ 目录中。/disk/ 目录的权限必须设为 0440。

   以下示例在第一阶段使用 Red Hat Universal Base Image（UBI）来处理这些配置更改，并使用第二阶段中的最小 scratch 镜像存储结果：

   $ cat > Dockerfile << EOF
   FROM registry.access.redhat.com/ubi8/ubi:latest AS builder
   ADD --chown=107:107 <vm_image>.qcow2 /disk/ 1
   RUN chmod 0440 /disk/*
   
   FROM scratch
   COPY --from=builder /disk/* /disk/
   EOF

   1

   其中 <vm_image> 是 QCOW2 或 RAW 格式的镜像。如果使用远程镜像，请将 <vm_image>.qcow2 替换为完整的 URL。

2. 构建和标记容器：

   $ podman build -t <registry>/<container_disk_name>:latest .

3. 将容器镜像推送到 registry:

   $ podman push <registry>/<container_disk_name>:latest

先决条件

1. 运行以下命令，在默认编辑器中打开 HyperConverged CR：

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

2. 将不安全的 registry 列表添加到 spec.storageImport.insecureRegistries 字段中。

   HyperConverged 自定义资源示例

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:
     storageImport:
       insecureRegistries: 1
         - "private-registry-example-1:5000"
         - "private-registry-example-2:5000"

   1

   将此列表中的示例替换为有效的 registry 主机名。

流程

1. 在 web 控制台中进入到 Virtualization Catalog。
2. 点没有可用引导源的模板标题。
3. 点 Customize VirtualMachine。
4. 在 Customize template parameters 页面中，展开 Storage，然后从 Disk source 列表中选择 Registry (creates PVC)。
5. 输入容器镜像 URL。示例：https://mirror.arizona.edu/fedora/linux/releases/38/Cloud/x86_64/images/Fedora-Cloud-Base-38-1.6.x86_64.qcow2
6. 设置磁盘大小。
7. 点击 Next。
8. 点 Create VirtualMachine。

流程

1. 如果容器 registry 需要身份验证，请创建一个 Secret 清单，指定凭证，并将其保存为 data-source-secret.yaml 文件：

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

   1

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

   2

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

2. 运行以下命令来应用 Secret 清单：

   $ oc apply -f data-source-secret.yaml

3. 如果虚拟机必须与没有由系统 CA 捆绑包签名的证书的服务器通信，请在与虚拟机相同的命名空间中创建一个配置映射：

   $ oc create configmap tls-certs 1
     --from-file=</path/to/file/ca.pem> 2

   1

   指定配置映射名称。

   2

   指定 CA 证书的路径。

4. 编辑 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 3
           storageClassName: <storage_class> 4
         source:
           registry:
             url: "docker://kubevirt/fedora-cloud-container-disk-demo:latest" 5
             secretRef: data-source-secret 6
             certConfigMap: tls-certs 7
       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: 180
         volumes:
         - dataVolume:
             name: fedora-dv
           name: datavolumedisk1
   status: {}

   1

   指定虚拟机的名称。

   2

   指定数据卷的名称。

   3

   指定为数据卷请求的存储大小。

   4

   可选：如果您没有指定存储类，则会使用默认存储类。

   5

   指定容器 registry 的 URL。

   6

   可选：如果您为容器 registry 访问凭证创建 secret，请指定 secret 名称。

   7

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

5. 运行以下命令来创建虚拟机：

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

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

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

验证

1. importer pod 从指定的 URL 下载容器磁盘，并将其存储在置备的持久性卷中。运行以下命令，查看 importer pod 的状态：

   $ oc get pods

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

   $ oc describe dv fedora-dv 1

   1

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

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

   $ virtctl console vm-fedora-datavolume

流程

1. 在 web 控制台中进入到 Virtualization Catalog。
2. 点没有可用引导源的模板标题。
3. 点 Customize VirtualMachine。
4. 在 Customize template parameters 页面中，展开 Storage，然后从 Disk source 列表中选择 URL (creates PVC)。
5. 输入镜像 URL。示例：https://access.redhat.com/downloads/content/69/ver=/rhel---7/7.9/x86_64/product-software
6. 输入容器镜像 URL。示例：https://mirror.arizona.edu/fedora/linux/releases/38/Cloud/x86_64/images/Fedora-Cloud-Base-38-1.6.x86_64.qcow2
7. 设置磁盘大小。
8. 点击 Next。
9. 点 Create VirtualMachine。

流程

1. 如果网页需要身份验证，请创建一个 Secret 清单，指定凭证，并将其保存为 data-source-secret.yaml 文件：

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

   1

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

   2

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

2. 运行以下命令来应用 Secret 清单：

   $ oc apply -f data-source-secret.yaml

3. 如果虚拟机必须与没有由系统 CA 捆绑包签名的证书的服务器通信，请在与虚拟机相同的命名空间中创建一个配置映射：

   $ oc create configmap tls-certs 1
     --from-file=</path/to/file/ca.pem> 2

   1

   指定配置映射名称。

   2

   指定 CA 证书的路径。

4. 编辑 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 3
           storageClassName: <storage_class> 4
         source:
           http:
             url: "https://mirror.arizona.edu/fedora/linux/releases/35/Cloud/x86_64/images/Fedora-Cloud-Base-35-1.2.x86_64.qcow2" 5
           registry:
             url: "docker://kubevirt/fedora-cloud-container-disk-demo:latest" 6
             secretRef: data-source-secret 7
             certConfigMap: tls-certs 8
       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: 180
         volumes:
         - dataVolume:
             name: fedora-dv
           name: datavolumedisk1
   status: {}

   1

   指定虚拟机的名称。

   2

   指定数据卷的名称。

   3

   指定为数据卷请求的存储大小。

   4

   可选：如果您没有指定存储类，则会使用默认存储类。

   5 6

   指定网页的 URL。

   7

   可选：如果您为 Web 页面访问凭证创建了 secret，请指定 secret 名称。

   8

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

5. 运行以下命令来创建虚拟机：

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

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

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

验证

1. importer pod 从指定的 URL 下载镜像，并将其存储在置备的持久性卷上。运行以下命令，查看 importer pod 的状态：

   $ oc get pods

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

   $ oc describe dv fedora-dv 1

   1

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

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

   $ virtctl console vm-fedora-datavolume

流程

1. 在 web 控制台中进入到 Virtualization Catalog。
2. 点没有可用引导源的模板标题。
3. 点 Customize VirtualMachine。
4. 在 Customize template parameters 页面中，展开 Storage，然后从 Disk source 列表中选择 Upload (Upload a new file to a PVC)。
5. 浏览到本地机器上的镜像并设置磁盘大小。
6. 点 Customize VirtualMachine。
7. 点 Create VirtualMachine。

流程

1. 将 Windows 镜像上传为新 PVC：

   1. 在 web 控制台中进入到 Storage PersistentVolumeClaims。
   2. 点 Create PersistentVolumeClaim With Data upload form。
   3. 浏览 Windows 镜像并选择它。

   4. 输入 PVC 名称，选择存储类和大小，然后点 Upload。

      Windows 镜像上传到 PVC。

2. 通过克隆上传的 PVC 来配置新虚拟机：

   1. 进入到 Virtualization Catalog。
   2. 选择 Windows 模板标题并点 Customize VirtualMachine。
   3. 从 Disk source 列表中选择 Clone (clone PVC)。
   4. 选择 PVC 项目、Windows 镜像 PVC 和磁盘大小。

3. 将回答文件应用到虚拟机：

   1. 点 Customize VirtualMachine 参数。
   2. 在 Scripts 选项卡的 Sysprep 部分，点 Edit。
   3. 浏览到 autounattend.xml 回答文件，然后点保存。

4. 设置虚拟机的 run 策略：

   1. 清除 Start this VirtualMachine after creation，以便虚拟机不会立即启动。
   2. 点 Create VirtualMachine。
   3. 在 YAML 标签页中，将 running:false 替换为 runStrategy: RerunOnFailure，点 Save。

5. 点选项菜单 并选择 Start。

   虚拟机从包含 autounattend.xml 回答文件的 sysprep 磁盘引导。

流程

1. 运行 virtctl image-upload 命令上传镜像：

   $ virtctl image-upload dv <datavolume_name> \ 1
     --size=<datavolume_size> \ 2
     --image-path=</path/to/image> \ 3

   1

   数据卷的名称。

   2

   数据卷的大小。例如： --size=500Mi, --size=1G

   3

   镜像的文件路径。

   注意
   • 如果您不想创建新数据卷，请省略 --size 参数，并包含 --no-create 标志。
   • 将磁盘镜像上传到 PVC 时，PVC 大小必须大于未压缩的虚拟磁盘的大小。
   • 若要在使用 HTTPS 时允许不安全的服务器连接，请使用 --insecure 参数。当您使用 --insecure 标志时，不会验证上传端点的真实性。

2. 可选。要验证数据卷是否已创建，运行以下命令来查看所有数据卷：

   $ oc get dvs

流程

1. 在 web 控制台中进入到 Virtualization Catalog。
2. 点没有可用引导源的模板标题。
3. 点 Customize VirtualMachine。
4. 在 Customize template parameters 页面中，展开 Storage，然后从 Disk source 列表中选择 PVC (clone PVC)。
5. 输入镜像 URL。示例：https://access.redhat.com/downloads/content/69/ver=/rhel---7/7.9/x86_64/product-software
6. 输入容器镜像 URL。示例：https://mirror.arizona.edu/fedora/linux/releases/38/Cloud/x86_64/images/Fedora-Cloud-Base-38-1.6.x86_64.qcow2
7. 选择 PVC 项目和 PVC 名称。
8. 设置磁盘大小。
9. 点击 Next。
10. 点 Create VirtualMachine。