运维与数据工程笔记

给自装系统开启 Cloud-Init:PVE 模板化的完整链路

5 分钟
PVECloud-Init模板Rocky Linux

为什么自装系统默认不能当模板用

自装系统的克隆机默认不可用,原因是镜像标识没有唯一化:主机名、machine-id、SSH 主机密钥、网卡 MAC 派生规则全部沿用了母机的那一份,克隆出十台机器会有十个一模一样的身份。

PVE 的解法是把这些"身份"交给 Cloud-Init 在首次启动时重新生成。前提是母机先被"通用化"(generalize),并且挂上 Cloud-Init 驱动器。

必须做对的三步

第一步:清理镜像标识

# 1. 清包缓存
dnf clean all            # Debian/Ubuntu: apt clean

# 2. 删 SSH 主机密钥(新机器首启自动重新生成)
rm -f /etc/ssh/ssh_host_*

# 3. 清 machine-id —— 两个文件都要处理
truncate -s 0 /etc/machine-id
rm -f /var/lib/dbus/machine-id
ln -s /etc/machine-id /var/lib/dbus/machine-id

# 4. 清临时文件与日志
rm -rf /tmp/* /var/tmp/*

# 5. 用 cloud-init 自己的清理(清掉历次运行痕迹)
cloud-init clean --logs --seed

# 6. 立即关机
poweroff

第二步:PVE 侧挂 Cloud-Init 驱动器

qm set <vmid> --ide2 local-lvm:cloudinit
# IDE 不是硬性要求,SATA/SCSI 也可,官方只要求存在一个 cloud-init 驱动器

第三步:设置 ciuser 并转模板

qm set <vmid> --ciuser root --sshkeys ~/.ssh/authorized_keys
qm set <vmid> --ipconfig0 ip=dhcp
qm template <vmid>

最容易踩的三个坑

坑 症状 原因
machine-id 只清一个 克隆机 systemd 报重复 ID、journald 日志混乱 systemd 优先读 /var/lib/dbus/machine-id,只 truncate /etc/machine-id 不够
ciuser 静默失败 qm config 看着完全正常,SSH 却报 Please login as "cloud-user" 模板里没有 ciuser 项时 PVE 不报错,只是不注入;克隆后需 qm set <vmid> --ciuser root + qm cloudinit update 并重启
模板没装 cloud-init 克隆机 IP 拿不到、主机名不变 镜像内必须有 cloud-init 包,且 systemctl enable cloud-init

验证:四条命令确认模板可用

# 1. 克隆一台测试
qm clone <模板vmid> 8899 --full 1

# 2. 启动后看主机名(应自动变成克隆名)
qm agent 8899 get-host-name

# 3. SSH 能进
ssh -i ~/.ssh/id_ed25519 root@<新IP> 'hostname'

# 4. machine-id 已不同
ssh root@<新IP> 'cat /etc/machine-id'

四条全过,模板才算交付完成。

常见问题

machine-id 为什么必须清两个文件?

因为 systemd 读 /etc/machine-id,但 dbus 读 /var/lib/dbus/machine-id,两者是独立文件。只清其中一个会让两个组件拿到不同 ID,或者 dbus 直接沿用旧值,导致日志、systemd 单元、部分依赖 dbus 的服务出现身份冲突。

cloud-init clean --logs --seed 里的 --seed 有什么用?

--seed 会重置 seed 状态,让 cloud-init 认为这是"首次启动",从而重新执行 datasource 发现流程。做模板时不清 seed,克隆机可能跳过配置阶段。

ciuser 设了但 SSH 还是进不去怎么办?

先确认克隆机(不是模板)上有 ciuser,再执行 qm cloudinit update <vmid> 重新生成 Cloud-Init ISO,最后重启。qm set --ciuser 只改配置,不会自动重生成 ISO。

模板能不能不挂 Cloud-Init 驱动器?

不能。没有 ide2/sata0 等 Cloud-Init 驱动器时,PVE 没有通道把 ipconfig0、ciuser、sshkeys 传给虚拟机,克隆机只能沿用母机网络配置,多台机器会 IP 冲突。