Ansible: playbook en mode avancé

Après avoir vu la mise en route et les bases de ansible nous survolerons les possibiités plus avancés avec les playbooks et leur optimisation avec les variables, les fichiers jinja2, les headers et les roles… sans rentrer dans les détails d'expert!

L'idempotence des modules.

On a vu que l'idempotence est le fait que une fois l'état final atteint, quelque soit le nombre de fois qu'on répète une tache les actions de cette tache ne seront pas rejouées sauf pour remettre l'état final attendu si celui-ci a été modifié entre temps.

C'est grace à cette capacité qu'il n'y a pas de risque de relancer x fois un playbook. Au contraire cela permet de recorriger l'état si une modification a été faite et qu'elle l'a modifie !

Les paramètres ansible dans un playbook.

Ansible a beaucoup de paramètres/variables qui peuvent etre modifiés/surchagés comme les paramètres/variables des modules (que nous verrons plus tard). Les paramètres de ansible peuvent etre fixés à plusieurs endroits et selon où ils sont définis leur portée varie.

https://docs.ansible.com/projects/ansible/latest/reference_appendices/config.html

https://blog.stephane-robert.info/docs/infra-as-code/gestion-de-configuration/ansible/decouvrir/ansible-config-fichier/

https://docs.ansible.com/projects/ansible/latest/playbook_guide/playbooks_variables.html#variable-precedence-where-should-i-put-a-variable

https://www.stephane-robert.info/docs/infra-as-code/gestion-de-configuration/ansible/ecrire-code/variables-facts/precedence-variables/

Pour résumé, on va retenir le plus utilisé en automatisation pour débuter, par ordre de priorité de prise en compte, ici exemple du paramètre “remote_user”:

1 - dans une action d'une tache dans le playbook

tasks:
- name: Installation de python
  ansible.builtin.raw: apt install python3
  remote_user: user_lab
  vars:
    ansible_user: user_lab

2 - en entete du playbook

- name: Nouveau Serveur
  hosts: my_host_1
  gather_facts: false
  remote_user: user_lab
  vars:
   ansible_user: user_lab
  become: true

3 - ansible.cfg dans le répertoire courant du projet

[defaults]
# Utilisateur distant par défaut pour la connexion SSH
remote_user = user_lab
Ici remote_user est un mot clé . Mais il existe une variable qui a la même fonction c'est “ansible_user”. Une variable est supérieure à un mot clé et est donc prioritaire. Si une variable a la meme fonction qu'un mot clé alors elle est prioritaire où qu'elle soit.

Dans la déclaration/liste des cibles (inventory), on ne peut pas mettre de mot clé mais uniquemnt des variables. De ce fait l'inventory est toujours prioritaire s'il n'y a pas la meme variable de déclaré dans un playbook pour la surcharger.

...
my_host_1 ansible_user=user_lab

[all:vars]
ansible_user=user_lab

Une valeur d'un mot clé passée par la ligne de commande CLI (remote_user passé par -u) sera toujours la derniere prise en compte.

La valeur d'un mot clé ou d'une variable peut etre fixée avec la valeur d'une autre variable. On peut donc récupérer n'importe quel valeur d'une variable. Pour récupérer cette valeur on utilise

{{ nom_de_la_variable }}

La variable peut être déclarée:

  • soit dans une section du playbook
  • soit par l'option -e (une extra variable) depuis une commande CLI sous forme de
-e "maVariable1=valeur1" -e "maVariable2=valeur2"

Si par exemple on veut que par défaut remote_user=user_lab mais qu'on puisse le surcharger manuellement

- name: Nouveau Serveur
  hosts: my_host_1
  gather_facts: false
  remote_user: "{{ sshUser|default('user_lab') }}"

On lancera le playbook avec

ansible-playbook monplaybook.yml -e "sshUser=toto"

On pourrait faire la meme chose avec “hosts”

Remarque: une variable ou extra variable ne doit pas s'appeler comme un mot/nom réservé.

Les comptes utilisateurs dans Ansible.

Il est important de comprendre avec quel compte ansible exécute les actions d'une tache sur les cibles. Il existe 4 types de comptes utilisable par ansible pour automatiser les taches:

  • votre compte
  • un compte quelconque
  • un sudo
  • root

Les taches sont exécutées sur la cible. Donc ces comptes doivent exister sur la cible ! Quel compte est utilisé? et à quel moment ?

machine pilote ------- SSH---------> cible -------sudo / root----> exécution de la tache

Pour la connexion SSH, ansible utilise par défaut votre compte avec lequel vous êtes connecté sur la machine pilote mais vous pouvez utiliser un autre compte qui n'existe pas sur votre machine pilote. Que ce soit votre compte ou un autre compte, il doit exister sur la cible. Une fois connecté sur la cible en SSH, l'éxécution des actions de la tache se fera par élévation de droit du compte connecté en SSH soit via sudo soit directement avec le compte root de la cible.

Pour pouvoir utiliser ces comptes il faut le mot de passe associé ! On a une clé SSH lors de la mise en place de ansible. Par défaut cette clé est associée à votre compte. Si votre compte existe sur les cibles et que la clé publique y est présente alors la connexion SSH se fera sans probleme avec cette clé. Ce qui est peu probable ! A mois que vous ayez poussé la clé sur chaque serveur indivudellement par:

