创建虚拟机

使用镜像创建虚拟机(VirtualMachine 资源),并将其调度到已安装 KubeVirt 组件且已启用虚拟化的物理节点。VirtualMachine 是期望状态对象(类似于 Deployment);启动后,KubeVirt 会生成一个正在运行的 VirtualMachineInstance(类似于 Pod)。有关本页使用的术语,请参阅概念和术语表。

你可以通过创建虚拟机使用表单创建虚拟机,也可以切换到 YAML 格式进行操作。

使用实例类型和首选项为新虚拟机设置规格。实例类型声明一次 CPU 和内存,所有引用该实例类型的虚拟机均可共享;首选项则应用客户机操作系统最适用的设备和固件设置。也可以直接在虚拟机(机器模型)中设置 CPU 和内存。请参阅实例类型和首选项。

先决条件

  • 使用镜像创建虚拟机之前,请向平台管理员确认以下事项:

    • 目标集群是平台在非 Alauda OS 上创建的业务集群,并且已部署 Kubevirt 组件。

    • 目标节点必须是已启用虚拟化的物理节点。

    • 已向平台添加镜像源并将其分配给项目,或者 kube-public 中或命名空间中已有镜像实例(请参阅镜像)。

  • 如果需要使用虚拟机的物理 GPU 直通功能,请联系平台管理员进行以下配置:

    1. 获取 GPU 直通环境准备方案,并准备必要的环境。

    2. 准备所需的物理 GPU,并为虚拟机的物理 GPU 直通启用相关功能。

注意

使用 Windows 虚拟机时,仅支持使用虚拟机镜像中设置的用户名/密码登录。请提前联系平台管理员获取此信息。

创建虚拟机

操作步骤

