Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:ansible [2017/10/13 11:49] – zatalyz
+++ fr:ansible [2021/12/03 19:19] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 5: / Ligne 5: @@
 C'est donc de la doc pour noob avec probablement des erreurs.
- --- //[[wiki:user:zatalyz|zatalyz]] 2017/10/13 11:26//
+ --- //[[user:zatalyz|zatalyz]] 2017/10/13 11:26//
 </WRAP>
-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((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)).
+Ansible s'installe sur sa machine à soi (pas sur un serveur), afin d'administrer ses serveurs en automatisant pleins de choses. C'est censé simplifier le boulot du sysadmin((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)).
 Donc, suivant votre système :
@@ Ligne 24: / Ligne 24: @@
 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'' <wrap help> probablement en renseignant la variable ''inventory      = /chemin/fichier''</wrap>, soit de lancer Ansible avec la variable ''-i'' en indiquant le chemin.
+Par défaut, Ansible les cherche 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'' <wrap help> probablement en renseignant la variable ''inventory      = /chemin/fichier''</wrap>, soit de lancer Ansible avec la variable ''-i'' en indiquant le chemin.
   ansible -i /chemin/fichier
@@ Ligne 33: / Ligne 33: @@
 ===== 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à :
+Il y a visiblement plusieurs syntaxes possibles (peut-être à 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à :
 <code ini>mail.example.com
@@ Ligne 47: / Ligne 47: @@
 </code>
-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.
+Ce qui est entre crochets est le nom donné à un groupe et ce nom est libre, mais il ne doit pas reprendre un nom des serveurs gérés dessous. Ici par exemple, il y a un groupe de serveurs qui concerne le web, un autre groupe avec les machines hébergeant les bases de données ; les noms ont été choisis pour être parlants.
 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 ip (par exemple 9.9.9.9)
   * d'après leur raccourci renseigné dans ''.ssh/config'' (le plus pratique car cela précise le port, l'utilisateur...)
