Update README.md
1 file changed
tree: 054af526d5c98a3d364563b60104496af55bf9a5
  1. LICENSE
  2. README.md
  3. ansible.cfg
  4. cloudlab-compute.yml
  5. cloudlab-hosts
  6. cloudlab-setup.yml
  7. enable-virt-dell.yml
  8. files/
  9. scripts/
  10. singapore-compute.yml
  11. singapore-setup.yml
  12. tasks/
  13. templates/
README.md

opencloud-cluster-setup

This repository contains Ansible playbooks for installing and configuring an OpenStack Kilo cluster for use in OpenCloud. All of the OpenStack controller services are installed in VMs on a single "head node" and connected by an isolated private network. Juju is used to install and configure the OpenStack services.

How to use it

The playbook is designed to be run on a separate control machine that has a recent version of Ansible installed (e.g., a laptop). Here are the basic steps for installing a new OpenCloud cluster named 'foo':

  • Install Ubuntu 14.04 LTS on the head and compute nodes.
  • Create foo-setup.yaml and foo-compute.yaml files using cloudlab-setup.yaml and cloudlab-compute.yaml as templates.
    • Create a foo-hosts file with the DNS names of your nodes.
    • Change the - hosts: lines as appropriate for your own head and compute nodes.
    • Change ctl.install.xos-pg0.clemson.cloudlab.us in foo-setup.yaml to the DNS name of your head node.
  • To set up Juju, use it to install the OpenStack services on the head node, and prep the compute nodes, run on the head node:
$ ansible-playbook -i foo-hosts foo-setup.yaml
  • Log into the head node. For each compute node, put it under control of Juju, e.g.:
$ juju add-machine ssh:ubuntu@compute-node
  • To install the nova-compute service on the compute nodes that were added to Juju, run on the control machine:
$ ansible-playbook -i foo-hosts foo-compute.yaml

Things to note

  • The installation configures port forwarding so that the OpenStack services can be accessed from outside the private network. Some OpenCloud-specific firewalling is also introduced, which will likely require modification for other setups. See: files/etc/libvirt/hooks/qemu.
  • By default the compute nodes are controlled and updated automatically using ansible-pull from this repo. You may want to change this.
  • All of the service interfaces are configured to use SSL because that's what OpenCloud uses in production. Again, may not be what you want. Look for the relevant Juju commands in cloudlab-setup.yaml.