Ansible CloudStack Playbook

Summary

TESTED with Ubuntu 22.04 LTS

The aim of these roles are to build a single host which is ready for a zone to be created and for hosts to be added. The UI will be running and the templates for the System VMs ready to go.

The included roles will build the following elements on a single host:

1. A CloudStack Management Server
2. MySQL Server
3. An NFS server
4. KVM, XenServer, ESXi System VM templates installed
5. Cloudmonkey CLI

By default this will install CloudStack, MySQL & NFS services on the same host as you install Ansible on.

Prerequisites

Hardware

• The target host can be physical or virtual.
• 4 CPUs/vCPUs are recommended
• 4GB RAM or greater is required.
• 250GB disk minimum is recommended as this host will provide primary and secondary storage.
• As this host is acting as an NFS server, high performance is required from the underlying disks.
• 1Gb or better network connectivity

Software

These plays are (currently) written for Ubuntu 22.04 LTS and are tested against Ansible core 2.16.0b2

In latest versions of Ansible, sshpass & "host_key_checking = False" are required to enable the use of a password to login to a host rather than using SSH keys.

To install Ansible, sshpass and disable the host key checking; run:

# sudo apt update
# sudo apt install -y ansible sshpass
# sudo sed -i "/^#host_key_checking/ c\host_key_checking = False" /etc/ansible/ansible.cfg

Running the Play

To install CloudStack, cd to where you have placed the plays and run:

For local DB

ansible-playbook deploy-cloudstack.yml -i hosts -k -u root -e "mysql_root_password=Cl0ud5tack-MySQL mysql_cloud_password=Cl0ud5tack-Cl0ud cloudstack_release=4.19 cloudstack_systemvmtemplate=4.19.1 install_local_db=true"

For Adding Cloudstack master node MariaDB Galera cluster

ansible-playbook deploy-cloudstack.yml -i hosts -k -u root -e "mysql_root_password=Cl0ud5tack-MySQL mysql_cloud_password=Cl0ud5tack-Cl0ud cloudstack_release=4.19 cloudstack_systemvmtemplate=4.19.1 nodetype=master db_endpoint=10.35.10.78"

For Adding Cloudstack slaves node MariaDB Galera cluster

ansible-playbook deploy-cloudstack.yml -i hosts -k -u root -e "mysql_cloud_password=Cl0ud5tack-Cl0ud cloudstack_release=4.19 cloudstack_systemvmtemplate=4.19.1 nodetype=slave db_endpoint=10.35.10.78"

You will be prompted for the root password of the target host.

Changing Default Behaviour

By default this will install CloudStack on the same host as Ansible is installed on. To 'point' the installation at an alternate host edit the hosts file. Change 127.0.0.1 to the IP address or resolveable FQDN of the host you wish to use.

All variables are held in deploy-cloudstack.yml. To change the installed version and/or systemvm template sources edit deploy-cloudstack.yml