安装cloud-init

版本说明

不同云平台及不同版本之间的cloud-init不完全兼容，请选择合适的版本并配置合适的数据源（datasource）。其中，阿里云cloud-init的最新版本为19.1.2，数据源为Aliyun。

检查cloud-init版本

1. 登录源服务器。
2. 运行以下命令检查是否已安装cloud-init。

   which cloud-init

   无路径输出信息表示未安装，您需要安装阿里云版cloud-init。

3. 运行以下命令检查cloud-init版本号。

   cloud-init --version

   如果返回版本低于社区0.7.9版本，您需要安装阿里云版cloud-init 19.1.2。
4. 完成服务器数据备份。

（推荐）安装阿里云版cloud-init 19.1.2

按以下步骤，下载数据源为Aliyun的19.1.2版本cloud-init。

1. 确保源服务器已安装Python PIP依赖库。
   以安装python3-pip依赖库为例，Linux部分发行版的安装命令如下。

   • CentOS/Red Hat Enterprise Linux：

     yum -y install python3-pip

   • Ubuntu/Debian：

     apt-get -y install python3-pip

   • OpenSUSE/SUSE：

     zypper -n install python3-pip

2. 运行以下命令下载阿里云版cloud-init。

   wget https://ecs-image-utils.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.2.tgz

3. 运行以下命令解压cloud-init安装包到当前目录。

   tar -zxvf cloud-init-19.1.2.tgz

4. 进入cloud-init目录下，并安装依赖库。

   cd ./cloud-init-19.1.2
   pip3 install -r ./requirements.txt

5. 进入cloud-init的tools目录。

   cd ./tools

6. 运行以下命令执行安装cloud-init的脚本deploy.sh。

   bash ./deploy.sh <issue> <major_version>

   deploy.sh脚本的参数说明和取值示例如下：

   参数	说明	示例
   issue	操作系统平台类型。取值范围：centos | redhat |rhel | debian | ubuntu | opensuse | sles。参数取值均大小写敏感，其中sles表示SUSE/SLES。	centos
   major_version	操作系统平台主要版本号。	CentOS 6.5的主要版本号为6

7. 确认cloud-init是否安装成功。
   若返回"description": "success"，表示安装成功。

（可选）安装阿里云版cloud-init 0.7.6a15

1. 运行以下命令，检查操作系统的版本为CentOS 6、Debian 9及SUSE Linux Enterprise Server 12。

   cat /etc/issue

2. 运行以下命令，下载并解压阿里云版cloud-init 0.7.6a15。

   wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloud-init-0.7.6a15.tgz
   tar -zxvf cloud-init-0.7.6a15.tgz

3. 进入cloud-init的tools目录。

   cd cloud-init-0.7.6a15/tools/

4. 运行以下命令。安装cloud-init。

   bash ./deploy.sh <issue> <major_version>

   deploy.sh脚本的参数说明和取值示例如下：

   参数	说明	示例
   issue	操作系统平台类型。取值范围：centos | debian | sles。参数取值均大小写敏感，其中sles表示SUSE/SLES。	centos
   major_version	操作系统平台主要版本号。	CentOS 6.5的主要版本号为6

（可选）安装社区版cloud-init

1. 确保源服务器已安装Git、Python和Python PIP依赖库。
   以安装git、python3.6和python3-pip依赖库为例，Linux部分发行版的安装命令如下。

   • CentOS/Red Hat Enterprise Linux：

     yum -y install git python36 python3-pip

   • Ubuntu/Debian：

     apt-get -y install git python36 python3-pip

   • OpenSUSE/SUSE：

     zypper -n install git python36 python3-pip

2. 运行以下命令使用git下载cloud-init源码包。

   git clone https://git.launchpad.net/cloud-init

3. 进入cloud-init目录。

   cd ./cloud-init

4. 运行以下命令安装所有依赖库。

   pip3 install -r ./requirements.txt

5. 运行以下命令安装cloud-init。

   python3 setup.py install

6. 修改配置文件cloud.cfg。
   1. 打开配置文件。

      vi /etc/cloud/cloud.cfg

      
   2. 将cloud_init_modules:之前的配置修改为以下内容。

      # Example datasource config
      # The top level settings are used as module
      # and system 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
      user:
          name: root
          lock_passwd: False
      # If this is set, 'root' will not be able to ssh in and they 
      # will get a message to login instead as the above $user
      disable_root: false
      # This will cause the set+update hostname module to not operate (if true)
      preserve_hostname: false
      syslog_fix_perms: root:root
      datasource_list: [ AliYun ]
      # Example datasource config
      datasource:
          AliYun:
              support_xen: false
              timeout: 5 # (defaults to 50 seconds)
              max_wait: 60 # (defaults to 120 seconds)
      #      metadata_urls: [ 'blah.com' ]
      # The modules that run in the 'init' stage
      cloud_init_modules:

（可选）自定义网络配置

1. 安装了cloud-init后，打开/etc/cloud/cloud.cfg文件。

   vim /etc/cloud/cloud.cfg

2. 在Example datasource config之前增加disabled配置。

   network:
     config: disabled

   说明 增加该配置之后，cloud-init不会管理/etc/sysconfig/network-scripts/下网络配置，需要您自行管理。

   

故障排查

• 不同镜像缺少的库可能不同，您都可以通过pip安装，之后再次安装cloud-init。
• 如果系统默认软件包管理器（例如yum）和pip管理器分别安装过不同版本的依赖库，可能造成库版本冲突，导致cloud-init运行异常。建议您根据报错信息按需下载依赖库。

no setuptools module in python

File "/root/cloud-init/cloudinit/log.py", line 19, in <module>
      import six
  ImportError: No module named six  )

pip3 install six

File "/root/cloud-init/cloudinit/url_helper.py", line 20, in <module>
      import oauthlib.oauth1 as oauth1
  ImportError: No module named oauthlib.oauth1  )

pip3 install oauthlib

pip3 install -r requirements.txt