8.18. 虚拟机磁盘

1. PVC 必须请求 ReadWriteMany 访问模式。
2. 存储供应商必须支持 Kubernetes 和 CSI 快照 API

流程

1. 创建 MachineConfig 文件。例如：

   $ touch machineconfig.yaml

2. 编辑该文件，确保包含希望 hostpath 置备程序在其中创建 PV 的目录。例如：

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     name: 50-set-selinux-for-hostpath-provisioner
     labels:
       machineconfiguration.openshift.io/role: worker
   spec:
     config:
       ignition:
         version: 3.2.0
       systemd:
         units:
           - contents: |
               [Unit]
               Description=Set SELinux chcon for hostpath provisioner
               Before=kubelet.service
   
               [Service]
               ExecStart=/usr/bin/chcon -Rt container_file_t <backing_directory_path> 1
   
               [Install]
               WantedBy=multi-user.target
             enabled: true
             name: hostpath-provisioner.service

   1

   指定希望置备程序在其中创建 PV 的后备目录。该目录不能位于文件系统的根目录（/）中。

3. 创建 MachineConfig 对象：

   $ oc create -f machineconfig.yaml -n <namespace>

流程

1. 创建 HostPathProvisioner 自定义资源文件。例如：

   $ touch hostpathprovisioner_cr.yaml

2. 编辑该文件，确保 spec.pathConfig.path 值是您希望 hostpath 置备程序在其中创建 PV 的目录。例如：

   apiVersion: hostpathprovisioner.kubevirt.io/v1beta1
   kind: HostPathProvisioner
   metadata:
     name: hostpath-provisioner
   spec:
     imagePullPolicy: IfNotPresent
     pathConfig:
       path: "<backing_directory_path>" 1
       useNamingPrefix: false 2
     workload: 3

   1

   指定希望置备程序在其中创建 PV 的后备目录。该目录不能位于文件系统的根目录（/）中。

   2

   如果要使用绑定到所创建的 PV 的持久性卷声明（PVC）名称作为目录名的前缀，请将该值更改为 true。

   3

   可选： 您可以使用 spec.workload 字段为 hostpath 置备程序配置节点放置规则。

   注意

   如果您没有创建后备目录，则置备程序会尝试为您创建该目录。如果您没有应用 container_file_t SELinux 上下文，这会导致 Permission denied。

3. 在 openshift-cnv 命名空间中创建自定义资源：

   $ oc create -f hostpathprovisioner_cr.yaml -n openshift-cnv

流程

1. 创建用于定义存储类的 YAML 文件。例如：

   $ touch storageclass.yaml

2. 编辑该文件。例如：

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: hostpath-provisioner 1
   provisioner: kubevirt.io/hostpath-provisioner
   reclaimPolicy: Delete 2
   volumeBindingMode: WaitForFirstConsumer 3

   1

   您可以通过更改此值来选择性地重命名存储类。

   2

   两个可能的 reclaimPolicy 值为 Delete 和 Retain。如果您没有指定值，则存储类默认为 Delete。

   3

   volumeBindingMode 值决定何时发生动态置备和卷绑定。指定 WaitForFirstConsumer，将 PV 的绑定和置备延迟到创建使用 PVC 的 Pod 后。这样可确保 PV 满足 pod 的调度要求。

   注意

   虚拟机使用基于本地 PV 的数据卷。本地 PV 与特定节点绑定。虽然磁盘镜像准备供虚拟机消耗，但可能不会将虚拟机调度到之前固定本地存储 PV 的节点。

   要解决这个问题，使用 Kubernetes pod 调度程序将 PVC 绑定到正确的节点上的 PV。通过使用 volumeBindingMode 设置为 WaitForFirstConsumer 的 StorageClass，PV 的绑定和置备会延迟到 Pod 创建前。

3. 创建 StorageClass 对象：

   $ oc create -f storageclass.yaml

流程

1. 编辑存储配置文件。在本例中，CDI 不支持置备程序：

   $ oc edit -n openshift-cnv storageprofile <storage_class>

   存储配置集示例

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: StorageProfile
   metadata:
     name: <unknown_provisioner_class>
   #   ...
   spec: {}
   status:
     provisioner: <unknown_provisioner>
     storageClass: <unknown_provisioner_class>

