This commit gets the doc directory and Sphinx configuration started. Further documentation will depend on the Sphinx files and the index.rst file at the very least. The dev-requirements were updated to install Sphinx, and a gating script was added to do the building for when we move to actually do gating on the docs. The docs gate script is currently set to treat warning as errors. Change-Id: I977a2e53f1b0981cbc702ac53f2198d9f6a9da9d Implements: blueprint developer-docs
1.3 KiB
os-ansible-deployment 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