Install cloud-init

Scenarios

Check the cloud-init version

Different cloud platforms may use different versions of cloud-init. Select the appropriate version and configure it with the appropriate data source (datasource). The version of Alibaba Cloud cloud-init is 0.7.6a, and the data source is Aliyun.

After cloud-init is installed, it starts automatically during startup by default. If the installed cloud-init version is not suitable or the data source is not configured properly, cloud-init may run abnormally and the instance may start slowly or even fail to be started the next time you restart the instance.

1. Log on to the source server.
2. Run the following command to check whether cloud-init is installed:

   which cloud-init

   If no information in the output indicates that cloud-init is installed, install Alibaba Cloud cloud-init.

3. Run the following command to check the version of cloud-init:

   cloud-init --version

   If the version is earlier than the Community v0.7.9 (except for v0.7.6 a), you must install Alibaba Cloud cloud-init.

4. Complete the data backup.
   Note We recommend that you proceed with caution when you install Alibaba Cloud cloud-init on servers that will not be migrated to the cloud.

(Recommended) Install Alibaba Cloud cloud-init

1. Run the following command to download Alibaba Cloud cloud-init:

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

2. Run the following command to download and decompress the cloud-init installation package to the current directory.

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

3. Access the tools directory of cloud-init.
4. Run the following command to execute the deploy.sh script to install cloud-init:

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

   The following table describes the parameters and values in the deploy.sh script.

   Parameter	Description	Example
   issue	The type of the operating system. Valid values: centos, redhat, rhel, debian, ubuntu, opensuse, and sles. The parameter values are case-sensitive. sles stands for SUSE and SLES.	centos
   major_version	The major version number of the operating system.	For example, the major version number of CentOS 6.5 is 6.

5. Check whether cloud-init is installed.
   If "description": "success" is returned, Alibaba Cloud cloud-init is installed.

(Optional) Install Community cloud-init

1. Run the following command to download the cloud-init source code package from Git:

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

2. Access the cloud-init directory.

   cd ./cloud-init

3. Run the following command to install all the dependency libraries:

   pip install -r ./requirements.txt

4. Run the following command to install cloud-init:

   python setup.py install

5. Modify the configuration file cloud.cfg.
   1. Open the configuration file.

      vi /etc/cloud/cloud.cfg

      
   2. Modify the configuration before cloud_init_modules: as follows:

      # 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:

(Optional) Customize network configuration

1. After cloud-init is installed, open the /etc/cloud/cloud.cfg file.

   vim /etc/cloud/cloud.cfg

2. Add the disabled configuration before Example datasource config.

   network:
     config: disabled

   Note After the configuration is added, cloud-init v19.1 does not manage the network configuration under /etc/sysconfig/network-scripts/ and you must manage the network configuration manually.

   

Troubleshooting

• The libraries that are missing may vary with images. You can use pip to install the libraries and then install cloud-init again.
• If the default software package manager (such as yum) and the pip manager have been installed with different versions of dependency libraries, library version conflicts may occur and cause cloud-init to run abnormally. We recommend that you download the dependency libraries as needed based on the error message.

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