Prior to this change, all files at the root of the doc/source/ directory were implied to be developer documentation. This commit moves them into an explicit subdirectory, and re-words the section headings to be less repetitive. No changes to formatting or content were introduced. Change-Id: Id00116ad2146f11df52dd8a331834719e1b8bd03 Closes-Bug: #1486789
49 lines
1.2 KiB
ReStructuredText
49 lines
1.2 KiB
ReStructuredText
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 `os-ansible-deployment/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
|