vn-ansible/README.md

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.

To run an Ansible playbook locally on a temporary host without registering it in the inventory (on the fly) run the following command.

ansible-playbook playbooks/test.yml -u root -i <ip_or_hostname>,

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

Common playbooks

• facts.yml: Collect and display facts from a host.
• ping.yml: Checking that a host is alive and reachable by Ansible.
• 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