kolla-ansible/ansible/README.md
Sam Yaple 9a81566d05 Allow the Kolla directory to be configurable
Implements the initial structure for variable substitution in ansible.

Change-Id: I26d82189273be6ebf941b0ab82efc6bf1eebc53d
2015-04-03 09:28:59 -05:00

51 lines
1.6 KiB
Markdown

Koalla - Kolla with ansible!
============================
Koalla extends the Kolla project past [TripleO][] into its own bonified
deployment system using [Ansible][] and [docker-compose][].
[TripleO]: https://wiki.openstack.org/wiki/TripleO
[Ansible]: https://docs.ansible.com
[docker-compose]: http://docs.docker.com/compose
Getting Started
---------------
To run the ansible playbooks, you must specify an inventory file which tracks
all of the available nodes in your environment. With this inventory file
ansible will log into each node via ssh (configurable) and run tasks. Ansible
does not require password less logins via ssh, however it is highly recommended
to setup ssh-keys. More information on the ansible inventory file can be found
[here][].
[here]: https://docs.ansible.com/intro_inventory.html
Deploying
---------
You can adjust variables for your environment in the file:
"./kolla/ansible/group_vars/all.yml"
For All-In-One deploys, you can run the following commands. These will setup all
of the containers on your localhost.
cd ./kolla/ansible
ansible-playbook -i inventory/all-in-one site.yml
To run the playbooks for only a particular service, you can us ansible tags.
Multiple tags may be specified, and order is still determined by the playbooks.
cd ./kolla/ansible
ansible-playbook -i inventory/all-in-one site.yml --tags message-broker
ansible-playbook -i inventory/all-in-one site.yml --tags message-broker,database
Further Reading
---------------
Ansible playbook documentation can be found [here][].
[here]: http://docs.ansible.com/playbooks.html