适用对象

检查cloud-init版本

不同云平台及不同版本之间的cloud-init可能互不兼容，请选择合适的版本并配置合适的数据源（datasource）。其中阿里云cloud-init的版本为0.7.6a，数据源为Aliyun。

安装cloud-init后，默认开机自启动，若所选版本不兼容或数据源配置不当，下次重启服务器时可能导致cloud-init运行异常、系统启动缓慢，甚至无法正常启动系统。

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

   which cloud-init

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

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

   cloud-init --version

   如果版本低于社区0.7.9版本（0.7.6a版本除外），您需要安装阿里云版cloud-init。

4. 完成数据备份。
   说明 不准备迁移上云的服务器需谨慎安装。

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

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

   wget http://ecs-image-utils.oss-cn-hangzhou.aliyuncs.com/cloudinit/ali-cloud-init-latest.tgz

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

   tar -zxvf ali-cloud-init-latest.tgz

3. 进入cloud-init的tools目录。
4. 运行以下命令执行安装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

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

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

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

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

2. 进入cloud-init目录。

   cd ./cloud-init

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

   pip install -r ./requirements.txt

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

   python setup.py install

5. 修改配置文件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 19.1版本不会管理/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  )

pip 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  )

pip install oauthlib

pip install -r requirements.txt