用 cloud-init 实现云主机初始化自动化
每次新购一台云主机,都要重复创建用户、配置 SSH 公钥、安装软件包、修改时区、写入配置文件,这些手工操作既耗时又容易遗漏。cloud-init 是被各大云平台和主流 Linux 发行版广泛支持的初始化工具,它能在实例首次启动时读取用户提供的配置,自动完成上述工作。本文介绍 cloud-init 的工作原理与常用写法,帮助把主机初始化变成可版本化、可复用的代码。
一、cloud-init 的工作原理
cloud-init 在系统启动过程中分阶段运行,大致包括 local、network、config 和 final 四个阶段。local 阶段在网络就绪前定位数据源并应用网络配置;network 阶段处理磁盘、挂载和 SSH 密钥等基础设置;config 阶段执行大部分配置模块;final 阶段安装软件包并执行用户脚本。每个模块的执行频率分为每实例一次、每次启动和仅一次等,默认多数模块只在实例首次启动时执行。
配置数据来源分为元数据和用户数据。元数据由云平台提供,包含实例 ID、主机名、网络信息和公钥等;用户数据由创建实例时在控制台或 API 中填写,可以是以 #cloud-config 开头的 YAML 配置,也可以是普通的 shell 脚本。主流云平台在创建实例时都提供了「用户数据」或「实例自定义数据」输入框,其内容就是交给 cloud-init 处理的。
二、cloud-config 常用模块
users 模块用于创建用户,可指定 name、groups、shell、sudo 规则和 ssh_authorized_keys,从而在第一次登录前就完成免密登录配置,并可通过 disable_root 与 ssh_pwauth 关闭不安全的登录方式。timezone 与 hostname 模块分别设置时区和主机名。package_update 与 package_upgrade 控制是否更新软件源和升级系统,packages 列表声明需要安装的软件。
write_files 模块用于写入配置文件,可以指定 path、content、owner 和 permissions,适合下发应用配置、systemd 单元文件或 sysctl 参数。runcmd 模块在 final 阶段按顺序执行命令,常用于启用服务、拉取代码或调用部署脚本。bootcmd 则在启动早期每次都会执行,适合极少数必须早于其他步骤的操作。将这几个模块组合起来,基本可以覆盖大多数初始化需求。
三、调试与排错
cloud-init 的执行日志位于 /var/log/cloud-init.log 与 /var/log/cloud-init-output.log,前者记录模块执行细节,后者保存用户脚本和命令的输出。可以用 cloud-init status --long 查看整体执行状态,用 cloud-init query userdata 查看实例实际收到的用户数据。编写配置时,使用 cloud-init schema --config-file 文件名 进行语法校验,能提前发现 YAML 缩进和字段名错误。
在测试阶段,如果需要在同一台机器上重复验证,可以执行 cloud-init clean --logs 清除状态后重启,让 cloud-init 认为这是一次全新启动。需要注意,YAML 对缩进极其敏感,且第一行必须是 #cloud-config,否则整个文件会被当作普通脚本或直接忽略。
四、实践建议
第一,保持初始化幂等。runcmd 中的命令应能安全地重复执行,例如创建目录时使用 mkdir -p,追加配置前先判断是否已存在。第二,不要在用户数据中明文写入数据库密码或访问密钥,因为元数据服务在实例内部通常可以被读取,敏感信息应通过密钥管理服务或启动后拉取的方式获取。第三,把用户数据纳入 Git 管理,与基础设施即代码工具配合使用。
第四,合理划分镜像与 cloud-init 的职责。体积大、变化少的依赖适合预先打入自定义镜像,以缩短启动时间;与具体实例相关的配置,如主机名、角色标签和环境变量,则交给 cloud-init 在启动时注入。这种「镜像打底、cloud-init 定制」的组合,在弹性伸缩场景下尤其实用。
五、总结
cloud-init 把云主机初始化从手工操作变成了声明式配置。理解其运行阶段和数据来源,熟练使用 users、packages、write_files 和 runcmd 等模块,再配合日志排查、幂等设计和镜像分层,就能让每一台新主机在启动后几分钟内达到可用状态,并保证环境的一致性。
- 点赞
- 收藏
- 关注作者
评论(0)