Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Architecture : l’assistant, Ansible et les services

Ce que vous allez comprendre

  • Expliquer ce que fait l’installeur lui-même et ce qu’il délègue à Ansible.
  • Distinguer les deux modes d’installation (paquets natifs, appliance Docker Compose) et les deux topologies (un serveur, plusieurs serveurs), et choisir celle qui convient.

Le problème concret

Installer un annuaire d’entreprise demande de configurer une dizaine de logiciels de façon cohérente : OpenLDAP et sa politique de mots de passe, trois outils web PHP derrière nginx, des certificats, un pare-feu, des sauvegardes et une supervision. Fait à la main, chaque serveur finit différent du précédent, et personne ne sait plus ce qui a été réglé où.

L’analogie

L’assistant est un bon de commande. Il pose les questions, refuse les réponses incohérentes et produit un document unique, la configuration. Ansible est l’équipe de pose. Elle lit le bon de commande et exécute toujours les mêmes gestes, dans le même ordre. L’installeur ne touche jamais lui-même aux services. Il ne fait que rédiger le bon de commande et surveiller l’équipe.

Le modèle

 navigateur ── sur le poste qui lance l'installeur (mode principal),
      │        ou par un tunnel SSH quand il tourne en root sur le serveur
      ▼
 open-iam-installer ─── 1. assistant : écrans, validation, brouillon
   (binaire unique)  ─── 2. configuration (openiam.yaml) + inventaire + secrets chiffrés
                     ─── 3. ansible-playbook, journal retransmis en direct
                     ─── (avant 3, si des serveurs sont à créer : tofu plan puis
                          tofu apply chez le fournisseur, XCP-ng par Xen Orchestra)
                              │
                              ▼
                     rôles Ansible idempotents
                     common · pki · hardening · openldap_ltb · backup
                     ltb_web · ltb_ssp · ltb_white_pages · ltb_service_desk · monitoring
                              │
            ┌─────────────────┼──────────────────┐
            ▼                 ▼                  ▼
      paquets natifs     appliance Compose    plusieurs serveurs
      (cette machine,    (conteneur Debian    (annuaire / outils /
       en root)           + systemd, mêmes     supervision, par SSH :
                          rôles)               le mode principal)

Un seul chemin de rendu. Les mêmes rôles Ansible produisent la configuration dans tous les cas. En mode Compose, l’installeur construit une appliance, c’est-à-dire un conteneur Debian 13 avec systemd et un serveur SSH interne non publié. Les rôles s’y exécutent exactement comme sur un serveur. Il n’y a ni image tierce à maintenir ni seconde version des configurations.

Idempotence. Rejouer l’installation sur un serveur déjà installé ne change rien, car chaque rôle compare l’état voulu et l’état présent. C’est ce qui permettra, plus tard, les mises à jour et les ajouts de composants depuis la console.

Secrets. Ansible Vault chiffre les mots de passe générés le temps de l’exécution, et le journal les masque. Ils n’apparaissent en clair que dans le fichier récapitulatif, réservé à root.

Deux moteurs, un rôle chacun. Quand l’installeur doit aussi créer les serveurs, OpenTofu ne s’occupe que de leur cycle de vie : plan, création, retrait. Ansible reste seul à configurer ce qui tourne dessus. L’installeur ne rédige pas de code OpenTofu. Il écrit seulement les données des machines (terraform.tfvars.json) pour un module par fournisseur, à l’interface commune.

L’installeur montre le plan calculé tel quel, puis l’applique tel quel. Un seul travail tourne à la fois, car OpenTofu et Ansible partagent le même verrou. Le code Rust garde ce qui demande un dialogue direct avec le fournisseur : connexion, catalogue en direct, disponibilité des machines et modèle durci.

Alternatives et compromis

Choix possiblePourquoi pas ici
Tout faire en Rust, sans AnsibleIl aurait fallu réécrire la gestion des paquets, des services et des fichiers de configuration. Ansible la fait déjà, de façon lisible et rejouable
Images Docker officielles des outils LTBElles n’existent pas pour toutes les briques et vieillissent à leur rythme. L’appliance réutilise les paquets et les rôles du mode natif
Un serveur par outil, systématiquementInutile pour une collectivité. Un seul serveur suffit, et le multi-hôtes reste possible quand le réseau ou la charge l’exigent
Créer les machines directement en Rust par l’API de Xen OrchestraGardé en repli. OpenTofu apporte un plan relu avant d’agir et un même contrat pour les fournisseurs à venir (Proxmox, clouds)
Installeur accessible sur le réseauSans certificat, il n’écoute que sur l’adresse locale. Seul le navigateur du poste qui le lance l’atteint, ou, quand il tourne sur le serveur, un tunnel SSH protégé par votre clé

Vérifier votre compréhension

  1. Pourquoi une modification faite à la main dans /etc/nginx/sites-available/open-iam-ssp sera-t-elle écrasée à la prochaine exécution, et où faudrait-il la faire ?
  2. Votre organisation a deux sites distants. Quelle topologie proposeriez-vous, et qu’est-ce qui doit circuler entre les serveurs ?

Pour aller plus loin