-<WRAP center round help 90%>
+==== Agent ssh et test ====
-À ce stade ça semble assez inutile...
+<WRAP center round important 60%>
+Pensez à activer [[fr:ssh#se_connecter_sans_retaper_trop_souvent_son_mot_de_passe_methode_securiseel_agent_ssh|l'agent ssh]] qui va se souvenir de la passphrase 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 (à moins d'utiliser une paire de clefs sans passphrase, ce qui est déconseillé).
+  eval "$(ssh-agent -s)"
+  ssh-add ~/.ssh/id_rsa
+</WRAP>
+<WRAP center round info 90%>
+Pour tester votre configuration, vous pouvez faire un ping-pong avec vos serveurs !
 Exemple avec l'host suivant :
@@ Ligne 65: / Ligne 76: @@
 </code>
-  ansible -i ./khanat_host -m ping lirria
+  ansible -i ./khanat_host -m ping khanat
-me demande de rentrer le mot de passe de la clé ssh préalablement envoyé au serveur (jusque là tout va bien), puis répond ceci :
 <code>lirria | SUCCESS => {
+    "changed": false,
+    "failed": false,
+    "ping": "pong"
+}
+jukni | SUCCESS => {
     "changed": false,
     "failed": false,
@@ Ligne 75: / Ligne 90: @@
 </code>
-Mais si je teste la commande sur tout le groupe...
+</WRAP>
-  ansible -i ./khanat_host -m ping khanat
-Alors :
-  * le mot de passe de ma clé est demandé 2 fois à la suite
-  * rentré une première fois, il exécute l'appel au premier serveur
-  * il faut rentrer une seconde fois le mot de passe... mais cette fois en clair dans le terminal
-Quelle est l'utilité de demander le mot de passe à chaque fois, n'y-a-t-il pas moyen de l'enregistrer pour l'ensemble de la commande au moins ? Quid de la sécurité s'il est en clair ?
+===== 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 ; dit autrement, Ansible permet (entre autres) de faire des opérations sur plusieurs serveurs et ce en parallèle.
+Un exemple très bête : la mise à jour des dépôts, le téléchargement et déployement de nouveaux paquets. Le tout en gardant un œil quand même pour voir 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ée des "playbooks". Ce sont des fichiers écrits au format [[http://docs.ansible.com/ansible/latest/YAMLSyntax.html|YAML]]. À noter qu'Ansible a pour but de favoriser la lecture par des êtres humains : il y a donc beaucoup de façons 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...
+<WRAP center round important 60%>
+YAML est assez strict sur les indentations. Si vous avez des erreurs lors de vos premiers palybooks, c'est peut-être à cause d'une espace manquante...
 </WRAP>
+==== Écrire un playbook ====
+Pour la rédaction des playbooks, les possibilités sont nombreuses et il vaut mieux se référerer à la [[http://docs.ansible.com/ansible/latest/playbooks.html|documentation 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.
+Chaque tâche (task) démarre par un tiret ''-'' après lequel on peut spécifier un ensemble d'options. On peut renseigner une variable "name", qui nous indiquera, lors du lancement du playbook, à quel stade il en est. On peut faire appel au shell, ou même directement à un programme. On peut passer root via sudo, ou devenir un autre utilisateur (pour peu qu'on aie les droits), le temps d'une commande. On peut avoir des retours si un reboot est nécessaire, etc.
+<code>
+- name: Texte décrivant la tâche
+  module: option=value
+</code>
+Commençons en douceur... on reproduit notre "ping" via le playbook.
+<code yml khanatping.yml>
+# 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
+</code>
+Lors de l'exécution de ''ansible-playbook -i ./khanat_host ./ansible/playbooks/khanatping.yml'', la réponse est affichée différemment de la commande ''ansible -i ./khanat_host -m ping khanat'' mais le résultat est le même : ça marche.
+Allons un peu plus loin et créons un playbook pour mettre à jour un serveur Debian. La lecture des [[http://docs.ansible.com/ansible/latest/apt_module.html|possibilités offerte par les modules apt sous ansible]] est utile.
+Les mises à jour doivent se faire avec les droits root. Mais comme on respecte les règles de sécurité, on ne se connecte jamais directement en root mais via un utilisateur ayant le droit de devenir root via sudo. Et toujours pour des questions de sécurité, cet utilisateur doit taper son mot de passe pour devenir root. On ajoutera donc la commande ''--ask-become-pass'' en appelant le script. On va aussi ajouter dans le playbook de quoi passer en root quand nécessaire.
+<code yml maj_base.yml>
+# Nos hôtes concernés par le playbook
+- hosts: khanat
+# On prévient que sur cet host et pour ce playbook, on va utiliser sudo.
+  become: yes
+  become_method: sudo
+# On renseigne les tâches et on leur donne des descriptions
+  tasks:
+    - name: mise à jour des dépôts
+      apt: update_cache=yes
+    - name: Mettre à jour les paquets
+      apt: upgrade=yes
+    - name: Vérifie s'il faut rebooter
+      register: reboot
+      stat: path=/var/run/reboot-required get_md5=no
+</code>
+Puis lancer :
+  ansible-playbook -i ./khanat_host ./ansible/playbooks/maj_base.yml --ask-become-pass
+==== Insérer des playbooks dans des playbooks ====
+Imbriquer les playbooks peut être utile. Par exemple, vous avez un playbook bien fait pour les mises à jour, mais vous souhaitez le lancer parfois pour un groupe de serveur, parfois pour un autre((Typiquement chez nous, on met à jour les hyperviseurs, puis on fait des snapshots des VM, puis on passe aux MàJ des VM, donc des mises à jour en deux temps.)).
+Il y a plusieurs façon de réaliser des imbrications, définir des rôles, inclure des tâches... Cette dernière façon de faire est assez simple.
+Créez votre premier playbook contenant vos hosts, et appelez dedans un second playbook, qui contiendra la liste des tâches :
+<code yml khanat.yml>- hosts: khanat
+  tasks:
+  - import_tasks: includeping.yml</code>
+<code yml includeping.yml>
+  - action: ping
+</code>
 ===== Sources =====
   * [[https://memo-linux.com/ansible-mes-premiers-pas/|Ansible : mes premiers pas]] //(memo-linux.com)//
   * [[https://linuxfr.org/news/presentation-d-ansible-et-version-2-a-venir|Présentation d'Ansible et version 2 à venir]] //(Linuxfr.org)//
+  * https://www.abyssproject.net/2016/09/gerer-mises-a-jour-de-bsd-linux-windows-ansible/
+  * [[http://www.ageekslab.com/ansible/ansible3/|Utilisation avancée]] : piste pour utiliser des boucles, en français. Le détail dans [[http://docs.ansible.com/ansible/latest/playbooks_loops.html|la documentation officielle en anglais]]
+  * [[https://galaxy.ansible.com/|Galaxy : exemples de playbooks]]
-{{tag>Serveur Administration}}
+{{tag>Serveur Sysadmin}}