管理虚拟磁盘

数据磁盘可用于满足业务的数据持久化需求。

数据磁盘由 CDI DataVolume 提供支持(它会创建同名的 PVC)。以下操作分别对应:创建 DataVolume,将其热插拔到虚拟机(addvolume),扩展其 PVC,将其卸载(removevolume),以及删除 DataVolume。

创建虚拟磁盘

为虚拟机创建数据磁盘。每次只能添加一个虚拟磁盘;如果需要多个磁盘,请重复此操作。

注意:虚拟机处于运行状态时,可以在线挂载虚拟磁盘。

操作步骤

  1. 进入容器平台。

  2. 在左侧导航栏中,点击虚拟化 > 虚拟磁盘。

  3. 点击创建虚拟磁盘。

  4. 按照以下说明配置信息。

    参数描述
    卷模式- 文件系统:以挂载文件目录的方式挂载磁盘。
    - 块设备:将磁盘作为块设备挂载。
    存储类平台通过自动创建和管理持久卷声明来维护虚拟机磁盘。你需要指定动态创建持久卷声明所需的存储类。

    不同的存储类支持不同的卷模式。如果所选卷模式没有可用的存储类,请联系管理员添加。

    磁盘的访问模式遵循存储类的 StorageProfile:对于所选卷模式,如果 StorageProfile 提供 ReadWriteMany,则使用该访问模式(实时迁移需要此模式);否则使用 StorageProfile 提供的访问模式。
    随 VM 删除启用后,删除虚拟机时也会删除磁盘数据。
    挂载- 不挂载:仅创建虚拟磁盘;需要时可稍后挂载。
    - 挂载到 VM:选择要挂载虚拟磁盘的目标虚拟机。
  5. 点击创建。

使用 API

将空白数据磁盘创建为 DataVolume:

apiVersion: cdi.kubevirt.io/v1beta1
kind: DataVolume
metadata:
  name: datadisk-1
  namespace: demo
spec:
  source:
    blank: {}
  storage:
    resources:
      requests:
        storage: 10Gi
    storageClassName: rbd-1
    volumeMode: Block
    accessModes:
      - ReadWriteMany
kubectl apply -f datadisk.yaml
# wait for the DataVolume to reach Succeeded and its PVC to be Bound
kubectl get datavolume datadisk-1 -n demo -w

挂载虚拟磁盘

将数据磁盘挂载到虚拟机,将已创建的虚拟磁盘附加到目标虚拟机。

注意:虚拟机处于运行中状态时,可以在线挂载虚拟磁盘。

操作步骤

  1. 访问容器平台。

  2. 在左侧导航栏中,点击虚拟化 > 虚拟磁盘。

  3. 在要挂载的虚拟磁盘旁,点击 ⋮ > 挂载。

  4. 选择目标虚拟机,然后点击挂载。

使用 API

将磁盘热插拔到正在运行的虚拟机中。使用 virtctl 时,使用 --persist,使磁盘添加到虚拟机规格中,并在重启后保留:

virtctl addvolume web-01 --volume-name=datadisk-1 --persist -n demo

此操作会发出 addvolume 子资源请求(AddVolumeOptions)。随后,磁盘会显示在 VirtualMachineInstance.status.volumeStatus 中,并从 AttachedToNode 变为 Ready。如果不使用 --persist,热插拔只会应用于正在运行的实例,重启后不会保留。

扩展虚拟磁盘

扩展已挂载到虚拟机的系统磁盘和数据磁盘。

操作步骤

  1. 访问容器平台。

  2. 在左侧导航栏中,点击虚拟化 > 虚拟机。

  3. 点击虚拟机名称,进入详情页面。

  4. 在虚拟磁盘区域中,找到要扩展的磁盘,然后点击 ⋮ > 扩展。

  5. 输入新的容量,然后点击扩展。

使用 API

修补 PVC 请求的大小(StorageClass 必须允许扩展卷):

kubectl patch pvc datadisk-1 -n demo --type merge \
  -p '{"spec":{"resources":{"requests":{"storage":"20Gi"}}}}'

status.capacity.storage 会扩展到新大小;Ceph RBD 等 CSI 驱动支持在线扩展(无需重启)。

卸载虚拟磁盘

从虚拟机卸载数据磁盘;只有处于已停止状态的虚拟机才能卸载磁盘。

操作步骤

  1. 访问容器平台。

  2. 在左侧导航栏中,点击虚拟化 > 虚拟磁盘。

  3. 在要卸载的虚拟磁盘旁,点击 ⋮ > 卸载并确认。

使用 API

分离热插拔磁盘:

virtctl removevolume web-01 --volume-name=datadisk-1 -n demo

此操作会发出 removevolume 子资源请求,并分离磁盘(该条目会从 VirtualMachineInstance.status.volumeStatus 中移除)。KubeVirt API 支持从正在运行的虚拟机中分离磁盘,但请确保在移除磁盘前,客户机内部不再使用该磁盘(已在操作系统级别卸载),以避免数据丢失。

删除虚拟磁盘

只有处于未挂载状态的虚拟磁盘才能删除。

注意:系统磁盘不能删除。

操作步骤

  1. 访问容器平台。

  2. 在左侧导航栏中,点击虚拟化 > 虚拟磁盘。

  3. 在要删除的虚拟磁盘旁,点击 ⋮ > 删除并确认。

使用 API

kubectl delete datavolume datadisk-1 -n demo

后端 PVC 由 DataVolume 所有,并会随其一同进行垃圾回收。如果 CDI 已经对 DataVolume 执行了垃圾回收,请直接删除 PVC(kubectl delete pvc datadisk-1 -n demo)。

StorageProfile 和跨命名空间克隆范围

CDI 会为每个 StorageClass 发布一个 StorageProfile,用于描述如何在该后端置备和克隆磁盘。检查该对象可查看支持的访问模式、卷模式和克隆方法:

kubectl get storageprofile rbd-1 -o jsonpath='cloneStrategy={.status.cloneStrategy} claimPropertySets={.status.claimPropertySets}{"\n"}'
# cloneStrategy=csi-clone claimPropertySets=[{RWX,Block},{RWO,Block},{RWO,Filesystem}]

cloneStrategy(csi-clone、snapshot 或主机辅助的 copy)决定可启动卷或虚拟机克隆如何复制磁盘;快照或克隆能否执行,取决于 StorageClass 是否具备这些功能。

跨命名空间克隆范围:创建虚拟机或可启动卷时,控制台仅提供来自当前命名空间和 kube-public 的启动镜像作为克隆源。此 UI 防护措施(而非 RBAC)是此平台支持的边界:将共享的黄金镜像发布到 kube-public,内置的 os-images.kubevirt.io:view 角色可让每位经过身份验证的用户克隆这些镜像。

CDI 上游的 datavolumes/source 权限(datavolume-cloner ClusterRole)无法可靠地限制 CSI 路径克隆,因此绑定该权限并非在任意非公开命名空间中公开镜像的受支持或充分方式。共享镜像请使用 kube-public。