summaryrefslogtreecommitdiff
path: root/ansible/README.md
blob: 8bee0e8951ecd0e7f44fa7459e5465e74373016b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
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