Ansible playbooks for deploying OpenStack.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Jenkins d9a5bbc7cd
Merge "Horizon docs have HAProxy headings"
7 years ago
doc Horizon docs have HAProxy headings 7 years ago
etc Add SSL/TLS listener to RabbitMQ 7 years ago
playbooks Update ceph key hash 7 years ago
scripts Merge "Add confirmation to" 7 years ago
.gitignore Fix the path of build docs in .gitignore 7 years ago
.gitreview Update .gitreview for project rename 7 years ago
CONTRIBUTING.rst Rename everything for the osad to osa name change 7 years ago
LICENSE.txt Add profiling for Ansible tasks 8 years ago
README.rst Add profiling for Ansible tasks 8 years ago
ansible-role-requirements.yml.example Convert existing roles into galaxy roles 8 years ago
dev-requirements.txt Adds a pep8 target to tox.ini 8 years ago
development-stack.rst Rename everything for the osad to osa name change 7 years ago
requirements.txt Update how neutron migrations are handled 8 years ago
setup.cfg Rename everything for the osad to osa name change 7 years ago Uses tox for automating documentation builds 8 years ago
tox.ini Fix incorrect tox.ini config 7 years ago


OpenStack Ansible Deployment


2015-02-02 22:00


lxc, openstack, cloud, ansible




There are several playbooks within that will setup hosts for use in OpenStack Cloud. The playbooks will enable LXC on hosts and provides the ability to deploy LXC containers for use within openstack.

  • setup-hosts.yml Performs host setup for use with LXC in the OpenStack hosts.
  • setup-infrastructure.yml Performs all of the setup for all infrastructure components.
  • setup-openstack.yml Performs all of the setup for all of the OpenStack components.
  • If you dont want to run plays individually you can simply run setup-everything.yml which will perform all of the setup and installation for you.
Basic Setup:
  1. If you have any roles that you'd like to have pulled in that are outside the scope and or replace modules within this repository please add them to the ansible-role-requirements.yml file. In this file you will want to fill in the details for the role you want to pull in using standard ansible galaxy format.
- name: SuperAwesomeModule
  version: master
  1. Run the ./scripts/ script, which will install, pip, ansible 1.9.x, all of the required python packages, and bring in any third party ansible roles that you may want to add to the deployment.
  2. Copy the etc/openstack_deploy directory to /etc/openstack_deploy.
  3. Fill in your openstack_deploy/openstack_user_config.yml, openstack_deploy/user_secrets.yml and openstack_deploy/user_variables.yml files which you've just copied to your /etc/ directory.
  4. Generate all of your random passwords executing scripts/ --file /etc/openstack_deploy/user_secrets.yml.
  5. Accomplish all of the host networking that you want to use within the deployment. See the etc/network directory in this repository for an example network setup.
  6. When ready change to the playbooks/ directory and execute your desired plays. IE:
openstack-ansible setup-everything.yml


  • If you run the ./scripts/ script a wrapper script will be added to your system that wraps the ansible-playbook command to simplify the arguments required to run openstack ansible plays. The name of the wrapper script is openstack-ansible.
  • The lxc network is created within the lxcbr0 interface. This supports both NAT networks as well as more traditional networking. If NAT is enabled (default) the IPtables rules will be created along with the interface as a post-up processes. If you ever need to recreate the rules and or restart the dnsmask process you can bounce the interface IE: ifdown lxcb0; ifup lxcbr0 or you can use the lxc-system-manage command.
  • The tool lxc-system-manage is available on all lxc hosts and can assist in recreating parts of the LXC system whenever its needed.
  • Inventory is generated by executing the playbooks/inventory/ script. This is configured in the playbooks/ansible.cfg file.
  • If you don't use the script you will want to ensure the permissions on /etc/openstack_deploy/user_secrets.yml are more secure. chmod 0600 /etc/openstack_deploy/user_secrets.yml
  • Finding slow Ansible tasks is easier with the profile_tasks callback plugin. Review the notes in playbooks/plugins/callbacks/ to enable it.

Bugs and Blueprints

Everything we do is in launchpad and gerrit. If you'd like to raise a bug, feature request, or are looking for ways to contribute please go to "".


To build the docs make sure that you have installed the python requirements as found within the dev-requirements.txt file and then run the following command from within the doc directory.

make html