云服务器 Linux 系统安装 cloud-init

一、操作场景

安装 cloud-init 推荐以下三种方式：

·通过 下载 cloud-init 二进制包

·通过 手工下载 cloud-init 源码包方式

·通过 使用软件源上的 cloud-init 包方式

二、前提条件

安装 cloud-init 的服务器可正常访问外网。

三、操作步骤

下载 cloud-init 二进制包手工下载 cloud-init 源码包方式使用软件源上的 cloud-init 包方式

四、下载 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

若在安装时，出现无法安装或找不到安装包的错误，可参考 解决无法安装 Python-pip 问题 进行处理。

4. 执行以下命令，升级 pip。

python3 -m pip install –upgrade pip

5. 执行以下命令，安装依赖包。

注意：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

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

注意：strings /sbin/init | grep "/lib/system"

注意：strings /sbin/init | grep "sysvinit"

七、修改 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.service systemctl 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 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.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

·针对使用 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.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

·替换内容后验证 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-localchkconfig –add cloud-initchkconfig –add cloud-configchkconfig –add cloud-finalchkconfig cloud-init-local on chkconfig cloud-init on chkconfig cloud-config on chkconfig cloud-fin

十、安装 cloud-init

执行以下命令，安装 cloud-init。

·对于 Debian/Ubuntu 系统（使用 apt）：

sudo apt-get updatesudo apt-get install -y cloud-init

·对于 RHEL/CentOS 系统（使用 yum）：

sudo yum install -y cloud-init

·对于 openSUSE/SLES 系统（使用 zypper）：

sudo zypper refreshsudo zypper install -y cloud-init

·对于 Alpine Linux 系统（使用 apk）：

sudo apk add cloud-init

注意：通过 apt-get 或 yum 命令安装的 cloud-init 默认为当前操作系统配置的软件源中默认的 cloud-init 版本。使用该方式安装的镜像创建的实例可能会存在部分配置项初始化不符合预期的情况，建议使用 手工下载 cloud-init 源码包方式 进行安装。

十一、方法一：直接替换

1. 根据不同操作系统，下载 cloud.cfg。

·点此下载 Ubuntu 操作系统的 cloud.cfg。

·点此下载 CentOS 操作系统的 cloud.cfg。

·点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg。

·点此下载 Red Hat 操作系统的 cloud.cfg。

2. 将 /etc/cloud/cloud.cfg 的内容替换为已下载的 cloud.cfg 文件内容。

十二、方法二：手动编辑

1. 打开配置文件。

sudo vim /etc/cloud/cloud.cfg

2. 将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 belowusers: – 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 $userdisable_root: falseresize_rootfs_tmp: /devssh_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' stagecloud_init_modules:

3. 修改 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

4. 确保系统默认账户符合预期。

注意：说明：

注意：此处只检查 default_user 中的 name 字段，请勿直接复制。

Ubuntu 系列其他系统# 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# System and/or distro specific settings# (not accessible to handlers/transforms)system_info: # This will affect which distro class gets used distro: rhel # CentOS/RedHat系列 # Default user name + that default users groups (if added/used) default_user: name: root # 这里是 root 账号 lock_passwd: false gecos: Cloud User groups: [wheel, adm, systemd-journal] 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。

十三、相关操作

注意：以下操作执行完成后，请勿重启服务器，否则需重新执行以下操作。

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. 执行以下命令，删除 cloud-init 的缓存记录。

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 出现无此安装包或无法安装的错误，可对应实际使用的操作系统，参考以下步骤进行解决：

CentOS 6/7系列Ubuntu 系列1. 执行以下命令，设置 EPEL 存储库。yum install epel-release -y2. 执行以下命令，安装 Python-pip。yum install python3-pip -y1. 执行以下命令，清除缓存。apt-get clean all2. 执行以下命令，更新软件包列表。apt-get update -y3. 执行以下命令，安装 Python-pip。apt-get -y install python3-pip