一文彻底搞懂 cloud-init：从初始化流程到 cloud.cfg 深度解析

一文彻底搞懂 cloud-init：从初始化流程到 cloud.cfg 深度解析

在云计算环境中，新创建的服务器通常需要完成很多初始化工作，例如：

• 设置主机名
• 创建用户
• 配置 SSH
• 安装软件
• 执行初始化脚本

如果这些操作全部手动完成，不仅效率低，而且容易出错。

为了解决这个问题，Linux 云镜像中普遍使用cloud-init来完成实例启动时的自动化初始化。

本文不仅会讲cloud-init 的基本使用，还会深入解析核心配置文件/etc/cloud/cloud.cfg的执行机制。

cloud-init 是什么

cloud-init是 Linux 云服务器启动时执行的初始化工具。

它可以自动完成：

• 创建用户
• 设置 SSH Key
• 安装软件包
• 执行脚本
• 配置网络
• 设置 hostname

目前几乎所有云厂商镜像都默认集成，例如：

• AWS
• OpenStack
• 阿里云
• 腾讯云
• Azure

检查系统是否已安装 cloud-init

先确认系统是否已经安装：

cloud-init--version

如果输出类似：

/usr/bin/cloud-init22.2

说明已经安装成功。

也可以使用：

rpm-qa|grepcloud-init

或：

dpkg-l|grepcloud-init

安装 cloud-init

CentOS / Rocky / AlmaLinux 安装 cloud-init

适用于：

• CentOS
• Rocky Linux
• AlmaLinux

安装命令：

yuminstall-ycloud-init

安装完成后启动服务：

systemctlenablecloud-init systemctl start cloud-init

查看状态：

systemctl status cloud-init

Ubuntu / Debian 安装 cloud-init

安装命令：

aptupdateaptinstall-ycloud-init

安装完成后验证：

cloud-init status

cloud-init 主要服务组件

安装完成后系统会有多个服务：

systemctl list-unit-files|grepcloud

常见组件：

执行流程：

cloud-init-local ↓ cloud-init ↓ cloud-config ↓ cloud-final

cloud-init 主要配置文件

默认配置路径：

/etc/cloud/

主要文件：

查看主配置：

cat/etc/cloud/cloud.cfg

cloud-init 的执行流程

cloud-init 的执行过程可以分为三个阶段：

Init Stage ↓ Config Stage ↓ Final Stage

对应配置文件中的三个模块列表：

这些模块定义在：

/etc/cloud/cloud.cfg

cloud.cfg 配置文件解析

来看一个真实生产环境中的 cloud.cfg 配置：

users:-defaultdisable_root:0ssh_pwauth:1

含义：

• users：默认创建系统默认用户
• disable_root: 0：允许 root 登录
• ssh_pwauth: 1：允许 SSH 密码登录

默认用户配置

cloud-init 默认用户配置在：

system_info:default_user:name:centoslock_passwd:truesudo:["ALL=(ALL) NOPASSWD:ALL"]

解释：

因此很多云服务器创建后默认登录用户是：

centos

而不是 root。

cloud-init 初始化模块解析

初始化阶段模块

cloud_init_modules: - disk_setup - migrator - bootcmd - write-files - growpart - resizefs - set_hostname - update_hostname - update_etc_hosts - rsyslog - users-groups - ssh

主要负责系统基础初始化。

例如：

growpart

自动扩展磁盘分区

growpart /dev/vda 1

常见于云服务器磁盘扩容。

resizefs

自动扩展文件系统

resize2fs

保证系统盘容量自动扩大。

users-groups

创建系统用户。

ssh

生成 SSH key。

Config 阶段模块

第二阶段：

cloud_config_modules:

示例：

- package-update-upgrade-install - timezone - runcmd

主要负责系统配置任务。

例如：

自动安装软件

package-update-upgrade-install

等价于：

yum update yum install

runcmd

执行用户自定义命令。

例如：

runcmd:-yum install-y nginx-systemctl restart nginx

安装Nginx,并启动它

Final 阶段模块

最后阶段：

cloud_final_modules:

例如：

- scripts-user - final-message

含义：

scripts-user

执行用户脚本。

final-message

输出 cloud-init 完成提示。

真实案例：自动设置主机名

这份配置里有一个非常实用的 bootcmd 示例：

bootcmd:-ip=$(hostname-I|awk '{print $1}')-newhost=$(echo $ip|sed 's/\./-/g')-hostnamectl set-hostname host-$newhost-echo "127.0.0.1 host-$newhost">>/etc/hosts

作用：

根据服务器 IP 自动生成 hostname。

例如：

服务器 IP

192.168.1.1

自动生成 hostname

host-192-168-1-1

最终效果：

hostname host-192-168-1-1

这种方式在批量创建服务器时非常实用。

cloud-init 常用排错命令

查看状态：

cloud-init status

查看执行日志：

/var/log/cloud-init.log

查看用户脚本日志：

/var/log/cloud-init-output.log

重新执行 cloud-init：

cloud-init clean reboot

cloud-init 在自动化运维中的价值

在实际生产环境中，cloud-init 通常用于：

自动初始化服务器

例如：

• 创建运维用户
• 配置 SSH key
• 安装基础软件

DevOps 自动化部署

常见组合：

Terraform + cloud-init

自动完成：

创建云服务器 ↓ 初始化配置 ↓ 部署服务

总结

cloud-init 是 Linux 云服务器初始化的核心组件。

掌握它可以实现：

• 自动化服务器初始化
• 批量实例统一配置
• DevOps 自动化部署

如果你经常使用云服务器、Kubernetes、自动化运维，cloud-init 是必须掌握的一项技能。