云主机第一次启动还要手工改配置,Cloud-init 官方怎么完成初始化?

新开的云主机每次还要手工改主机名、用户和软件包,想按 cloud-init 官方教程看懂第一次启动怎么初始化。这不是在写镜像模板,也不对照某一家云的专有字段。下面若出现教程里的口令示例,只用来对照官方说明,不能当成可复用的生产配置。

Cloud-init documentation 首页标题是 cloud-init 26.2 documentation。它把自己写成跨发行版、跨平台的云实例初始化方式,公有云、私有云的供给系统,以及裸机安装都在支持范围内。启动过程中,它会识别当前跑在哪朵云上,并据此初始化系统。第一次启动时,网络、存储、SSH 密钥、软件包以及其它系统侧配置都可以预先就绪。对使用者来说,这是不用再单独安装一套工具的首次启动配置。对云厂商来说,则是可以接到云平台里的实例准备过程。旧域名 cloudinit.readthedocs.io 会跳到这个 docs.cloud-init.io 地址。

想弄清它在启动时做了什么,可以看同站的 Introduction to cloud-init。介绍页把常见工作写成:设置主机名、配置网卡、创建用户帐户,以及运行脚本。过程分成两段。早期、网络还没起来时,它要发现 datasource、取回配置,并写好网络和 DNS,等网络服务随后生效。配置数据来自 meta-data(例如机器 ID、主机名、网络配置),以及形态相近、来源不同的 vendor-data 和 user-data。网络起来之后的阶段,再处理配置管理、安装或更新软件、创建或修改用户、执行 user-data 里的自定义脚本,以及把 SSH 密钥写入实例的 authorized_keys。介绍页也强调,同一份配置可以反复使用,得到一致的结果。这些是通用能力说明,不要把某一家云控制台里的专有字段直接抄进来。

动手建议看 Tutorials。完全不熟的话,官方建议先做 New user tutorial with QEMU:用 QEMU 在本地拉起一个已预装 cloud-init 的云镜像,把配置先在本机验证,再考虑拿到云上启动。教程把自己的目标写成一份最小演示,当作把配置送上云之前的本机开发环境。已经熟悉基本概念时,同一索引里的 Quick-start tutorial with LXD 可以当作快速部署:把一份 user-data 投进 LXD 容器。

QEMU 这篇把传给实例的数据分成三类:用户提供的 user-data(它能识别多种格式)、云厂商提供的 vendor-data,以及包含实例 ID、主机名等信息的 meta-data。最常见的 user-data 格式叫 cloud-config,是一份 YAML,文件开头必须是 #cloud-config,这样 cloud-init 才知道按这种类型来解析。教程里的演示写成:

#cloud-config
password: password
chpasswd:
  expire: False

它把默认用户的口令设成 password,并用 chpasswd.expire: False 表示首次登录不必强制改密。这只是官方为了让你随后能登录、确认初始化已经发生的对照写法,口令本身极弱,不要原样拿到生产实例上用,也不要把真实密钥或口令写进可分享的配置里。同一教程还会写一份只含 instance-id 的 meta-data,以及一个空的 vendor-data 文件(用来缩短重试等待)。这些同样是本地演示用的实例标识,不是某朵云的专有生产字段。

教程随后用本机的 Python HTTP 服务模拟 IMDS,再把 Ubuntu 云镜像交给 QEMU。实例走的是 NoCloud 这种 datasource(在 SMBIOS 序列号里带上 ds=nocloud 和配置的 URL),会自己把 user-data 取走。在 Ubuntu 上,教程给出的安装命令是 sudo apt install qemu-system-x86。其它系统则指向 QEMU 自己的安装说明。启动完成后,教程用镜像默认用户 ubuntu 和上面那个演示口令登录。能登录之后,在实例里执行 cloud-init status --wait,输出里出现 status: done 就说明跑完了。若是失败状态,教程让你去看 /var/log/cloud-init.log 里的警告和错误。看完之后,QEMU 那边用 Ctrl-A 再按 X 退出,跑 HTTP 服务的终端用 Ctrl-C 停掉即可。模块清单和更多常见用法,教程结尾指向官方的 modules 与 examples 文档,需要哪一类初始化再按模块页对照,不要自行编造某朵云才有的字段。

你们新开的机器,是启动后再手工改用户和软件包,还是已经在用 cloud-init 的 user-data?

user-data 第一行必须是 #cloud-config,少个井号就静默失败,什么提示都没有。

排查看 /var/log/cloud-init.log,cloud-init status --long 也能看出卡在哪一步。

已经跑过的机器想重来,cloud-init clean 再重启,不然它认为做完了就不动了。