Skip to content

Latest commit

 

History

History
77 lines (58 loc) · 2.91 KB

readme.md

File metadata and controls

77 lines (58 loc) · 2.91 KB
Raw

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.