跳转到正文
皓量云擎文档

Windows 自动初始化

准备 UEFI Windows 镜像,并配置 Cloudbase-Init 和 QEMU Guest Agent。

Windows 首次自动初始化使用 Cloudbase-Init 读取 NoCloud 配置盘。计算节点请使用与当前 CMP 交付包配套的 Agent。QEMU Guest Agent 用于校验来宾状态、设置 Administrator 密码、扩展 C 盘和同步时间。

准备镜像

  1. 使用 x86_64 的 QCOW2 或 RAW 镜像。准备 GPT、EFI 引导分区和 VirtIO 驱动,确认目标主机有适用的 OVMF 固件。
  2. 安装支持 NoCloud 网络配置 v2 的 Cloudbase-Init,例如 1.1.8,启用内置 Administrator。通过 Sysprep 制作镜像时,确认首次启动会读取以下配置。
  3. 安装并启动 Windows QEMU Guest Agent。导入镜像时选择 Windows 与 UEFI,开启“自动初始化”。
[DEFAULT]
metadata_services=cloudbaseinit.metadata.services.nocloudservice.NoCloudConfigDriveService
plugins=cloudbaseinit.plugins.common.sethostname.SetHostNamePlugin,cloudbaseinit.plugins.common.networkconfig.NetworkConfigPlugin
allow_reboot=true

旧 BIOS 镜像应先制作并验证独立的 UEFI 副本。仅修改镜像的固件标签不会转换磁盘引导方式。

创建并验收

创建实例时使用 Administrator 密码。启用自动初始化后,平台在启动前挂载卷标为 cidata 的只读配置盘,Cloudbase-Init 按网卡 MAC 应用静态 IPv4、网关、DNS、MTU 和主机名。系统启动后由 QEMU Guest Agent 完成校验及后续任务。

创建完成后检查 Administrator 登录、IP、主机名、C 盘容量和时间。任务失败时查看任务日志中的配置盘、来宾代理或分区扩展错误,再按原任务重试。同一版本仍不支持 Windows 实例重装或从 Windows 实例模板克隆。

系统镜像接口的 cloud_init_enabled 说明见 镜像初始化字段。

本页目录