Ansible playbooks for installing OpenStack
Python Ruby Makefile Shell
Latest commit a56e431 Oct 27, 2015 @lorin lorin update readme

OpenStack on Ansible with Vagrant (unofficial)

Note: this isn't the official OpenStack-Ansible project

You almost certainly want openstack/openstack-ansible instead, which is the official OpenStack-Ansible project.


This repository contains script that will deploy OpenStack into Vagrant virtual machines. These scripts are based on the Official OpenStack Docmentation, havana release, except where otherwise noted.

See also Vagrant, Ansible and OpenStack on your laptop on SlideShare, though this refers to a much older version of this repo and so is now out of date.

Install prereqs

You'll need to install:

To install Ansible and the other required Python modules:

pip install ansible netaddr python-novaclient

(Optional) Speed up your provisioning

Install Vagrant-cachier plugin:

vagrant plugin install vagrant-cachier

It allow to share a local directory containing packages (Apt, Npm, …) cache among VMs.

Get an Ubuntu 12.04 (precise) Vagrant box

Download a 64-bit Ubuntu Vagrant box:

vagrant box add precise64

Grab this repository

This repository uses a submodule that contains some custom Ansible modules for OpenStack, so there's an extra command required after cloning the repo:

git clone
cd openstack-ansible
git submodule update --init

Bring up the cloud


This will boot three VMs (controller, network, storage, and a compute node), install OpenStack, and attempt to boot a test VM inside of OpenStack.

If everything works, you should be able to ssh to the instance from any of your vagrant hosts:

  • username: cirros
  • password: cubswin:)

Note: You may get a "connection refused" when attempting to ssh to the instance. It can take several minutes for the ssh server to respond to requests, even though the cirros instance has booted and is pingable.

Vagrant hosts

The hosts for the standard configuration are:

  • (our cloud controller)
  • (compute node #1)
  • (the quantum network host)
  • (the swift storage host)

You should be able to ssh to these VMs (username: vagrant, password: vagrant). You can also authenticate with the vagrant private key, which is included here as the file vagrant_private_key (NOTE: git does not manage file permissions, these must be set to using "chmod 0600 vagrant_private_key" or ssh and ansible will fail with an error).

Interacting with your cloud

You can interact with your cloud directly from your desktop, assuming that you have the python-novaclient installed.

Note that the openrc file will be created on the controller by default.