# Verdnatura Ansible playbooks

Collection of Ansible playbooks used in the Verdnatura server farm.

## Install Ansible

Instal Ansible on Debian.
```
apt install ansible
```

## Run playbook

Before merging changes into protected branches, playbooks should be tested 
locally to ensure they work properly.

Launch playbook on the fly on a host not declared in the inventory.
```
ansible-playbook -u root -i <ip_or_hostname>, [--tags tag1,tag2] playbooks/test.yml
```

*Note the comma at the end of the hostname or IP.*

## Common playbooks

* **facts.yml**: Collect and display facts from a host
* **ping.yml**: Check that a host is alive and reachable
* **awx.yml**: Create and configure AWX user
* **test.yml**: Test an specific role. Don't forget to undo changes before pushing!
* **debian.yml**: Setup base Debian server

## Documentation

* https://docs.ansible.com/ansible/latest/reference_appendices/config.html
* https://docs.ansible.com/ansible/latest/collections/ansible/builtin/gather_facts_module.html
* https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_vars_facts.html