2. 在存储配置集中提供所需的属性值：

   存储配置集示例

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: StorageProfile
   metadata:
     name: <unknown_provisioner_class>
   #   ...
   spec:
     claimPropertySets:
     - accessModes:
       - ReadWriteOnce 1
       volumeMode:
         Filesystem 2
   status:
     provisioner: <unknown_provisioner>
     storageClass: <unknown_provisioner_class>

   1

   您选择的 accessModes。

   2

   您选择的 volumeMode。

   保存更改后，所选值将显示在存储配置集的 status 项中。

流程

1. 运行以下命令来编辑 HyperConverged CR：

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

2. 将 spec.resourceRequirements.storageWorkloads 小节添加到 CR，根据您的用例设置值。例如：

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     resourceRequirements:
       storageWorkloads:
         limits:
           cpu: "500m"
           memory: "2Gi"
         requests:
           cpu: "250m"
           memory: "1Gi"

3. 保存并退出编辑器以更新 HyperConverged CR。

流程

1. 在 web 控制台的侧边菜单中点击 Storage Persistent Volume Claims。
2. 点 Create Persistent Volume Claim 下拉列表展开它。
3. 点 With Data Upload Form 打开 Upload Data to Persistent Volume Claim 页面。
4. 点 Browse 打开文件管理器并选择要上传的镜像，或者将文件拖到 Drag a file here or browse to upload 项中。

5. 可选：将此镜像设置为特定操作系统的默认镜像。

   1. 选择 Attach this data to a virtual machine operating system 复选框。
   2. 从列表中选择一个操作系统。
6. Persistent Volume Claim Name 字段自动填充唯一名称，且无法编辑。记录分配给 PVC 的名称，以便以后根据需要指定它。
7. 从 Storage Class 列表中选择存储类。

8. 在 Size 字段中输入 PVC 的大小值。从下拉列表中选择对应的度量单位。

   警告

   PVC 大小必须大于未压缩的虚拟磁盘的大小。

9. 选择与您选择的存储类匹配的 Access Mode。
10. 点 Upload。

流程

1. 创建指定 spec: source: upload{} 的数据卷配置：

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: DataVolume
   metadata:
     name: <upload-datavolume> 1
   spec:
     source:
         upload: {}
     pvc:
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: <2Gi> 2

   1

   数据卷的名称。

   2

   数据卷的大小。请确定这个值大于或等于您要上传的磁盘的大小。

2. 运行以下命令来创建数据卷：

   $ oc create -f <upload-datavolume>.yaml

流程

1. 确定以下各项：

   • 要使用的上传数据卷的名称。如果这个数据卷不存在，则会自动创建。
   • 在上传过程中创建数据卷的大小。大小必须大于或等于磁盘镜像的大小。
   • 要上传的虚拟机磁盘镜像的文件位置。

2. 运行 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 标志时，不会验证上传端点的真实性。

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

   $ oc get dvs

流程

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. 创建指定 spec: source: upload{} 的数据卷配置：

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: DataVolume
   metadata:
     name: <upload-datavolume> 1
   spec:
     source:
         upload: {}
     pvc:
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: <2Gi> 2

   1

   数据卷的名称。

   2

   数据卷的大小。请确定这个值大于或等于您要上传的磁盘的大小。

2. 运行以下命令来创建数据卷：

   $ oc create -f <upload-datavolume>.yaml

流程

1. 确定以下各项：

   • 要使用的上传数据卷的名称。如果这个数据卷不存在，则会自动创建。
   • 在上传过程中创建数据卷的大小。大小必须大于或等于磁盘镜像的大小。
   • 要上传的虚拟机磁盘镜像的文件位置。

2. 运行 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 标志时，不会验证上传端点的真实性。

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

   $ oc get dvs

流程

1. 通过其中一个控制台或通过 SSH 访问虚拟机命令行。

2. 在虚拟机上安装 QEMU 客户机代理：

   $ yum install -y qemu-guest-agent

3. 确保服务持久并启动它：

   $ systemctl enable --now qemu-guest-agent

