README.md 1.39 KB
Newer Older
1 2 3 4 5 6 7
Ansible Roles
=============

These are my personal ansible roles. I share with joy, and comments are welcome,
but I don't intend to make them generic nor perfect for everybody use. They suit
my needs.

8 9
Oh, and they all are using Debian systems.

Jocelyn Delalande's avatar
Jocelyn Delalande committed
10 11 12
They are licensed under the [WTFPL](http://www.wtfpl.net/txt/copying/), except
when another is mentioned inside a role folder (these are external roles I
reuse).
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

Layout
------

The layout is quite standard, I do not provide defaults for everything but I try
to provide a README.md for each, it contains an example `site.yml` sample.


I use a single folder containing two git repos :

    ansible_
    ├── roles              (that git repo)
    └── site               (a private git repo)
        ├── ansible.cfg
        ├── hosts
        ├── site.yml
        └── vault.yml


 - a flat hosts file, containing just the hostnames
 - a single site.yml
 - my ansible.cfg :

    [defaults]
    roles_path = ../roles
    hostfile = hosts


External roles
--------------

I may use external 3rdparty roles, from [ansible galaxy](https://galaxy.ansible.com/), they are not versioned here, but rather listed in *galaxy-roles*. To download them, just run :

Jocelyn Delalande's avatar
typo  
Jocelyn Delalande committed
46
    ansible-galaxy install -p . -r galaxy-roles
47 48

You may need to remove the roles folder so that they upgrade if you already have them in an old version (weird behaviour from ansible-galaxy).