tencent cloud

Downloading the cloud-init source package

Note

• cloud-init-17.1.tar.gz is recommended. You can visit https://launchpad.net/cloud-init/+download to download other versions.
• If the installation fails, you can try the portable cloud-init package

Run the following command to download the cloud-init source package:

wget https://launchpad.net/cloud-init/trunk/17.1/+download/cloud-init-17.1.tar.gz

Installing cloud-init

1. Run the following command to decompress the cloud-init installation package:
   

   Note

   If you are using the Ubuntu operating system, run this command with the “root” account.

   
   

   tar -zxvf cloud-init-17.1.tar.gz 
   

2. Run the following command to enter the decompressed cloud-init installation package directory; that is, the cloud-init-17.1 directory:
   

   cd cloud-init-17.1
   

3. Install Python-pip according to the operating system version.

• For CentOS 6/7, run the following command:
  

  yum install python-pip -y
  

• For Ubuntu, run the following command:
  

  apt-get install python-pip -y
  

  
  During installation, if an error such as “failed to install” or “installation package not found” occurs, see resolving Python-pip installation failure to troubleshoot it.

4. Run the following command to install dependencies:
   

   Note

   Python 2.6 is not supported when cloud-init uses requests 2.20.0 or later. If the Python interpreter installed in the image environment is Python version 2.6 or earlier, run the pip install 'requests<2.20.0' command to install requests 2.20.0 or later before installing the cloud-init dependencies.

   
   

   pip install -r requirements.txt
   

5. Install the cloud-utils components corresponding to your OS version.

• For CentOS 6, run the following command:
  

  yum install cloud-utils-growpart dracut-modules-growroot -y
  dracut -f
  

• For CentOS 7, run the following command:
  

  yum install cloud-utils-growpart -y
  

• For Ubuntu, run the following command:
  

  apt-get install cloud-guest-utils -y
  

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

   python setup.py build
   

   
   

   python setup.py install --init-system systemd
   

   Note

   The --init-system can be followed by any of systemd, sysvinit, sysvinit_deb, sysvinit_freebsd, sysvinit_openrc, sysvinit_suse or upstart [default: None]. Please configure parameters based on the auto-start service management method of the operating system. If incorrect parameters are configured, the cloud-init service cannot automatically start upon system startup. This document uses the systemd auto-start service management method as an example.

Modifying the cloud-init configuration file

1. Download cloud.cfg for your operating system.

• Click here to download cloud.cfg for Ubuntu.
• Click here to download cloud.cfg for CentOS.

2. Replace the content of /etc/cloud/cloud.cfg with that of the downloaded cloud.cfg file.

Adding syslog user

Run the following command to add a syslog user:

useradd syslog

Configuring the auto-start of the cloud-init service on boot

• If your operating system uses the systemd auto-start service management method, run the following commands.
  

  Note

  To check whether the operating system uses systemd, run the strings /sbin/init | grep "/lib/system" command, and you will receive a return message.

1. Run the following command in Ubuntu or Debian:
   

   ln -s /usr/local/bin/cloud-init /usr/bin/cloud-init 
   

2. Run the following commands in all operating systems:
   

   systemctl enable cloud-init-local.service 
   systemctl start cloud-init-local.service
   systemctl enable cloud-init.service
   systemctl start cloud-init.service
   systemctl enable cloud-config.service
   systemctl start cloud-config.service
   systemctl enable cloud-final.service
   systemctl start cloud-final.service
   systemctl status cloud-init-local.service
   systemctl status cloud-init.service
   systemctl status cloud-config.service
   systemctl status cloud-final.service
   
   

3. Run the following command in CentOS or Redhat.
   Replace the content of /lib/systemd/system/cloud-init-local.service with the following:
   

   [Unit]
   Description=Initial cloud-init job (pre-networking)
   Wants=network-pre.target
   After=systemd-remount-fs.service
   Before=NetworkManager.service
   Before=network-pre.target
   Before=shutdown.target
   Conflicts=shutdown.target
   RequiresMountsFor=/var/lib/cloud
   [Service]
   Type=oneshot
   ExecStart=/usr/bin/cloud-init init --local
   ExecStart=/bin/touch /run/cloud-init/network-config-ready
   RemainAfterExit=yes
   TimeoutSec=0
   # Output needs to appear in instance console output
   StandardOutput=journal+console
   [Install]
   WantedBy=cloud-init.target
   

   
   Replace the content of /lib/systemd/system/cloud-init.service with the following:
   

   [Unit]
   Description=Initial cloud-init job (metadata service crawler)
   Wants=cloud-init-local.service
   Wants=sshd-keygen.service
   Wants=sshd.service
   After=cloud-init-local.service
   After=systemd-networkd-wait-online.service
   After=networking.service
   After=systemd-hostnamed.service
   Before=network-online.target
   Before=sshd-keygen.service
   Before=sshd.service
   Before=systemd-user-sessions.service
   Conflicts=shutdown.target
   [Service]
   Type=oneshot
   ExecStart=/usr/bin/cloud-init init
   RemainAfterExit=yes
   TimeoutSec=0
   # Output needs to appear in instance console output
   StandardOutput=journal+console
   [Install]
   WantedBy=cloud-init.target
   

• If your operating system uses the sysvinit auto-start service management method, run the following commands:
  

  Note

  To check whether the operating system uses sysvinit, run the strings /sbin/init | grep "sysvinit" command, and you will receive a return message.

  
  

  chkconfig --add cloud-init-local
  chkconfig --add cloud-init
  chkconfig --add cloud-config
  chkconfig --add cloud-final
  chkconfig cloud-init-local on 
  chkconfig cloud-init on 
  chkconfig cloud-config on 
  chkconfig cloud-final on 
  

Installing cloud-init

Run the following command to install cloud-init:

apt-get/yum install cloud-init

Note

By default, the cloud-init version installed by running apt-get or yum is the default cloud-init version in the software source configured for the operating system. Some configuration items of instances created by using the image whose cloud-init is installed this way may not be initialized as expected. Therefore, we recommend that you install the service by manually downloading the cloud-init source package.

Modifying the cloud-init configuration file

1. Download cloud.cfg for your operating system.

• Click here to download cloud.cfg for Ubuntu.
• Click here to download cloud.cfg for CentOS.

2. Replace the content of /etc/cloud/cloud.cfg with that of the downloaded cloud.cfg file.

1. Run the following command to configure the EPEL storage repository.
   

   yum install epel-release -y
   

2. Run the following command to install Python-pip.
   

   yum install python-pip -y
   

1. Run the following command to update the software package list.
   

   apt-get update -y
   

2. Run the following command to install Python-pip.
   

   apt-get install python-pip -y