流程

1. 从侧边菜单中点 Workloads Virtualization。
2. 点 Virtual Machines 标签页。
3. 选择虚拟机以打开 Virtual Machine Overview 屏幕。
4. 如果虚拟机正在运行，请点 Actions Stop Virtual Machine 关闭它。
5. 点 Snapshots 标签页，然后点 Take Snapshot。
6. 填写 Snapshot Name 和可选的 Description 字段。
7. 扩展 Disks included in this Snapshot 以查看快照中包含的存储卷。
8. 如果您的虚拟机磁盘无法包含在快照中，并且您仍然希望继续，请选择 I am aware of this warning and wish to proceed 复选框。
9. 点 Save。

流程

1. 创建一个 YAML 文件来定义 VirtualMachineSnapshot 对象，以指定新 VirtualMachineSnapshot 的名称和源虚拟机的名称。

   例如：

   apiVersion: snapshot.kubevirt.io/v1alpha1
   kind: VirtualMachineSnapshot
   metadata:
     name: my-vmsnapshot 1
   spec:
     source:
       apiGroup: kubevirt.io
       kind: VirtualMachine
       name: my-vm 2

   1

   新的 VirtualMachineSnapshot 对象的名称。

   2

   源虚拟机的名称。

2. 创建 VirtualMachineSnapshot 资源。快照控制器会创建一个 VirtualMachineSnapshotContent 对象，将其绑定到 VirtualMachineSnapshot 并更新 VirtualMachineSnapshot 对象的 status 和 readyToUse 字段。

   $ oc create -f <my-vmsnapshot>.yaml

3. 可选： 如果要执行在线快照，您可以使用 wait 命令并监控快照的状态：

   1. 输入以下命令：

      $ oc wait my-vm my-vmsnapshot --for condition=Ready

   2. 验证快照的状态：

      • InProgress - 在线快照操作仍在进行中。
      • succeeded - 在线快照操作成功完成。

      • Failed - 在线快照操作失败。

        注意

        在线快照的默认时间期限为五分钟(5m)。如果快照在五分钟内没有成功完成，其状态将设为 failed。之后，文件系统将被”解冻”，虚拟机将取消冻结，但状态会一直 failed，直到您删除失败的快照镜像。

        要更改默认时间期限，在 VM 快照 spec 中添加 FailureDeadline 属性，指定在快照超时前的时间，以分钟(m)或秒(s)为单位。

        要设置截止时间，您可以指定 0，但通常不建议这样做，因为它可能会导致虚拟机没有响应。

        如果您没有指定时间单位，如 m 或 s，则默认为 秒(s)。

验证

1. 验证 VirtualMachineSnapshot 对象是否已创建并绑定到 VirtualMachineSnapshotContent。readyToUse 标志必须设为 true。

   $ oc describe vmsnapshot <my-vmsnapshot>

   输出示例

   apiVersion: snapshot.kubevirt.io/v1alpha1
   kind: VirtualMachineSnapshot
   metadata:
     creationTimestamp: "2020-09-30T14:41:51Z"
     finalizers:
     - snapshot.kubevirt.io/vmsnapshot-protection
     generation: 5
     name: mysnap
     namespace: default
     resourceVersion: "3897"
     selfLink: /apis/snapshot.kubevirt.io/v1alpha1/namespaces/default/virtualmachinesnapshots/my-vmsnapshot
     uid: 28eedf08-5d6a-42c1-969c-2eda58e2a78d
   spec:
     source:
       apiGroup: kubevirt.io
       kind: VirtualMachine
       name: my-vm
   status:
     conditions:
     - lastProbeTime: null
       lastTransitionTime: "2020-09-30T14:42:03Z"
       reason: Operation complete
       status: "False" 1
       type: Progressing
     - lastProbeTime: null
       lastTransitionTime: "2020-09-30T14:42:03Z"
       reason: Operation complete
       status: "True" 2
       type: Ready
     creationTime: "2020-09-30T14:42:03Z"
     readyToUse: true 3
     sourceUID: 355897f3-73a0-4ec4-83d3-3c2df9486f4f
     virtualMachineSnapshotContentName: vmsnapshot-content-28eedf08-5d6a-42c1-969c-2eda58e2a78d 4

   1

   Progressing 的 status 字段指定快照是否仍然在创建。

   2

   Ready 条件的 status 字段指定快照创建过程是否完成。

   3

   指定快照是否准备就绪可用被使用。

   4

   指定快照被绑定到快照控制器创建的 VirtualMachineSnapshotContent 对象。