ssh-copy-id -i sshkeys/ansible.pub votre_compte@une_cible

Il est fort possible que votre compte ne soit pas présent sur toutes les cibles et que le compte root ne soit pas autorisé en ssh. Il faudra donc créer votre compte sur toutes les cibles. Un peu fastidieux…

En général lors de l'installation d'un serveur on doit créer un premier compte (ici user_lab) en plus de root et généralement sudo n'est pas installé. Du coup ce compte n'est pas sudoer, ce qui nous amène au probleme pour éxécuter une action nécessitant une élévation de droit.

Pour résoudre le problème: mon compte n'existe pas sur les cibles, j'ai un compte sur les cibles mais il n'est pas sudoer, donc je ne peut rien faire.

Solutions:

  • je crée mon compte et le rends sudoer sur les cibles : oui mais je ne suis pas tout seul dans l'équipe
  • j'utilise le compte root : possible mais pô bien !
  • je rends le compte existant sudoer : une solution. Mais bof…
  • je crée un compte dédié pour ansible SANS mot de passe: je préfère. Je ne mélange pas le role des comptes. Pas de mot de passe pas de login possible. Donc obligation d'une clé et donc connexion que en SSH à partir d'une machine avec la clé privée, la machine pilote, que je peux plus facilement surveiller et gérer la sécurité. Mais je ne vais pas passer sur chaque cible pour le faire manuellement!? Ben non j'ai ansible pour automatiser!

Ansible dispose de plusieurs paramètres pour déclarer quel compte utiliser et quand sur les cibles. Si dans tout notre inventaire de machine, une n'a pas un compte identique aux autres pour se connecter dessus en SSH, il peut etre utile d'avoir un playbook avec un compte particulier pour la connexion SSH et pour les autres un compte commun déclaré dans l'inventory ou ansible.cfg.

Plus haut on a vu

  • 1 mot clé: remote_user
  • 1 variable: ansible_user

Ils servent à fixer un compte à utliser pour se connecter en SSH !

Pour l'élévation de droit, une fois que la connexion SSH est faite, on utlise le mot clé:

become: true

Pour indiquer la méthode d'élévation on utilise le mot clé:

become_method: xxx

par défaut la méthode est un sudo du compe SSH, ce qui impose que ce compte soit sudoers, mais on peut utiliser directement le compte root avec la méthode su:

become_method: su

Dans l'entete du playbook pour se connecter en SSH avec “user_lab” et utliser le compte root pour exécuter les taches:

remote_user: user_lab
become: true
become_method: su

Playbook (nouveauServeur.yml) pour créer un utilisateur dédié ansible

---
- name: Nouveau Serveur
  hosts: test
  gather_facts: false
  remote_user: user_lab
  become: true
  become_method: su

  tasks:
  ⦙ - name: Installation de python
  ⦙ ⦙ ansible.builtin.raw: apt install python3

  ⦙ - name: Installation de sudo
  ⦙ ⦙ ansible.builtin.raw: apt install sudo

  ⦙ - name: Ajout d'un utilisateur ansible
  ⦙ ⦙ ansible.builtin.user:
  ⦙ ⦙ ⦙ name: ansible
  ⦙ ⦙ ⦙ shell: /bin/bash
  ⦙ ⦙ ⦙ groups: sudo
  ⦙
  ⦙ - name: Ajout au groupe comme sudoer
  ⦙ ⦙ community.general.sudoers:
  ⦙ ⦙ ⦙ name: ansible
  ⦙ ⦙ ⦙ user: ansible
  ⦙ ⦙ ⦙ commands: ALL
  ⦙ ⦙ ⦙ nopassword: true   # Defaut: true depuis community.general 11+
  ⦙ ⦙ ⦙ state: present

  ⦙ - name: Ajouter la clé SSH publique
  ⦙ ⦙ ansible.builtin.authorized_key:
  ⦙ ⦙ ⦙ user: ansible
  ⦙ ⦙ ⦙ state: present
  ⦙ ⦙ ⦙ key: "{{ lookup('ansible.builtin.file', 'sshkeys/ansible.pub') }}"

A aucun moment nous avons fixer un mot de passe ni pour le compte SSH user_lab ni pour le compte root avec la méthode su. Et il ne le faut pas… du moins pas en claire et pour l'instant on ne sait pas comment le faire. Donc on va lancer ce playbook avec 2 paramètres qui vont nous demander ces mots de passe.

ansible-playbook nouveauServeur.yml --ask-pass --ask-become-pass
SSH password:
BECOME password[defaults to SSH password]:

Si le remote_user n'a que une clé et pas de mot de passe on peut fournir le fichier de clé par CLI avec l'option -ssh-key

Voilà avec ce playbook

  • on utilise un compte existant sur la cible pour la connexion SSH
  • on passe en root pour créer un compte dedié sans mot de passe, le mettre comme sudoer et lui pousser notre clé
  • on s'assure que python est installé pour que les modules ansible fonctionnent
  • et sans fournir de mot de passe en claire dans les fichiers ni pour SSH ni pour su

Gestion des erreurs

Dernière modification : le 2026/11/06