注意:以下内容以使用表单创建虚拟机为例,你也可以切换到 YAML 格式进行操作。

  1. 进入容器平台。

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

  3. 单击创建虚拟机。

  4. 在基本信息区域中,填写虚拟机的名称和显示名称,并设置标签或注解。

    参数说明
    标签用于选择对象并查找符合特定条件的对象集合。必须是键值对,例如:app.kubernetes.io/name: hello-app。
    注解用于向开发和运维团队提供任何信息。必须是键值对,例如:cpaas.io/maintainer: kim。
  5. 在镜像区域中,选择虚拟机启动所用的镜像。

    参数说明
    CPU 架构镜像的架构;只能选择与集群架构相同的镜像。
    置备方式镜像源:由平台管理员分配给项目的公共镜像;系统盘从其地址导入。镜像实例:镜像实例(可引导卷),虚拟机将从中克隆系统盘;列表中会显示 kube-public 的镜像实例以及虚拟机所在命名空间的镜像实例,后者会标注命名空间名称。
    选择镜像操作系统和镜像。镜像实例或镜像源可以声明默认实例类型和偏好设置;此时系统会在型号区域中预选这些设置,你仍可进行修改。如果集群中不存在声明的名称,则不会预选,并会在表单中提示。对于地址为 https:// 的镜像源,表单会提醒你:由私有 CA 保护的镜像必须从包含 CA 证书的镜像实例创建。
  6. 在型号区域中,选择虚拟机的规格配置方式。

    参数说明
    规格配置实例类型(默认,推荐):虚拟机引用实例类型,本身不包含 CPU 或内存。机器型号:将 CPU 和内存写入虚拟机。两者不能同时使用。
    实例类型在实例类型配置路径下显示。列出当前命名空间(此命名空间)和集群(集群)的实例类型;每个选项会显示其 vCPU 数量、内存,以及需要时的 hugepage 大小,常用类型会标记为产品提供。需要 hugepage 的实例类型必须使用提供相应 hugepage 的节点。
    遵循镜像设置当所选镜像实例声明了默认实例类型(或偏好设置)时提供。虚拟机将使用镜像声明的对象,而不是由你选择;创建虚拟机时,系统会读取该对象并将其写入虚拟机。如果镜像未声明对象,则会拒绝创建。
    型号在机器型号配置路径下显示。选择推荐的使用场景,或自定义 CPU 和内存;请求值和限制值将设置为相同值。
    偏好设置两种配置路径均可选,且建议设置。列出当前命名空间和集群的偏好设置;偏好设置会补充虚拟机未设置的设备、固件和时钟设置。
    物理 GPU(Alpha)选择物理 GPU 的型号;每台虚拟机只能分配一个物理 GPU。

    注意:虚拟机的物理 GPU 直通,是指在虚拟化环境中将实际的图形处理单元 (GPU) 直接分配给虚拟机,使其能够直接访问并使用物理 GPU,从而达到与在物理机上直接运行相当的图形性能,避免虚拟图形适配器造成的性能瓶颈并提升整体性能。
  7. 在存储区域中,参考以下说明配置相关信息。

    参数说明
    磁盘名称存储磁盘的名称;系统盘名称不可修改。
    类型
    • 根磁盘:系统会自动创建 VirtIO 类型的 rootfs 系统盘,用于存储操作系统和数据。
    • 数据盘:单击此项可添加多个数据盘,用于持久化存储数据。默认使用 VirtIO 设备。
    注意:数据盘名称不得与现有磁盘名称重复。
    卷模式
    • 文件系统:将磁盘挂载为文件目录。
    • 块设备:将磁盘挂载为块设备。
    存储类平台通过创建和管理持久卷声明来维护虚拟机磁盘。你需要指定用于动态创建持久卷声明的存储类。
    不同存储类支持的卷模式不同;如果所选卷模式没有可用的存储类,请联系管理员添加。
    每个磁盘的访问模式遵循存储类的 StorageProfile:如果配置文件针对相应卷模式提供 ReadWriteMany,则使用该模式,例如 Ceph RBD 的块设备或 CephFS 的文件系统,以便虚拟机能够实时迁移;否则使用配置文件提供的访问模式。没有配置文件时,Ceph RBD 块设备使用 ReadWriteMany,其他情况使用 ReadWriteOnce。
    容量虚拟机存储所需的容量;系统盘的最小容量为 20 G。
    随虚拟机删除默认启用且不可修改,表示删除虚拟机时也会删除磁盘数据。
  8. 在网络区域中,参考以下说明配置相关信息。

    参数说明
    IP 地址
    • 默认设置为动态 (DHCP);虚拟机启动时会动态分配 IP,停止时会释放 IP。
    • 如果绑定静态 IP,虚拟机即使重启也会始终使用该 IP 地址。如果当前项目没有可用 IP,请先适当释放 IP。
    网络模式
    • 桥接:虚拟机与容器组共用同一 IP 地址,并通过此 IP 地址与外部通信。
    • NAT:虚拟机会分配一个内部 IP 地址,但对外通信时会转换为容器组 IP 地址。开放端口表示虚拟机对外暴露的端口,例如 SSH 服务端口 22;如果不填写开放端口,则表示开放所有端口。
    辅助网卡根据需要添加辅助网卡。
    注意:
    • 如果需要辅助网卡功能,或者没有可用的辅助网卡网络类型,请联系平台管理员进行配置。
    • SR-IOV 类型仅支持 x86_64 架构的 Linux 操作系统。
    • 默认通过 DHCP 获取 IP 地址。
    • 多次重启后,SR-IOV 虚拟机可能会出现两个不同的 VF,但 MAC 地址相同。
  9. 在初始化设置区域中,参考以下说明配置相关信息。

    参数说明
    密钥始终使用 SSH 密钥进行远程登录验证。此方法无需验证密码,建议使用密钥登录虚拟机。
    • 你可以使用平台中已有的密钥,也可以立即创建新密钥;所有相关密钥均可在虚拟化 > 密钥对页面中查看。
    • 只有持有私钥的人员才能通过 SSH 访问虚拟机。如果需要多人共同维护虚拟机,可以关联多个密钥,并将私钥分配给不同用户。如果密钥泄露,可以及时撤销关联的密钥以减少损失。
    • SSH 密钥的公钥以保密形式存储在平台中;平台不会存储你的私钥,请自行妥善保管。
    • 有关 root 用户密码的信息,请参阅相应操作系统文档。
    密码使用操作系统用户名和密码进行登录验证,之后仍可切换为密钥方式。
    • 该用户仅为初始账户;虚拟机成功创建后,你也可以在虚拟机中创建其他操作系统用户用于登录。
    • 平台会加密并存储你的 root 用户密码,你之后将无法再次查看其明文,请自行妥善保管。
    立即启动默认启用。启用此选项后,虚拟机会在创建完成后立即启动;否则仅创建虚拟机。
  10. (可选)在高级配置区域中,参考以下说明配置相关信息。

参数说明
健康检查
  • 存活检查:检查虚拟机是否处于健康状态;如果检测结果异常,将根据健康检查配置判断是否重启实例。
  • 可用性检查:检查虚拟机是否已完成启动并处于正常服务状态;如果检测到虚拟机实例的健康状态异常,将更新虚拟机的状态。

有关相关参数的说明。
节点亲和性
  • 首选:系统会尽可能将虚拟机调度到满足亲和性要求的节点。系统将结合亲和性权重和其他调度要求(例如计算资源要求),确定能够运行虚拟机的节点。
  • 必需:系统只会将虚拟机调度到完全满足亲和性要求的节点。
  1. 确认信息无误后,单击创建。

    等待虚拟机状态从创建中变为运行中。