2. 检查 VirtualMachineSnapshotContent 资源的 spec:volumeBackups 属性，以验证快照中包含了预期的 PVC。

流程

1. 通过执行以下操作之一来显示快照的输出：

   • 对于使用 CLI 创建的快照，请查看 VirtualMachineSnapshot 对象 YAML 中的 status 字段中的指示器输出。
   • 对于使用 Web 控制台创建的快照，请点击 Snapshot details 屏幕中的 VirtualMachineSnapshot > Status。

2. 验证在线虚拟机快照的状态：

   • Online 代表虚拟机在在线快照创建期间运行。
   • NoGuestAgent 表示 QEMU 客户机代理在在线快照创建过程中没有运行。QEMU 客户机代理无法用于冻结和构建文件系统，要么因为 QEMU 客户机代理尚未安装或正在运行，要么是因为另一个错误。

流程

1. 从侧边菜单中点 Workloads Virtualization。
2. 点 Virtual Machines 标签页。
3. 选择虚拟机以打开 Virtual Machine Overview 屏幕。
4. 如果虚拟机正在运行，请点 Actions Stop Virtual Machine 关闭它。
5. 点 Snapshots 标签页。该页面显示与虚拟机关联的快照列表。

6. 选择以下方法之一恢复虚拟机快照：

   1. 对于您要用作恢复虚拟机的源的快照，点 Restore。
   2. 选择快照以打开 Snapshot Details 屏幕，然后点 Actions Restore Virtual Machine Snapshot。
7. 在确认弹出窗口中，点 Restore 可将虚拟机恢复到快照代表的以前的配置中。

流程

1. 创建一个 YAML 文件来定义 VirtualMachineRestore 对象，它指定您要恢复的虚拟机的名称以及要用作源的快照名称。

   例如：

   apiVersion: snapshot.kubevirt.io/v1alpha1
   kind: VirtualMachineRestore
   metadata:
     name: my-vmrestore 1
   spec:
     target:
       apiGroup: kubevirt.io
       kind: VirtualMachine
       name: my-vm 2
     virtualMachineSnapshotName: my-vmsnapshot 3

   1

   新 VirtualMachineRestore 对象的名称。

   2

   要恢复的目标虚拟机的名称。

   3

   作为源的 VirtualMachineSnapshot 对象的名称。

2. 创建 VirtualMachineRestore 资源。快照控制器更新了 VirtualMachineRestore 对象的 status 字段，并将现有虚拟机配置替换为快照内容。

   $ oc create -f <my-vmrestore>.yaml

流程

1. 从侧边菜单中点 Workloads Virtualization。
2. 点 Virtual Machines 标签页。
3. 选择虚拟机以打开 Virtual Machine Overview 屏幕。
4. 点 Snapshots 标签页。该页面显示与虚拟机关联的快照列表。

5. 选择以下方法之一删除虚拟机快照：

   1. 点您要删除的虚拟机快照 的 Options 菜单，然后选择 Delete Virtual Machine Snapshot。
   2. 选择快照以打开 Snapshot Details 屏幕，然后点 Actions Delete Virtual Machine Snapshot。
6. 在确认弹出窗口中点 Delete 删除快照。

流程

