Gitiles
Code Review Sign In
gerrit.opencord.org / platform-install / 963ec77d0ba595cec4e712a7c9a7128aa710acca
commit963ec77d0ba595cec4e712a7c9a7128aa710acca[log] [tgz]
authorAndy Bavier <acb@cs.princeton.edu>Thu Oct 22 19:39:21 2015 -0400
committerAndy Bavier <acb@cs.princeton.edu>Thu Oct 22 19:39:21 2015 -0400
treea1fd1e57e3d751c1b2d7337686d509926f6b5853
parent3f18baa860dab110bfca57f57bf34399a1e26b71 [diff]
Simplify for running off CloudLab, fix documentation
3 files changed
tree: a1fd1e57e3d751c1b2d7337686d509926f6b5853
  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. group_vars/
  10. scripts/
  11. singapore-compute.yml
  12. singapore-setup.yml
  13. tasks/
  14. templates/
README.md

openstack-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.yml and foo-compute.yml files using cloudlab-setup.yml and cloudlab-compute.yml as templates. Create a foo-hosts file with the DNS names of your nodes based on cloudlab-hosts.
  • If you are not installing on CloudLab, edit group_vars/all. Change cloudlab: true to cloudlab: false.
  • If you are installing a cluster for inclusion in the public OpenCloud, change mgmt_net_prefix in foo-setup.yml to be unique across all OpenCloud clusters.
  • 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.