操作场景
安装 cloud-init 推荐以下三种方式：
通过 下载 cloud-init 二进制包
通过 手工下载 cloud-init 源码包方式
通过 使用软件源上的 cloud-init 包方式
前提条件：
安装 cloud-init 的服务器可正常访问外网。
操作步骤：
下载 cloud-init 二进制包：
说明
cloud-init 依赖于
qcloud-python, qcloud-python 是腾讯云重新编译打包的软件包，是单独的 python 环境，仅用于 cloud-init 运行环境，建议您根据对应操作系统下载安装包，并安装在 /usr/local/qcloud/python 目录下，与系统中默认的 python 不相冲突。
cloud-init 是腾讯云基于社区20.1版本研发的，适配腾讯云运行环境的专属 cloud-init。
cloud-init 二进制包支持如下 OS:
OS | 版本 | x86_64 | arm64 | ||
qcloud-python | cloud-init | qcloud-python | cloud-init | ||
CentOS | 6 | qcloud-python-3.7.10-2.el6.x86_64.rpm | cloud-init-20.1.0011-2.el6.x86_64.rpm | NA | NA |
7 | qcloud-python-3.7.10-1.el7.x86_64.rpm | cloud-init-20.1.0011-1.el7.x86_64.rpm | qcloud-python-3.7.10-1.el7.centos.aarch64.rpm | cloud-init-20.1.0011-3.el7.centos.aarch64.rpm | |
8 | qcloud-python-3.7.10-1.el8.x86_64.rpm | cloud-init-20.1.0011-5.el8.x86_64.rpm | qcloud-python-3.7.10-1.el8.aarch64.rpm | cloud-init-20.1.0011-3.el8.aarch64.rpm | |
Fedora | 36 | qcloud-python-3.7.10-2.fc36.x86_64.rpm | cloud-init-20.1.0011-2.fc36.x86_64.rpm | NA | NA |
Kylin | 10sp1 | qcloud-python-3.7.10-1.ky10.x86_64.rpm | cloud-init-20.1.0011-2.ky10.x86_64.rpm | qcloud-python-3.7.10-1.ky10.aarch64.rpm | cloud-init-20.1.0011-1.ky10.aarch64.rpm |
openSUSE | 15.4 | qcloud-python-3.7.10-2.x86_64.rpm | cloud-init-20.1.0011-2.x86_64.rpm | NA | NA |
Debian | 11 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | qcloud-python_3.7.10-1_arm64.deb | cloud-init_20.1.0011-1_arm64.deb |
10 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | NA | NA | |
9 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | NA | NA | |
8 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | NA | NA | |
Ubuntu | 24.04 | cloud-init_20.1.0011-1_amd64.deb | NA | NA | NA |
22.04 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | NA | NA | |
20.04 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | qcloud-python_3.7.10-1_arm64.deb | cloud-init_20.1.0011-1_arm64.deb | |
18.04 | qcloud-python_3.7.10-1%2Bubuntu18.04_amd64.deb | cloud-init_20.1.0011-1%2Bubuntu18.04_amd64.deb | qcloud-python_3.7.10-1_arm64.deb | cloud-init_20.1.0011-1_arm64.deb | |
16.04 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | NA | NA | |
UOS | 20 | qcloud-python_3.7.10-1_amd64.deb | cloud-init_20.1.0011-1_amd64.deb | qcloud-python_3.7.10-1_arm64.deb | cloud-init_20.1.0011-1_arm64.deb |
下载 cloud-init 二进制包
下载上述安装包。
如果系统中已经有 cloud-init，请排查并执行如下命令，清理残留。
rm -rf /var/lib/cloud
rm -rf /etc/cloud
rm -rf /usr/local/bin/cloud*
根据操作系统，执行如下命令：
deb（Ubuntu、Debian等）系列，执行以下命令：
dpkg -i *.deb
rpm（CentOS、Red Hat Enterprise Linux、Fedora等）系列, 执行如下命令：
rpm -ivh *.rpm
查询版本是否正确安装。
cloud-init qcloud -v
/usr/bin/cloud-init qcloud 0011
重启后生效。
手工下载 cloud-init 源码包方式：
下载 cloud-init 源码包
说明
在正常安装的情况下
，cloud-init-20.1.0011 版本与腾讯云的兼容性最佳，可以保证使用该镜像创建的云服务器的所有配置项都可以正常初始化。建议选择 cloud-init-20.1.0011.tar.gz 安装版本。您也可以 点此获取 其他版本的 cloud-init 源码包。本文以 cloud-init-20.1.0011 版本为例。
执行以下命令，下载 cloud-init 源码包。
wget https://gerryguan-1306210569.cos.ap-chongqing.myqcloud.com/cloud-init/src/cloud-init-20.1.0011.tar.gz
安装 cloud-init
执行以下命令，解压 cloud-init 安装包。
说明
如果您使用的操作系统为 Ubuntu，请切换至 root 账号。
tar -zxvf cloud-init-20.1.0011.tar.gz
执行以下命令，进入已解压的 cloud-init 安装包目录（即进入 cloud-init-20.1.0011 目录）。
cd cloud-init
根据操作系统版本，安装 Python-pip。
CentOS 6/7系列，执行以下命令：
yum install python3-pip -y
Ubuntu 系列，执行以下命令：
apt-get -y install python3-pip
OpenSUSE / SUSE系列，执行以下命令：
zypper -n install python3-pip
若在安装时，出现无法安装或找不到安装包的错误，可参考 解决无法安装 Python-pip 问题 进行处理。
执行以下命令，升级 pip。
python3 -m pip install –upgrade pip
执行以下命令，安装依赖包。
注意
cloud-init 依赖组件 requests 2.20.0版本后，已弃用 Python 2.6。如果镜像环境的 Python 解释器为 Python 2.6及以下，在安装 cloud-init 依赖包之前，请执行
pip install 'requests<2.20.0' 命令，安装 requests 2.20.0 版本以下的版本。如果提示缺少
jinja2 或 yaml 模块，请手动安装：pip3 install jinja2 pyyaml
CentOS/RedHat：
yum install python3-jinja2 python3-PyYAML -y
Ubuntu/Debian：
apt-get install python3-jinja2 python3-yaml -y
通用方案：
pip3 install jinja2 pyyaml
根据操作系统版本，安装 cloud-utils 组件。
CentOS 6系列，执行以下命令：
yum install cloud-utils-growpart dracut-modules-growroot -y
dracut -f
CentOS 7系列，执行以下命令：
yum install cloud-utils-growpart -y
Ubuntu 系列，执行以下命令：
apt-get install cloud-guest-utils -y
OpenSUSE / SUSE 系列，执行以下命令：
zypper install -y growpart
执行以下命令，安装 cloud-init。
python3 setup.py build
python3 setup.py install –init-system systemd
注意
–init-system 的可选参数有：(systemd, sysvinit, sysvinit_deb, sysvinit_freebsd, sysvinit_openrc, sysvinit_suse, upstart) [default: None]。请根据当前操作系统使用的自启动服务管理方式，进行选择。若选择错误，cloud-init 服务会无法开机自启动。
CentOS 6 及以下系统请选择 sysvinit，CentOS 7 及以上系统请选择 systemd。本文以 systemd 自启动服务管理为例。
执行以下命令，根据返回结果确认自启动服务管理方式：
systemd 系统：
strings /sbin/init | grep “/lib/system”
sysvinit 系统
strings /sbin/init | grep “sysvinit”
修改 cloud-init 配置文件
根据不同操作系统，下载 cloud.cfg。
点此下载 Ubuntu 操作系统的 cloud.cfg。
点此下载 CentOS 操作系统的 cloud.cfg。
点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg。
将
/etc/cloud/cloud.cfg 的内容替换为已下载的 cloud.cfg 文件内容。添加 syslog 用户
执行以下命令，添加 syslog 用户。
useradd syslog
设置 cloud-init 服务开机自启动
若操作系统是 systemd 自启动管理服务，则执行以下命令进行设置。
说明
您可执行
strings /sbin/init | grep "/lib/system" 命令，若有返回信息，则操作系统是 systemd 自启动管理服务。针对 Ubuntu 或 Debian 操作系统，需执行以下命令。
ln -s /usr/local/bin/cloud-init /usr/bin/cloud-init
所有操作系统都需执行以下命令。
systemctl enable cloud-init-local.service
systemctl start cloud-init-local.service
systemctl enable cloud-init.service
systemctl start cloud-init.service
systemctl enable cloud-config.service
systemctl start cloud-config.service
systemctl enable cloud-final.service
systemctl start cloud-final.service
systemctl status cloud-init-local.service
systemctl status cloud-init.service
systemctl status cloud-config.service
systemctl status cloud-final.service
针对 CentOS 7 及以上版本、Red Hat Enterprise Linux 7 及以上版本的操作系统，需执行以下命令。
备份原始文件：
cp /usr/lib/systemd/system/cloud-init-local.service /usr/lib/systemd/system/cloud-init-local.service.bak
使用 root 权限编辑文件：
sudo vim /usr/lib/systemd/system/cloud-init.service将
/usr/lib/systemd/system/cloud-init-local.service文件替换为如下内容：[Unit]
Description=Initial cloud-init job (pre-networking)
Wants=network-pre.target
After=systemd-remount-fs.service
Before=NetworkManager.service
Before=network-pre.target
Before=shutdown.target
Conflicts=shutdown.target
RequiresMountsFor=/var/lib/cloud
[Service]
Type=oneshot
ExecStart=/usr/bin/cloud-init init –local
ExecStart=/bin/touch /run/cloud-init/network-config-ready
RemainAfterExit=yes
TimeoutSec=0
# Output needs to appear in instance console output
StandardOutput=journal+console
[Install]
WantedBy=cloud-init.target
针对使用 systemd 初始化系统的发行版（包括 CentOS 7+、RHEL 7+、Fedora 22+、OpenSUSE 15+等），需执行以下操作：
将
/usr/lib/systemd/system/cloud-init.service文件替换为如下内容：[Unit]
Description=Initial cloud-init job (metadata service crawler)
Wants=cloud-init-local.service
Wants=sshd-keygen.service
Wants=sshd.service
After=cloud-init-local.service
After=systemd-networkd-wait-online.service
After=networking.service
After=systemd-hostnamed.service
Before=network-online.target
Before=sshd-keygen.service
Before=sshd.service
Before=systemd-user-sessions.service
Conflicts=shutdown.target
[Service]
Type=oneshot
ExecStart=/usr/bin/cloud-init init
RemainAfterExit=yes
TimeoutSec=0
# Output needs to appear in instance console output
StandardOutput=journal+console
[Install]
WantedBy=cloud-init.target
替换内容后验证 unit 文件语法：
systemd-analyze verify /usr/lib/systemd/system/cloud-init.service若使用非 x86_64架构，需确认 Service 单元中的执行路径是否存在差异。
若操作系统是 sysvinit 自启动管理服务，则执行以下命令进行设置。
说明
您可执行
strings /sbin/init | grep "sysvinit" 命令，若有返回信息，则操作系统是 sysvinit 自启动管理服务。chkconfig –add cloud-init-local
chkconfig –add cloud-init
chkconfig –add cloud-config
chkconfig –add cloud-final
chkconfig cloud-init-local on
chkconfig cloud-init on
chkconfig cloud-config on
chkconfig cloud-fin
使用软件源上的 cloud-init 包方式：
安装 cloud-init
执行以下命令，安装 cloud-init
。
对于 Debian/Ubuntu 系统（使用 apt）：
sudo apt-get update
sudo apt-get install -y cloud-init
对于 RHEL/CentOS 系统（使用 yum）：
sudo yum install -y cloud-init
对于 openSUSE/SLES 系统（使用 zypper）：
sudo zypper refresh
sudo zypper install -y cloud-init
对于 Alpine Linux 系统（使用 apk）：
sudo apk add cloud-init
说明
通过 apt-get 或 yum 命令安装的 cloud-init 默认为当前操作系统配置的软件源中默认的 cloud-init 版本。使用该方式安装的镜像创建的实例可能会存在部分配置项初始化不符合预期的情况，建议使用 手工下载 cloud-init 源码包方式 进行安装。
修改 cloud-init 配置文件
方法一：直接替换
根据不同操作系统，下载 cloud.cfg。
点此下载 Ubuntu 操作系统的 cloud.cfg。
点此下载 CentOS 操作系统的 cloud.cfg。
点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg。
点此下载 Red Hat 操作系统的 cloud.cfg。
将
/etc/cloud/cloud.cfg 的内容替换为已下载的 cloud.cfg 文件内容。方法二：手动编辑
打开配置文件。
sudo vim /etc/cloud/cloud.cfg
将
cloud_init_modules之前的内容改为如下配置：# The top level settings are used as module
# and base configuration.
# A set of users which may be applied and/or used by various modules
# when a ‘default’ entry is found it will reference the ‘default_user’
# from the distro configuration specified below
users:
– default
# If this is set, ‘root’ will not be able to ssh in and they
# will get a message to login instead as the default $user
disable_root: false
resize_rootfs_tmp: /dev
ssh_pwauth: false
# This will cause the set+update hostname module to not operate (if true)
preserve_hostname: false
# If you use datasource_list array, keep array items in a single line.
# If you use multi line array, ds-identify script won’t read array items.
# Example datasource config
# datasource:
# Ec2:
# metadata_urls: [ ‘blah.com’ ]
# timeout: 5 # (defaults to 50 seconds)
# max_wait: 10 # (defaults to 120 seconds)
datasource_list: [ ConfigDrive ]
# The modules that run in the ‘init’ stage
cloud_init_modules:
修改
update_etc_hosts 的配置：cloud_init_modules:
– migrator
– seed_random
– bootcmd
– write_files
– growpart
– resizefs
– set_hostname
– update_hostname
# 修改这一行
– [‘update_etc_hosts’, ‘once-per-instance’]
– rsyslog
– users_groups
– ssh
确保系统默认账户符合预期。
说明：
此处只检查 default_user 中的 name 字段，请勿直接复制。
# System and/or distro specific settings
# (not accessible to handlers/transforms)
system_info:
# This will affect which distro class gets used
distro: ubuntu
# Default user name + that default users groups (if added/used)
default_user:
name: ubuntu # 这里是 ubuntu 账号
lock_passwd: false
gecos: Cloud User
groups: [adm, audio, cdrom, dialout, dip, floppy, lxd, netdev, plugdev, sudo, video]
sudo: [“ALL=(ALL) NOPASSWD:ALL”]
shell: /bin/bash
执行
ls /etc/cloud/cloud.cfg 确认文件路径是否存在。 如果路径不存在，请通过
sudo find / -name cloud.cfg 2>/dev/null 搜索实际路径。执行
strings /sbin/init | grep "sysvinit" 检查init系统类型。如果提示缺少 `jinja2` 或 `yaml` 模块，请手动安装：
pip3 install jinja2 pyyaml。相关操作
注意
以下操作执行完成后，请勿重启服务器，否则需重新执行以下操作。
执行以下命令，检查 cloud-init 相关配置是否成功。
cloud-init init –local
返回类似如下信息，则说明已成功配置 cloud-init。
Cloud-init v. 20.1.0011 running ‘init-local’ at Fri, 01 Apr 2022 01:26:11 +0000. Up 38.70 seconds.
执行以下命令，删除 cloud-init 的缓存记录。
rm -rf /var/lib/cloud
针对 Ubuntu 或 Debian 操作系统，需执行以下命令。
rm -rf /etc/network/interfaces.d/50-cloud-init.cfg
针对 Ubuntu 或 Debian 操作系统，需将
/etc/network/interfaces 修改为以下内容：# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).
source /etc/network/interfaces.d/*
