ansible

Roles and playbooks for debian based hosts

I'm following the philosophy that each role should just work without changing any of the arguments and while it's great for playing around, you shouldn't run this role in production without checking out the <role>/defaults/main.yml and <role>/README.md as that's where I describe what can be customized and offer advice and sample playbooks.

How to use this

I usually have a top-level directory named ansible in which I initialise this repo as a submodule in a folder named common:

.
├── README.md
├── ansible/
│   ├── common/  # submodule
│   └── roles/   # project specific roles
├── ansible.cfg
└── src/

This way I can have roles that are common to all my projects - like docker or firewall + project specific roles and playbooks.

In this setup it's imperative to have the ansible.cfg file pointing to our common roles:

[defaults]
roles_path = ansible/common:ansible/roles

Useful commands

How to initialise Git submodule

On recent Git versions it's enough with:

$ git submodule add [email protected]:romantomjak/ansible-roles ansible/common

and when the upstream changes and you would like to pull the latest changes:

$ git submodule update --remote --merge

Syntax check

$ ansible-playbook --syntax-check helloworld.yml

Run against a single host

Play needs to have hosts: all, then run:

$ ansible-playbook -i "myhost.com," helloworld.yml

Note the comma (,) at the end; this signals that it's a list, not a file.

Notes

• Ansible Coding Conventions

License

MIT