相关操作

你可以根据需要,单击列表页右侧的 ⋮ 图标或详情页右上角的操作,更新或删除虚拟机。有关重置密码或更新密钥等其他相关操作,请参阅管理虚拟机。

注意:

  • 仅当虚拟机处于异常、未知或已停止状态时,才能执行更新操作。

  • 更新时不支持显示虚拟机创建后单独挂载或创建的磁盘。

  • 默认情况下,更新时立即启动处于禁用状态;你可以根据需要启用。

使用 API

虚拟机是一个 VirtualMachine(kubevirt.io/v1)。

推荐:引用实例类型和首选项

下面的虚拟机从可启动卷(DataSource)启动,从集群实例类型 u1.medium 获取其大小,从集群首选项 centos.stream9 获取其设备设置,连接 Pod 网络,并通过 cloud-init 注入 SSH 密钥:

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: web-01
  namespace: demo
spec:
  running: false           # set true to start on creation
  instancetype:            # the size: guest CPU and memory
    kind: VirtualMachineClusterInstancetype
    name: u1.medium
  preference:              # optional: preferred devices, firmware and clock
    kind: VirtualMachineClusterPreference
    name: centos.stream9
  dataVolumeTemplates:
    - metadata:
        name: web-01-rootfs
      spec:
        sourceRef:          # clone an existing bootable volume (DataSource)
          kind: DataSource
          name: centos-stream9
          namespace: kube-public
        storage:
          resources:
            requests:
              storage: 20Gi
          storageClassName: rbd-1
          volumeMode: Block
          accessModes:
            - ReadWriteMany
  template:
    metadata:
      labels:
        kubevirt.io/vm: web-01
    spec:
      domain:
        # No resources, cpu or memory.guest here: they come from the instance type.
        devices:
          disks:
            - name: rootfs
              disk: {}      # the preference chooses the disk bus
            - name: cloudinit
              disk: {}
          interfaces:
            - name: default
              masquerade: {}
      networks:
        - name: default
          pod: {}
      volumes:
        - name: rootfs
          dataVolume:
            name: web-01-rootfs
        - name: cloudinit
          cloudInitNoCloud:
            userData: |
              #cloud-config
              ssh_authorized_keys:
                - ssh-ed25519 AAAAC3...example user@host
kubectl apply -f vm.yaml
# Start it (ACP virtual machines use the spec.running field):
kubectl patch vm web-01 -n demo --type merge -p '{"spec":{"running":true}}'
  • 要引用命名空间范围的对象,请将 kind 设置为 VirtualMachineInstancetype 或 VirtualMachinePreference;该对象必须位于虚拟机所在的命名空间中。不带 kind 的引用表示集群范围的 kind。
  • 引用实例类型的虚拟机不得设置 spec.template.spec.domain.resources CPU 或内存、domain.cpu.sockets / cores / threads、domain.memory.guest 或实例类型设置的任何其他配置;此类虚拟机会被拒绝。
  • 首选项只会填充虚拟机未设置的配置:例如,显式设置了 bus 的磁盘会保留其总线。

跟随镜像

当可启动卷声明了默认实例类型和首选项(请参阅可启动卷)时,虚拟机可以从该卷获取它们,而无需指定对象名称。跟随镜像会写入以下内容:

spec:
  instancetype:
    inferFromVolume: rootfs            # the boot volume
    inferFromVolumeFailurePolicy: Reject
  preference:
    inferFromVolume: rootfs
    inferFromVolumeFailurePolicy: Reject

平台会在创建虚拟机时从卷中读取一次默认值,并将其指定的对象存储在虚拟机中 — spec.instancetype.name 和 spec.preference.name 会替代 inferFromVolume 字段。之后更改卷的标签不会影响现有虚拟机。使用 Reject 策略时,如果卷未声明默认值,则会拒绝创建;使用 Ignore 策略时,创建的虚拟机不会包含该实例类型或首选项。

替代方案:在虚拟机中设置大小(机器模型)

不使用实例类型时,大小会写入模板。ACP 使用资源限制模型,因此 requests 和 limits 包含相同的值。仍然可以引用首选项:

spec:
  preference:
    kind: VirtualMachineClusterPreference
    name: centos.stream9
  template:
    spec:
      domain:
        cpu:
          cores: 1
        resources:          # requests == limits
          requests:
            memory: 2Gi
          limits:
            memory: 2Gi

启动磁盘由 dataVolumeTemplates 条目配置,该条目克隆所引用的可启动卷。要稍后更改虚拟机的大小,或将虚拟机从机器模型迁移到实例类型,请参阅管理虚拟机。