1. 在节点上创建新本地 PV，或使用已有的本地 PV:

   • 创建包含 nodeAffinity.nodeSelectorTerms 参数的本地 PV。以下 manifest 在 node01 上创建了一个 10Gi 的本地 PV。

     kind: PersistentVolume
     apiVersion: v1
     metadata:
       name: <destination-pv> 1
       annotations:
     spec:
       accessModes:
       - ReadWriteOnce
       capacity:
         storage: 10Gi 2
       local:
         path: /mnt/local-storage/local/disk1 3
       nodeAffinity:
         required:
           nodeSelectorTerms:
           - matchExpressions:
             - key: kubernetes.io/hostname
               operator: In
               values:
               - node01 4
       persistentVolumeReclaimPolicy: Delete
       storageClassName: local
       volumeMode: Filesystem

     1

     PV 的名称。

     2

     PV 的大小。您必须分配足够空间，否则克隆操作会失败。其大小不得低于源 PVC。

     3

     节点上的挂载路径。

     4

     要创建 PV 的节点的名称。

   • 已存在于节点上的一个 PV。您可以通过查看其配置中的 nodeAffinity 字段来标识置备 PV 的节点：

     $ oc get pv <destination-pv> -o yaml

     以下输出显示 PV 位于 node01:

     输出示例

     ...
     spec:
       nodeAffinity:
         required:
           nodeSelectorTerms:
           - matchExpressions:
             - key: kubernetes.io/hostname 1
               operator: In
               values:
               - node01 2
     ...

     1

     Kubernetes.io/hostname 使用节点主机名来选择节点。

     2

     节点的主机名。

2. 为 PV 添加唯一标签：

   $ oc label pv <destination-pv> node=node01

3. 创建引用以下内容的数据卷清单：

   • 虚拟机的 PVC 名称和命名空间。
   • 应用上一步中的 PV 标签。

   • 目标 PV 的大小。

     apiVersion: cdi.kubevirt.io/v1beta1
     kind: DataVolume
     metadata:
       name: <clone-datavolume> 1
     spec:
       source:
         pvc:
           name: "<source-vm-disk>" 2
           namespace: "<source-namespace>" 3
       pvc:
         accessModes:
           - ReadWriteOnce
         selector:
           matchLabels:
             node: node01 4
         resources:
           requests:
             storage: <10Gi> 5

     1

     新数据卷的名称。

     2

     源 PVC 的名称。如果您不知道 PVC 名称，您可以在虚拟机配置中找到它： spec.volumes.persistentVolumeClaim.claimName。

     3

     源 PVC 所在的命名空间。

     4

     应用于上一步中 PV 的标签。

     5

     目标 PV 的大小。

4. 通过将数据卷清单应用到集群来开始克隆操作：

   $ oc apply -f <clone-datavolume.yaml>

流程

1. 编辑 DataVolume 清单：

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: DataVolume
   metadata:
     name: blank-image-datavolume
   spec:
     source:
         blank: {}
     pvc:
       # Optional: Set the storage class or omit to accept the default
       # storageClassName: "hostpath"
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: 500Mi

2. 运行以下命令，创建空白磁盘镜像：

   $ oc create -f <blank-image-datavolume>.yaml

1. 创建源持久性卷声明（PVC）的快照。
2. 从快照创建一个 PVC。
3. 快照被删除。

1. 为 DataVolume 对象创建一个 YAML 文件，用于指定新数据卷的名称以及源 PVC 的名称和命名空间。在这个示例中，因为指定了 storage API，因此不需要指定 accessModes 或 volumeMode。将自动为您计算最佳值。

   apiVersion: cdi.kubevirt.io/v1beta1
   kind: DataVolume
   metadata:
     name: <cloner-datavolume> 1
   spec:
     source:
       pvc:
         namespace: "<source-namespace>" 2
         name: "<my-favorite-vm-disk>" 3
     storage: 4
       resources:
         requests:
           storage: <2Gi> 5

   1

   新数据卷的名称。

   2

   源 PVC 所在的命名空间。

   3

   源 PVC 的名称。

   4

   使用 storage API 指定分配

   5

   新数据卷的大小。

2. 通过创建数据卷开始克隆 PVC:

   $ oc create -f <cloner-datavolume>.yaml

   注意

   在 PVC 就绪前，DataVolume 会阻止虚拟机启动，以便您可以在 PVC 克隆期间创建引用新数据卷的虚拟机。

流程

