操作场景
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 |
| TencentOS | 2.4 | | | | |
| | 3.1 | | | | |
| CentOS | 6 | NA | NA | ||
| | 7 | ||||
| | 8 | ||||
| Fedora | 36 | NA | NA | ||
| Kylin | 20sp1 | ||||
| openSUSE | 15.4 | NA | NA | ||
deb | Debian | 11 | ||||
| | 10 | NA | NA | ||
| | 9 | NA | NA | ||
| | 8 | NA | NA | ||
| Ubuntu | 22.04 | NA | NA | ||
| | 20.04 | ||||
| | 18.04 | ||||
| | 16.04 | NA | NA | ||
| UOS | 20 | ||||
下载 cloud-init 二进制包
1. 下载上述安装包。
2. 如果系统中已经有 cloud-init，请排查并执行如下命令，清理残留。
rm -rf /var/lib/cloudrm -rf /etc/cloudrm -rf /usr/local/bin/cloud*
3. 根据操作系统，执行如下命令：
deb（Ubuntu、Debian等）系列，执行以下命令：
dpkg -i *.deb
rpm（CentOS、Red Hat Enterprise Linux、Fedora等）系列, 执行如下命令：
rpm -ivh *.rpm
4. 查询版本是否正确安装。
cloud-init qcloud -v/usr/bin/cloud-init qcloud 0011
5. 重启后生效。
下载 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
1. 执行以下命令，解压 cloud-init 安装包。
说明
如果您使用的操作系统为 Ubuntu，请切换至 root 账号。
tar -zxvf cloud-init-20.1.0011.tar.gz
2. 执行以下命令，进入已解压的 cloud-init 安装包目录（即进入 cloud-init-20.1.0011 目录）。
cd cloud-init
3. 根据操作系统版本，安装 Python-pip。
CentOS 6/7系列，执行以下命令：
yum install python3-pip -y
Ubuntu 系列，执行以下命令：
apt-get -y install python3-pip
OpenSUSE / SUSE系列，执行以下命令：
zypper -n install python3-pip
4. 执行以下命令，升级 pip。
python3 -m pip install --upgrade pip
5. 执行以下命令，安装依赖包。
注意
Cloud-init 依赖组件 requests 2.20.0版本后，已弃用 Python2.6。如果镜像环境的 Python 解释器为 Python2.6及以下，在安装 cloud-init 依赖包之前，请执行
pip install 'requests<2.20.0' 命令，安装 requests 2.20.0 版本以下的版本。pip3 install -r requirements.txt
6. 根据操作系统版本，安装 cloud-utils 组件。
CentOS 6系列，执行以下命令：
yum install cloud-utils-growpart dracut-modules-growroot -ydracut -f
CentOS 7系列，执行以下命令：
yum install cloud-utils-growpart -y
Ubuntu 系列，执行以下命令：
apt-get install cloud-guest-utils -y
OpenSUSE / SUSE 系列，执行以下命令：
zypper install -y growpart
7. 执行以下命令，安装 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 服务会无法开机自启动。
centos6 及以下系统请选择 sysvinit，centos7 及以上系统请选择 systemd。本文以 systemd 自启动服务管理为例。
修改 cloud-init 配置文件
1. 根据不同操作系统，下载 cloud.cfg。
点此下载 Ubuntu 操作系统的 cloud.cfg。
点此下载 CentOS 操作系统的 cloud.cfg。
点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg。
2. 将
/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.servicesystemctl start cloud-init-local.servicesystemctl enable cloud-init.servicesystemctl start cloud-init.servicesystemctl enable cloud-config.servicesystemctl start cloud-config.servicesystemctl enable cloud-final.servicesystemctl start cloud-final.servicesystemctl status cloud-init-local.servicesystemctl status cloud-init.servicesystemctl status cloud-config.servicesystemctl status cloud-final.service
针对 CentOS 和 Redhat 操作系统，需执行以下命令。
将 /lib/systemd/system/cloud-init-local.service 文件替换为如下内容：
[Unit]Description=Initial cloud-init job (pre-networking)Wants=network-pre.targetAfter=systemd-remount-fs.serviceBefore=NetworkManager.serviceBefore=network-pre.targetBefore=shutdown.targetConflicts=shutdown.targetRequiresMountsFor=/var/lib/cloud[Service]Type=oneshotExecStart=/usr/bin/cloud-init init --localExecStart=/bin/touch /run/cloud-init/network-config-readyRemainAfterExit=yesTimeoutSec=0# Output needs to appear in instance console outputStandardOutput=journal+console[Install]WantedBy=cloud-init.target
将 /lib/systemd/system/cloud-init.service 文件替换为以下内容：
[Unit]Description=Initial cloud-init job (metadata service crawler)Wants=cloud-init-local.serviceWants=sshd-keygen.serviceWants=sshd.serviceAfter=cloud-init-local.serviceAfter=systemd-networkd-wait-online.serviceAfter=networking.serviceAfter=systemd-hostnamed.serviceBefore=network-online.targetBefore=sshd-keygen.serviceBefore=sshd.serviceBefore=systemd-user-sessions.serviceConflicts=shutdown.target[Service]Type=oneshotExecStart=/usr/bin/cloud-init initRemainAfterExit=yesTimeoutSec=0# Output needs to appear in instance console outputStandardOutput=journal+console[Install]WantedBy=cloud-init.target
若操作系统是 sysvinit 自启动管理服务，则执行以下命令进行设置。
说明
您可执行
strings /sbin/init | grep "sysvinit" 命令，若有返回信息，则操作系统是 sysvinit 自启动管理服务。chkconfig --add cloud-init-localchkconfig --add cloud-initchkconfig --add cloud-configchkconfig --add cloud-finalchkconfig cloud-init-local onchkconfig cloud-init onchkconfig cloud-config onchkconfig cloud-final on
安装 cloud-init
执行以下命令，安装 cloud-init
。apt-get/yum install cloud-init
说明
通过 apt-get 或 yum 命令安装的 cloud-init 默认为当前操作系统配置的软件源中默认的 cloud-init 版本。使用该方式安装的镜像创建的实例可能会存在部分配置项初始化不符合预期的情况，建议使用 手工下载 cloud-init 源码包方式 进行安装。
修改 cloud-init 配置文件
1. 根据不同操作系统，下载 cloud.cfg。
点此下载 Ubuntu 操作系统的 cloud.cfg。
点此下载 CentOS 操作系统的 cloud.cfg。
点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg。
2. 将
/etc/cloud/cloud.cfg 的内容替换为已下载的 cloud.cfg 文件内容。相关操作
注意
以下操作执行完成后，请勿重启服务器，否则需重新执行下以下操作。
1. 执行以下命令，检查 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.
2. 执行以下命令，删除 cloudinit 的缓存记录。
rm -rf /var/lib/cloud
3. 针对 Ubuntu 或 Debian 操作系统，需执行以下命令。
rm -rf /etc/network/interfaces.d/50-cloud-init.cfg
4. 针对 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/*
附录
解决无法安装 Python-pip 问题
若在安装 Python-pip 出现无此安装包或无法安装的错误，可对应实际使用的操作系统，参考以下步骤进行解决：
1. 执行以下命令，设置 EPEL 存储库。
yum install epel-release -y
2. 执行以下命令，安装 Python-pip。
yum install python3-pip -y
1. 执行以下命令，清除缓存。
apt-get clean all
2. 执行以下命令，更新软件包列表。
apt-get update -y
3. 执行以下命令，安装 Python-pip。
apt-get -y install python3-pip
