Outils pour utilisateurs

Outils du site


ansible

Ansible

Préambule

Ansible est un outil permettant d'installer et de configurer des ordinateurs automatiquement. Pour cela, il faut :

  • une machine de contrôle (ex: laptop)
  • une machine à configurer (ex: serveur)

Remarque : la machine de contrôle peut être la machine à configurer

Installation d'Ansible (sur la machine de contrôle)

  • Installation de virtualenv
    sudo apt-get install virtualenvwrapper 
  • On doit relancer l'émulateur de terminal ensuite.
  • Création du virtualenv ansible
    mkvirtualenv ansible
  • Démarrer le virtualenv (Il faut être « dans » le virtualenv pour travailler avec ansible)
    workon ansible
  • Installer ansible dans le virtualnv (pour avoir la v2 et ça tombe bien c'est le but du jeu)
    pip install ansible
  • Si pip install couine il faut vérifier si les paquets suivant sont installés
    • build-essential
    • python-dev
    • libffi-dev
    • libssl-dev
    • ou tout autre paquet manquant mentionné par pip durant l'installation

Installation des dépendances (sur la machine à contrôler)

  • Sur la machine distante, il y a quelques dépendances à installer, mais pas Ansible:
    • python-apt python-yaml
  • On choisit une machine distante (ou locale), accessible en SSH, ici ça sera localhost
  • On teste que Ansible sait se connecter à la machine distante : (l'option -m permet de lancer un module)
    ansible localhost -m ping

Création d'un fichier hosts

http://docs.ansible.com/ansible/intro_inventory.html#hosts-and-groups

On va déclarer dans le fichier Host les machines que l'on va configurer avec Ansible et des paramètres. On peut le nommer “ansible_hosts”, on le met où l'on veut.

un fichier hosts simple :

mamachine.example.com

Un fichier plus complexe :

mamachine.example.com ansible_port=1234 ansible_user=johnrambo

Le fichier hosts situé dans le dossier /etc n'est pas à utiliser pour répertorier les machines. Il est préférable de créer ses propres fichiers de configuration. Par exemple, pour distinguer un fichier host avec les machines de test, et un fichier host avec les machines de prod.

Utilisation de la commande ansible (commandes ad-hoc)

On peut ensuite demander à ansible d'utiliser le fichier hosts que l'on vient de créer.

ansible -i ./ansible_hosts mamachine.example.com -m ping 

ansible […] -m apt -a "name=cowsay state=present"

Si on veut voir tous les arguments possibles, on lit LA DOC http://docs.ansible.com/apt_module.html ou via la commande :

ansible-doc apt

Si on ne se connecte pas en root,

  • si on utilise su, on ajoute
     --become --become-method=su --ask-become-pass 
  • si on utilise sudo, on ajoute
     --become --become-method=sudo --ask-become-pass 

Si l'on souhaite que ansible demande le mot de passe ssh (dans le cas ou la clé publique n'est pas présent sur le serveur distant), on peut ajouter l'option « -k »

Super astuce, pour mettre à jour un paquet sur plein de machines (ex: erreur de sécu sur apache) :

 -m apt -a "name=apache2 state=latest update_cache=yes" 

qui fait un apt update suivit d'un apt install.

Les playbooks

Documentation officielle : https://docs.ansible.com/ansible/2.8/modules/modules_by_category.html

Le playbook permet de réunir les tâches de configuration au sein d'un fichier.

Exemple simple (fichier nommé playbook-test.yml).

- hosts: mamachine.example.com
  tasks:
    - ping:

Pour l'exécuter :

 ansible-playbook -i <chemin de l'inventaire> playbook-test.yml) 

En pratique, on définit une liste de tasks :

- hosts: mamachine.example.com
  tasks:
    - <nom module>: arg1=val1 arg2=val2
    - <nom module>: arg=val

Et mieux : on ajoute un commentaire à chaque task (via la ligne name) :

- hosts: mamachine.example.com
  tasks:
    - name: Réalise un arc-en-ciel magique
      rainbow: color=purple duration=42
    - name: Vérifie que le magicien est réveillé
      wizard: state=up name=merlin

Problème : pour créer des arc-en ciels magique, il faut avoir les droits root, on modifie donc :

- hosts: mamachine.example.com
  tasks:
    - name: Réalise un arc-en-ciel magique
      become: yes
      rainbow: color=purple duration=42
    - name: Vérifie que le magicien est réveillé
      wizard: state=up name=merlin

et dans la ligne de commande ansible-playbook, on ajoute l'option

 --ask-become-pass 

Exercice 1 :

Faire un playbook pour la machine de test qui fait :

  • vérifier que cowsay est désinstallé (module apt)
  • créer un utilisateur unix nommé “magicsystem” (module user)

Documentation : http://docs.ansible.com/ansible/list_of_all_modules.html

Exercice 2 :

Le fichier motd contient le message de bienvenue pour un utilisateur qui se connecte sur la machine.

  • Ajouter une task qui renseigne /etc/motd avec le contenu suivant : Bienvenue sur cette machine cher humain.
    • Indice : la démarche est de demander à Ansible de copier un fichier local vers la machine à configurer
    • Indice : débrouillez-vous pour trouver quel module utiliser <3 (vérifier en se connectant en SSH)

Les variables

On veut désormais afficher un nom dans le message d'accueil, et que ce nom soit configurable au niveau d'Ansible. On va utiliser les variables.

On avait une section tasks, on va ajouter une sections vars, et on va appeller la variable grace à la syntaxe “moustache”.

- hosts: mamachine.example.com
  vars:
    - wizard_name: "Merlin"
    - rainbow_duration:  42
  tasks:
    - name: Réalise un arc-en-ciel magique
      rainbow: color=purple duration="{{ rainbow_duration }}"
    - name: Vérifie que le magicien est réveillé
      wizard: state=up name="{{ wizard_name }}"

Note : les moustaches correspondent à la syntaxe de jinja2, cf http://docs.ansible.com/ansible/playbooks_variables.html#using-variables-about-jinja2

Exercice : En reprenant l'exercice précédent : définir le nom de l'utilisateur (magicsystem) dans une variable plutôt qu'en dur dans la tâche.

Les templates

On peut aussi utiliser des variables dans les fichiers qu'on copie (module copy de l'exercice concerné). Cela s'appelle des templates, module template.

