管理镜像实例

在 管理员 > 虚拟化 > 镜像 > 镜像实例下,列表显示所选集群的镜像实例及其状态,并且每行都提供更新显示名称、更新默认规格、重新导入和删除操作。点击名称可打开其详细信息:导入源、导入 DataVolume、声明、阶段、进度以及失败原因。命名空间的镜像实例管理方式相同,请参阅命名空间中的镜像实例。

状态

状态含义
可用镜像实例可用于创建虚拟机。
导入中CDI 正在填充卷;页面会显示进度。此镜像实例的存储已删除,正在重新导入表示声明已被删除,但导入 DataVolume 仍存在,因此 CDI 会重新创建声明。
导入错误导入持续失败,CDI 会重试;下方的原因会说明失败原因。
失败导入已确定失败(例如校验和不匹配);请重新导入或删除镜像实例。
不完整导入 DataVolume 和声明都已不存在。请重新导入或删除镜像实例。
等待源摘要由尚未找到要导入镜像的 DataImportCron 管理的镜像实例。
不可用不符合上述任何情况;请检查 DataSource 条件。

在重新导入期间,状态旁会显示正在重新导入(含进度)或重新导入错误。

导入错误或失败时,会显示原因和 CDI 的原始消息:

原因典型原因
校验和不匹配下载的镜像与校验和不匹配。
找不到镜像URL 或镜像标签错误。
身份验证失败凭证错误或缺失。
凭证 Secret 不完整Secret 缺少 accessKeyId 或 secretKey。
证书不受信任服务器证书是自签名证书或来自私有 CA,且未提供匹配的 CA 证书。
证书与地址不匹配镜像地址的主机不在证书的主题备用名称中。
大小小于镜像实例大小小于镜像的虚拟大小。
超出配额命名空间的存储配额已用尽。
存储类不可用存储类不存在,或无法置备所请求的模式。
导入 Pod 无法启动无法调度或启动导入器 Pod。
源正在使用磁盘克隆未启动,因为磁盘正在使用中(CDI 报告 CloneSourceInUse);请停止使用该磁盘的虚拟机。
导入失败其他任何导入失败。

只有可用的镜像实例才会在创建虚拟机时提供;对于由声明支持的镜像实例,其声明还必须已绑定且导入成功。

重新导入

重新导入会使用相同的地址和相同的导入设置(CA 证书、请求标头、校验和、拉取方法、凭证)再次导入镜像,例如服务器上的镜像更新后。磁盘或卷快照也会再次克隆。

  1. 在镜像实例上单击 ⋮ > 重新导入。
  2. 确认。对话框会显示要导入的地址。

新的导入会在当前项旁边的新 DataVolume 中运行。可用的镜像实例会保留当前镜像,直到新的导入成功;成功后,它会切换到新卷,并在没有克隆仍从之前的 DataVolume 读取数据后将其删除。如果新的导入失败,镜像实例会保留当前镜像,并显示重新导入错误。

如果镜像实例的 CA 证书 ConfigMap 已被删除(CA ConfigMap … 缺失),则会拒绝重新导入;请删除镜像实例,然后使用其 CA 证书再次添加。

默认规格

镜像实例可以声明从其创建的虚拟机应使用的实例类型和偏好。这些设置作为其 DataSource 上的四个标签存储:

标签值
instancetype.kubevirt.io/default-instancetype实例类型的名称
instancetype.kubevirt.io/default-instancetype-kindVirtualMachineClusterInstancetype
instancetype.kubevirt.io/default-preference偏好的名称
instancetype.kubevirt.io/default-preference-kindVirtualMachineClusterPreference

从镜像源添加的镜像实例会从镜像源获取这些标签(请参阅添加镜像源);从 registry 导入的镜像也可能在镜像本身中携带这些标签。您从镜像实例创建虚拟机时,这些标签会在模型区域中预先选中。

更新默认规格

  1. 在镜像实例上单击 ⋮ > 更新默认规格。
  2. 选择集群的默认实例类型和默认偏好,或清空字段以移除对应设置。以镜像实例的操作系统命名的偏好会标记为建议并列在最前面。
  3. 单击更新。

CDI 会将这些标签复制到 DataSource 上,来源包括其背后的对象——声明和导入 DataVolume、卷快照或 DataImportCron;如果 DataVolume 不包含其中任何标签,CDI 还会从克隆它的卷中复制这些标签。因此,控制台也会将您的选择写入这些对象。清空的字段会丢失其名称标签,但会保留其类型标签:虚拟机和控制台只会从名称标签读取默认值,而保留的类型标签会阻止 CDI 将克隆卷的值复制回来。重新导入会保留您的选择,包括已清空的字段;只有当 registry 镜像在镜像本身中声明了默认值时,重新导入才会再次为已清空的字段设置该默认值——之后请再次将其清空。

对于 kubectl 也是如此——先为声明和导入 DataVolume 添加标签,然后再为 DataSource 添加标签:

CLAIM=$(kubectl get datasource centos-7 -n kube-public -o jsonpath='{.spec.source.pvc.name}')
for obj in pvc/$CLAIM datavolume/$CLAIM datasource/centos-7; do
  kubectl label -n kube-public "$obj" --overwrite \
    instancetype.kubevirt.io/default-instancetype=u1.medium \
    instancetype.kubevirt.io/default-instancetype-kind=VirtualMachineClusterInstancetype \
    instancetype.kubevirt.io/default-preference=centos.stream9 \
    instancetype.kubevirt.io/default-preference-kind=VirtualMachineClusterPreference
done

要清除默认偏好,请在相同的对象上移除其名称标签,并保留其类型标签:

for obj in pvc/$CLAIM datavolume/$CLAIM datasource/centos-7; do
  kubectl label -n kube-public "$obj" --overwrite \
    instancetype.kubevirt.io/default-preference- \
    instancetype.kubevirt.io/default-preference-kind=VirtualMachineClusterPreference
done

更改默认规格会影响之后创建的虚拟机;现有虚拟机会保留创建时使用的设置。

更新显示名称

单击 ⋮ > 更新显示名称。显示名称存储在 cpaas.io/display-name 的 DataSource 注解中。

删除

  1. 在镜像实例上单击 ⋮ > 删除。
  2. 对话框会列出镜像实例的读取方:系统磁盘无法再通过该实例重新创建的虚拟机、无法再创建成员的虚拟机池,以及仍在从该实例读取数据且将无法完成的克隆。已从镜像实例创建的磁盘不受影响。
  3. 输入镜像实例的名称并确认。

删除的内容取决于镜像实例的创建方式:

镜像实例删除内容
在控制台中添加(使用导入 DataVolume)DataSource;导入 DataVolume、其声明和 CA 证书 ConfigMap 会通过其所有者引用一并删除。
由 DataImportCron 管理DataImportCron,它会删除其管理的内容。
从现有卷发布DataSource;勾选删除存储也会删除该卷。

对于 kubectl,请删除在控制台中添加的镜像实例的 DataSource;其余内容会随之删除:

kubectl delete datasource centos-7 -n kube-public