Overview
In order to use RightLink 10 on clouds that are not supported by cloud-init, you will need to use the RightScale-provided cloud-init package. See the supported clouds list below to determine if you need the RightScale-provided cloud-init package to support your desired cloud. RightScale cloud-init differs from the stock cloud-init by adding a plugin for the SoftLayer cloud. RightScale cloud-init will always have RightScale as the package Vendor/Maintainer and rightscale
in the release name.
Cloud | Cloud-init Type |
---|---|
EC2, Azure, Google[2], OpenStack, RCA-V [1] | Vanilla |
Softlayer | RightScale |
[1] Requires RCA-V version 2.0_20160415_21 or above
[2] CentOS 6.x on GCE has a specific note below
Installing Vanilla Cloud-Init
The installation steps for 'vanilla' cloud-init will vary depending on your operating system. The following sections provide instructions specific to each of the supported operating systems.
Red Hat Based Systems, Such as CentOS
Depending on the specific version of your system, cloud-init may be part of the Extras
repo. If not, the packages may be found in the Fedora Extra Packages for Enterprise Linux repository. Use the following command-line to install cloud-init on Red Hat-based systems.
yum -y install cloud-init
CentOS 6x on GCE: We have observed intermittent issues with the CentOS 6.x native version of cloud-init (cloud-init-0.7.5-10.el6.centos.2.src.rpm) hanging prior to our userdata script being executed. The suggested workaround for this is to use the RHEL version of cloud-init cloud-init-0.7.5-2.el6.src.rpm. To rebuild where epel can not update:
rpm -Uvh cloud-init-0.7.5-2.el6.src.rpm
sed -i.orig -e 's/2%{?dist}/20%{?dist}/g' ~/rpmbuild/SPECS/cloud-init.spec
rpmbuild -ba ~/rpmbuild/SPECS/cloud-init.spec
rpm -Uvh ~/rpmbuild/RPMS/x86_64/cloud-init-0.7.5-20.el6.x86_64.rpm
rm -fr ~/rpmbuild
Debian Based systems, Such as Ubuntu
Use the following command-line to install cloud-init on Debian-based systems.
apt-get -y update
apt-get -y install cloud-init
Installing RightScale Cloud-Init (Softlayer)
The installation steps for RightScale cloud-init will vary depending on your operating system. The following sections provide instructions specific to each of the supported operating systems.
CentOS 6.x/7.x
cat <<EOF > /etc/yum.repos.d/RightScale-epel.repo
[rightscale-epel]
name=RightScale Software
baseurl=http://mirror.rightscale.com/rightscale_software/centos/\$releasever/x86_64/archive/latest/
enabled=1
gpgcheck=1
gpgkey=http://mirror.rightscale.com/rightlink/rightscale.pub
priority=1
EOF
yum -y install cloud-init
Ubuntu 12.04
Note: Ubuntu 12.04 and 14.04 have similar steps to install custom cloud-init, except there are a couple of extra steps with Ubuntu 12.04. Execute the first code block first, then the second.
Ubuntu 12.04 Cloud-Init Install - Part 1
cat <<EOF > /etc/apt/preferences.d/rightscale-cloud-init-pin-1001
Package: cloud-init
Pin: version 0.7.2*
Pin-Priority: 1001
EOF
Ubuntu 12.04 Cloud-Init Install - Part 2
curl http://mirror.rightscale.com/rightlink/rightscale.pub | apt-key add -
echo "deb [arch=amd64] http://mirror.rightscale.com/rightscale_software_ubuntu/latest precise main" > /etc/apt/sources.list.d/rightscale_extra.sources.list
apt-get -y update
apt-get -y --force-yes install cloud-init
Ubuntu 14.04
Ubuntu 14.04 Cloud-Init Install
curl http://mirror.rightscale.com/rightlink/rightscale.pub | apt-key add -
echo "deb [arch=amd64] http://mirror.rightscale.com/rightscale_software_ubuntu/latest trusty main" > /etc/apt/sources.list.d/rightscale_extra.sources.list
apt-get -y update
apt-get -y --force-yes install cloud-init