Documentation : http://docs.ansible.com/template_module.html

Exercice : Reprendre l'exercice du motd pour personaliser “Bonjour humain” en utilisant le contenu d'une variable.

Les "facts"

Une partie des variables sont pré-définies par ansible, elle s'appellent des “facts”. Elles commencent par “ansible_”.

La liste est ici : http://docs.ansible.com/ansible/playbooks_variables.html#information-discovered-from-systems-facts

Exercice: indiquer l'IPv4 de la machine dans le message de bienvenue MOTD.

Commandes utiles

ansible-playbook --ask-become-pass --check --diff -l slash.faimaison.net -t celutz,nginx playbook-fma.yml -vvv
  • Demande le mot de passe du host :
    --ask-become-pass
  • Limite le déploiement au host renseigné :
    -l <host>
  • Concerne les tags renseignés :
    -t <tags>

Options utiles

  • Tester le playbook :
    --check --diff
  • Lancer étape par étape de manière à choisir d'exécuter une tâche précise ou non :
    --step
  • Démarrer sur une tâche précise :
    --start-at-task="install packages"

Voici un autre exemple pour commencer: ansible:pourcommencer

example utile

l'option -u permet de préciser un utilisateur si ce n'est pas le même que vous utilisez sur votre poste. –limit pour préciser un serveur spécifique (-l est la forme diminué).

 ansible-playbook -K -i ./ansible_hosts --limit <nom du host> [-u <nom_user>]
ansible.txt · Dernière modification : 2024/06/13 18:54 de gde