Jesse Pretorius 7a12374003 Various Documentation Updates
This patch does the following:

- Move the CONTRIBUTING doc content into the developer documentation
- Move the development-stack doc content into the developer documentation
- Rename all instances of 'OpenStack Ansible' to 'OpenStack-Ansible'
- Implements a simpler navigation index for the bottom of the page
- Implements a navigation index at the bottom of all developer docs
- Updates the README to reflect where to get documentation and further
  information
- Adds more information into the 'scripts' developer doc
- Updates the 'Additional Resources' Appendix with Ansible information

Change-Id: Ic08ba072f3b3d1e4e446d1e81c20c0cdf01833de
2015-10-05 18:16:01 +01:00

55 lines
1.3 KiB
ReStructuredText

`Home <index.html>`_ OpenStack-Ansible Developer Documentation
Playbooks
=========
The OpenStack-Ansible playbooks are stored in the playbooks directory.
There are several top-level playbooks that are run to prepare the host machines
before actually deploying OpenStack and associated containers.
Running Playbooks
-----------------
There is an `openstack-ansible` command installed by the
`scripts/bootstrap-ansible.sh` script. This wraps the `ansible-playbook`
command and provides the `/etc/openstack_deploy/user_*.yml` variable files
to the playbooks.
All of the playbooks should be run within the `openstack-ansible/playbooks`
directory
Setting up the Hosts
--------------------
Run `openstack-ansible setup-hosts.yml` to set up the physical hosts for
containers.
Setting up Infrastructure
-------------------------
Infrastructure pertains to utility services such as RabbitMQ, memcached,
galera, and logging which are not actually OpenStack services, but that
OpenStack relies on.
Run `openstack-ansible setup-infrastructure.yml` to install these containers.
Setting up OpenStack
--------------------
Running `openstack-ansible setup-openstack.yml` will install the following
OpenStack services:
* Keystone
* Swift
* Glance
* Cinder
* Nova
* Neutron
* Heat
* Horizon
--------------
.. include:: navigation.txt