Ceci est une ancienne révision du document !

Ansible

Cet article est un gros brouillon de fatras. Ansible est utilisé par certains ici, mais moi, j'y connais rien, et je m'y lance dans l'optique de répliquer certaines manip, entre autre avec BURPS.

C'est donc de la doc pour noob avec probablement des erreurs.

— zatalyz 2017/10/13 11:26

Ansible s'installe sur sa machine à soi (pas sur un serveur), afin d'administrer ses serveurs en automatisant pleins de choses. C'est sensé simplifier le boulot du sysadmin¹⁾.

Donc, suivant votre système :

sudo apt-get install ansible
yaourt -S ansible
dnf install ansible
...

Le fichier de configuration se trouve dans /etc/ansible/ansible.cfg ; il est en principe fonctionnel tel quel.

Sur Archlinux, il est surtout plein de lignes commentées, de base. Considérez-le comme le fichier expliquant les possibilités d'Ansible.

Ensuite on va renseigner ses serveurs.

Par défaut, Ansible les cherchent dans /etc/ansible/hosts (à créer et paramétrer). Mais on peut créer le fichier du nom qu'on veut à l'emplacement qu'on veut ; il suffira soit de le renseigner dans /etc/ansible/ansible.cfg probablement en renseignant la variable inventory = /chemin/fichier, soit de lancer Ansible avec la variable -i en indiquant le chemin.

ansible -i /chemin/fichier

Créer un ou des fichiers ailleurs a deux avantages :

cela permet de séparer suivant les infrastructures, par exemple un fichier pour les serveurs en production, un autre pour les serveurs en pré-production ;
cela permet de renseigner son fichier hosts sans avoir besoin des droits root, par exemple en le mettant dans /home/ansible/khanat_hosts.

Renseigner le fichier ansible/hosts

Il y a visiblement plusieurs syntaxes possibles (peut-etre à paramétrer dans /etc/ansible/ansible.cfg ?), on va rester au truc par défaut qui est la syntaxe de type INI, c'est à dire avec des crochets pour les sections, dans ce genre-là :

mail.example.com
 
[webservers]
foo.example.com
bar.example.com
 
[dbservers]
one.example.com
two.example.com
three.example.com

Ce qui est entre crochet est le nom donné à un groupe et ce nom est libre, mais il ne doit pas reprendre un de noms des serveurs géré dessous. Ici par exemple, il y a un groupe de serveur qui concerne le web, un autre groupe avec les machines hébergeant les databases ; les noms ont été choisis pour être parlant.

Les serveurs renseignés dessous peuvent l'être suivant diverses syntaxes :

d'après le nom de domaine qui leur est lié (par exemple foo.example.com)
d'après leur ip (par exemple 8.8.8.8)
d'après leur raccourci renseigné dans .ssh/config (le plus pratique car cela précise le port, l'utilisateur…)

Agent ssh et test

Pensez à activer l'agent ssh qui va se souvenir du mot de passe de votre clé ssh le temps de la session, sinon vous aurez du mal à vous connecter aux serveurs.

L'agent ssh est un passage obligé avec ansible.

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa

Pour tester votre configuration, vous pouvez faire un ping-pong avec vos serveurs !

Exemple avec l'host suivant :

[khanat]
lirria
jukni

ansible -i ./khanat_host -m ping khanat

lirria | SUCCESS => {
    "changed": false, 
    "failed": false, 
    "ping": "pong"
}
jukni | SUCCESS => {
    "changed": false, 
    "failed": false, 
    "ping": "pong"
}

Suite de commandes : playbooks

L'une des grandes forces d'Ansible va être d'automatiser des opérations qu'on répète sur plusieurs serveurs.

Un exemple très bête : la mise à jour des dépôts, le téléchargement et déployement des nouveaux paquets. Le tout en gardant un oeil quand même si tout se passe bien… Cette action est à faire régulièrement sur les serveurs : elle peut se scripter via ansible.

La première manipulation de cet article permet d'envoyer une commande sur plusieurs serveurs (un ping dans l'exemple). Pour passer plusieurs commandes, on créé des “playbooks”. Ce sont des fichiers écrits au format YAML. À noter qu'Ansible a pour but de favoriser la lecture par des êtres humains : il y a donc beaucoup de façon d'écrire ces playbooks…

Créez un répertoire dans lequel seront stockés vos playbooks, puis un playbook :

mkdir ./ansible/playbooks
nano  ./ansible/playbooks/maj_base.yml

Pour exécuter le playbook :

ansible-playbook -i ./khanat_host ./ansible/playbooks/maj_base.yml

Mais avant de l'exécuter, il faut l'écrire…

Écrire un playbook

Pour la rédaction des playbook, les possibilités sont nombreuses et il vaut mieux se référerer à la doc officielle. Pour les options de base :

Nous renseignons les hosts où le playbook sera lancé
Nous listons les tâches qui seront exécutées dessus

Il est possible de renseigner des variables et diverses options.

Commençons en douceur… on reproduit notre “ping” via le playbook.

# Indiquer sur quels serveurs ce playbook va marcher, ici ceux du groupe "khanat"
- hosts: khanat
#  Nous indiquons les tâches qui vont s'exécuter
  tasks:
    - action: ping

Lors de l'exécution de ansible-playbook -i ./khanat_host ./ansible/playbooks/maj_base.yml, la réponse est affiché différement de la commande ansible -i ./khanat_host -m ping khanat mais le résultat est le même : ça marche.

Sources

Ansible : mes premiers pas (memo-linux.com)
Présentation d'Ansible et version 2 à venir (Linuxfr.org)

Serveur, Administration

¹⁾

En attendant ça fait un truc de plus à apprendre. En même temps si l'outil permet vraiment de faire gagner du temps ensuite, ça vaut le coup