Ursula provides a series of Ansible playbooks for installing, managing and maintaining OpenStack powered clouds.

Ursula was originally created by a team at Blue Box and is released under the MIT License (MIT).

git clone [email protected]:blueboxgroup/ursula.git
cd ursula
sudo bin/install-ubuntu || sudo bin/install-osx

Ursula requires that you have access to a minimum of 3 hosts running ubuntu 12.04, and you can ssh to them from your workstation.

Create a new environment, keep it somewhere outside this repo:

cp envs/example /your/env

Add your hosts to the inventory:

$editor /your/new/env/hosts

Ursula comes bundled with Vagrant hooks to get started. see docs/vagrant.md for using it.

# run the main playbook to install and configure all the things
./bin/ursula /your/new/env site.yml

An environment consists of two things:

• hosts: a host inventory
• group_vars: a directory of env-specific vars

To create a new env, copy the example env directory, and edit it to suit your needs:

cp -r envs/example /some/private/dir
# edit /some/private/dir/hosts, /some/private/dir/group_vars/all.yml

There are a few attributes that allow you to use a proxy server in several different ways.

This sets the http_proxy environment variable in /etc/environment for the duration of the ansible run.

common.ansible_proxy: http://10.230.7.181:3128

This sets the http_proxy environment variable in /etc/environment but does not remove it like the above.

common.global_proxy: http://10.230.7.181:3128

This sets your proxy only for apt repositories:

common.apt_cache: http://10.230.7.181:3128

Please see this doc for more information on getting started.

See the /doc directory of this repo.