Install cloud-init

Description of 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 latest version of Alibaba Cloud cloud-init is 19.1.2, and the data source is Aliyun.

Check the cloud-init version

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

   which cloud-init

   If the output contains no path information, cloud-init is not installed. Install Alibaba Cloud cloud-init first.

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

   cloud-init --version

   If the returned version is earlier than 0.7.9, install Alibaba Cloud cloud-init.
4. Back up data on the server.

Recommended. Install Alibaba Cloud cloud-init

Perform the following operations to download cloud-init 19.1.2 whose source code is Aliyun:

1. Ensure that the python-pip dependency library is installed on the source server.
   Run the following commands to install the python3-pip dependency library for some Linux distributions:

   • CentOS and Red Hat Enterprise Linux:

     yum -y install python3-pip

   • Ubuntu and Debian:

     apt-get -y install python3-pip

   • openSUSE and SUSE:

     zypper -n install python3-pip

2. Run the following command to install Alibaba Cloud cloud-init:

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

3. Run the following command to decompress the cloud-init installation package to the current directory:

   tar -zxvf cloud-init-19.1.2.tgz

4. Go to the tools directory of the cloud-init file.
5. 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.	The major version number of CentOS 6.5 is 6.

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

Optional. Install the native cloud-init

1. Make sure that you have installed the Git, Python, and python-pip dependency libraries for the source server.
   Run the following commands to install Git, python3.6, and python3-pip dependency libraries for some Linux distributions:

   • CentOS and Red Hat Enterprise Linux:

     yum -y install git python36 python3-pip

   • Ubuntu and Debian:

     apt-get -y install git python36 python3-pip

   • openSUSE and SUSE:

     zypper -n install git python36 python3-pip

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

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

3. Go to the cloud-init directory.

   cd ./cloud-init

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

   pip3 install -r ./requirements.txt

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

   python3 setup.py install

6. Modify the cloud.cfg configuration file.
   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, you must manage the network configuration under the /etc/sysconfig/network-scripts/ directory.

   

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

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