# Ansible

Pour une documentation complète d'Ansible, visitez [[https://docs.ansible.com/]]

Pour une documentation rapide: https://gist.github.com/noushi/faa29c50dd10a5d77cc1ca4670c6ca0d

## Playbooks

Les playbooks servent à appliquer des rôles et/ou des tâches à des hôtes ou des groupes.

## Rôles

Un rôle est un ensemble de tâches à effectuer. Si on compare Ansible à un langage de programmation, les modules sont une librairie standard, tandis que les rôles sont des librairies créées par vous-mêmes ou par la communauté, qui sont ensuite utilisés dans les playbooks.

[[https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html#role-directory-structure|Structure d'un rôle]]

## Modules

### Templates

Si vous rencontrez un fichier .j2, cela implique probablement le module [[https://docs.ansible.com/ansible/latest/modules/template_module.html | template ]] 

## Informations utiles débuter

  * Test d'un playbook en local: `implicit localhost`
  * Visualisation des variables: module `debug`

## CheatSheet

Installation des rôles: ansible-galaxy install -r requirements.yml

### Vault

```
ansible-vault [encrypt¦decrypt¦create¦view¦edit] 
```

## Autres ressources

Design d'un rôle:
```
https://thoughts.t37.net/documenting-your-ansible-roles-interface-and-making-other-peoples-life-easier-604e5172837b
```