Vagrant for DevStack

This projcet holds a Vagrantfile and ansible playbooks, which set up a virtual machine, and run devstack on it.

The goal is, with a single vagrant up command, to fire up a virtual machine, install all the requirements including openstack projects and review patches, and then run devstack.

Instructions

1. Clone the project.
2. Set up a libvirt server
3. (Optional) Install an SSH public key in common/keys/id_rsa.pub
4. Create a local.conf file (Or use some of the examples in common/local.confs)
5. Add (or update) a machine in directory.conf.yml (See configuration below)
6. Run: vagrant up <machine name>

Once the VM is set up, it can be accessed using vagrant ssh -p -- -l stack. Other SSH options may follow if desired. devstack will be running within a tmux session. To see it, use tmux attach.

Configuration

Virtual machines are defined in directory.conf.yml. This is a yaml file with the following structure:

machines:
- name: Virtual machine 1
  hypervisor: ...
  ... (See below)
- name: Virtual machine 1
  hypervisor: ...
  ... (See below)

Where a virtual machine is defined with the following properties:

Field	Description
name	VM name
hypervisor	libvirt server object
memory	VM memory
vcpus	Number of virtual CPUs
box	Name of Vagrant box to run.
local_conf_file	The local.conf file to take.
projects	objects describing installed projects
devstack_version	The devstack version to use

The projects objects have the following fields:

Field	Description
name	The project name (e.g. dragonflow, neutron)
reviews	A list of gerrit review numbers to cherry-pick (Optional)
repo	The repo from which to git clone (Optional)
version	The git version to take (branch, tag, or commit hash) (Optional)

A openvswitch named project pointing to an openvswitch repository can be added to build and install from it.

The hypervisor object has two fields:

Field	Description
name	The server name (will be looked up via DNS)
username	The user with which to log in

Sample configuration directory.conf.yml.sample can be used as a startingi point.

Customisation

The virtual machine is provisioned using the devstack.yml ansible playbook. The playbooks used are available in the playbooks folder.