1. 在 OpenShift Virtualization 控制台中，从侧边菜单中点击 Workloads Virtualization。
2. 点 Templates 选项卡。
3. 找到您要为其配置引导源的 RHEL 模板并点 Add source。
4. 在 Add boot source to template 窗口中，从 Boot source type 列表中选择 Import via URL(creates PVC)。
5. 点击 RHEL 下载页面 访问红帽客户门户。下载 Red Hat Enterprise Linux 页面中显示可用安装程序和镜像的列表。
6. 确定您要下载的 Red Hat Enterprise Linux KVM 客户机镜像。右键单击 Download Now，再复制镜像的 URL。
7. 在 Add boot source to template 窗口中，将 guest 镜像的复制 URL 粘贴到 Import URL 字段中，然后单击 Save and import。

1. 点 Templates 选项卡。
2. 确认此模板的标题显示绿色勾号。

流程

1. 在 OpenShift Virtualization 控制台中，从侧边菜单中点击 Workloads Virtualization。
2. 点 Templates 选项卡。
3. 找到您要配置引导源的虚拟机模板并点击 Add source。
4. 在 Add boot source to template 窗口中，点 Select boot source，选择创建持久性卷声明（PVC）的方法： Upload local file、Import via URL、Clone existing PVC 或 Import via Registry。
5. 可选：点 This is a CD-ROM boot source 来挂载 CD-ROM，并使用它将操作系统安装到空磁盘。OpenShift Virtualization 会自动创建并挂载额外的空磁盘。如果不需要额外磁盘，您可以在创建虚拟机时将其删除。

6. 为 持久性卷声明大小 输入一个值，以指定适合未压缩镜像的 PVC 大小，以及任何需要的额外空间。

   1. 可选：输入 Source 供应商 名称以将名称与此模板关联。

   2. 可选 ：高级存储设置：点 Storage class 并选择用于创建磁盘的存储类。通常，这个存储类是创建供所有 PVC 使用的默认存储类。

      注意

      提供的引导源会自动更新至操作系统的最新版本。对于自动更新的引导源，持久性卷声明(PVC)使用集群的默认存储类创建。如果在配置后选择了不同的默认存储类，您必须删除使用之前的默认存储类配置的集群命名空间中的现有数据卷。

   3. 可选：高级存储设置：点 Access 模式，并为持久性卷选择访问模式：

      • 单用户(RWO) 将卷由单一节点以读写模式挂载。
      • 共享访问(RWX) 将卷挂载为许多节点以读写模式。
      • 只读(ROX) 将卷挂载为多个节点只读。
   4. 可选：高级存储设置：如果您需要选择 Block 而不是默认的值 Filesystem，点 Volume mode。OpenShift Virtualization 可以静态置备原始块卷。这些卷没有文件系统。对于可以直接写入磁盘或者实现其自己的存储服务的应用程序来说，使用它可以获得性能优势。

7. 选择保存引导源的适当方法：

   1. 如果您上传一个本地文件，请点击 Save and upload。
   2. 如果从 URL 或 registry 中导入内容，点 Save and import。
   3. 如果克隆现有的 PVC，点 Save and clone。

流程

1. 在 OpenShift Container Platform web 控制台中，在侧边单中点 Workloads > Virtualization。
2. 在 Virtual Machines 选项卡或 Templates 选项卡中点 Create 并选择 Virtual Machine with Wizard。
3. 在 Select a template 步骤中，从 Operating System 列表中选择一个操作系统，它具有 OS 和版本名称旁的 (Source available) 标签。(Source available) 标签表示这个操作系统可以使用引导源。
4. 点 Review and Confirm。
5. 检查您的虚拟机设置，并根据需要编辑它们。
6. 点 Create Virtual Machine 创建您的虚拟机。此时会显示 Successfully created virtual machine 页面。

流程

1. 在 OpenShift Virtualization 控制台中，从侧边菜单中点击 Workloads > Virtualization。
2. 点 Templates 选项卡。
3. 单击您要自定义的模板的 Source provider 列中的链接。此时将显示一个窗口，表明模板当前具有定义的源。
4. 在窗口中，单击 Customize source 链接。
5. 在阅读有关引导源自定义过程的信息后，单击 About boot source Custom 窗口中的 Continue 以继续自定义。

6. 在 Prepare boot source Custom 页面中的 Define new template 部分：

   1. 选择 New template namespace 字段，然后选择项目。
   2. 在 New template name 字段中输入自定义模板的名称。
   3. 在 New template provider 字段中输入模板提供程序名称。
   4. 选择 New template support 字段，然后选择适当的值，指示您创建的自定义模板的支持联系人。
   5. 选择 New template flavor 字段，然后选择您创建的自定义镜像的适当 CPU 和内存值。
7. 在 Prepare boot source for custom 部分中，根据需要自定义 cloud-init YAML 脚本来定义登录凭据。否则，脚本会为您生成默认凭据。
8. 单击 Start Customization。自定义过程开始并显示 Preparing boot source Custom 页面，然后显示 Customize boot source 页面。Customize boot source 页面显示正在运行的脚本的输出。脚本完成后，您的自定义镜像将可用。
9. 在 VNC 控制台 中，单击 Guest login credentials 部分中的 show password。您的登录凭据显示。
10. 镜像准备好登录时，通过提供 guest 登录凭证部分中显示的用户名和密码来登录 VNC 控制台。
11. 验证自定义镜像按预期工作。如果存在，点 Make this boot source available。
12. 在 Finish custom and make template available 窗口中，选择 I have sealed the boot source，以便它用作模板，然后单击 Apply。
13. 在 Finishing boot source Custom 页面上，等待模板创建过程完成。点 Navigate to template details 或 Navigate to template list 查看从自定义引导源创建的自定义模板。

流程

1. 从侧边菜单中点 Workloads Virtualization。
2. 在 Virtual Machines 选项卡中，选择正在运行的虚拟机，选择要热插虚拟磁盘的正在运行的虚拟机。
3. 在 Disks 选项卡中，点 Add Disk。
4. 在 Add Disk 窗口中，填写您要热插的虚拟磁盘的信息。
5. 点 Add。

流程

1. 从侧边菜单中点 Workloads Virtualization。
2. 在 Virtual Machines 选项卡中，选择带有您要热拔磁盘的正在运行的虚拟机。
3. 在 Disks 选项卡中，点击您要使用热拔的虚拟磁盘的 Options 菜单 。
4. 点 Delete。

流程

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 hco -n openshift-cnv kubevirt-hyperconverged

2. 将 spec.scratchSpaceStorageClass 字段添加到 CR，将值设置为集群中存在的存储类的名称：

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     scratchSpaceStorageClass: "<storage_class>" 1

   1

   如果您没有指定存储类，CDI 将使用正在填充的持久性卷声明的存储类。

3. 保存并退出默认编辑器以更新 HyperConverged CR。

流程

1. 确保 PV 的 reclaim 策略被设置为 Retain:

   1. 检查 PV 上的 reclaim 策略：

      $ oc get pv <pv_name> -o yaml | grep 'persistentVolumeReclaimPolicy'

   2. 如果 persistentVolumeReclaimPolicy 没有设置为 Retain，使用以下命令编辑 reclaim 策略：

      $ oc patch pv <pv_name> -p '{"spec":{"persistentVolumeReclaimPolicy":"Retain"}}'

2. 确保没有资源在使用 PV:

   $ oc describe pvc <pvc_name> | grep 'Mounted By:'

   在继续操作前，删除所有使用 PVC 的资源。

3. 删除 PVC 以释放 PV:

   $ oc delete pvc <pvc_name>

4. 可选：将 PV 配置导出到 YAML 文件。如果在稍后手动删除共享存储，您可以参考此配置。您还可以使用该文件中的 spec 参数作为基础，在重新声明 PV 后创建具有相同存储配置的新 PV:

   $ oc get pv <pv_name> -o yaml > <file_name>.yaml

5. 删除 PV：

   $ oc delete pv <pv_name>

6. 可选：根据存储类型，您可能需要删除共享存储文件夹的内容：

   $ rm -rf <path_to_share_storage>

7. 可选：创建一个使用与删除 PV 相同的存储配置的 PV。如果您之前导出了重新声明的 PV 配置，您可以使用该文件的 spec 参数作为新 PV 清单的基础：

   注意

   为了避免可能的冲突，最好为新 PV 对象赋予与您删除的名称不同的名称。

   $ oc create -f <new_pv_name>.yaml