Daniel Allaire
4a1d0836d0
Solde la dette documentaire repérée à l'audit du 2026-07-03. Tous les rôles ont désormais un README, au format maison (intention → rôle → variables → notes/limites → prérequis). Ils documentent ce qui ne se lit PAS dans les tâches : - serveur_debian : rôle-catégorie sans tâches — il ne porte que le flux SSH du plan de gestion, sans quoi les nftables générés couperaient l'accès Ansible à toute la flotte ; le vrai travail est dans le playbook de groupe. - hosts_statiques : le plancher /etc/hosts comme CONDITION de l'ordre de reconstruction (résolution par nom avant que PowerDNS existe) ; fichier entièrement géré, alias d'exposition best-effort. - resoudre_base / resoudre_annuaire : entrées, sorties (facts), et pourquoi le FQDN plutôt que le nom court (fédération + nom canonique pour verify-full). - serveur_dovecot : les 3 réglages Dovecot 2.4 qui conditionnent la remise (static_allow_all_users, mail_inbox_path vide, mail_path par utilisateur) et le local-part seul comme chemin commun LMTP/IMAP ; limite mono-domaine. - serveur_postfix : liens mailstore/milter, recopie de /etc/hosts dans le chroot. - serveur_rspamd : clé DKIM idempotente ; le domaine signé doit être PUBLIC en prod, sinon la signature ne vaut rien pour les MX distants. - client_backup / serveur_backup : jobs déclaratifs, chiffrement côté client, deux pièges (jobs vides = silencieux ; dépôt neuf vide après un from-zero) ; hors-nœud n'est pas hors-site. - serveur_oauth2_proxy : le patron réutilisable Keycloak-devant-n'importe-quoi, et pourquoi allow_unverified_email est nécessaire avec un annuaire LDAP. - serveur_icingaweb2 : modes ldap vs external, écoute à restreindre en SSO. - client_unbound : le garde-fou de bascule (apply ET confirm, validation réelle avant de toucher /etc/resolv.conf). docs/carte-set-ops.md ne décrivait plus l'état du code : - expose EST consommé au déploiement (annoncé comme « Phase 3 à venir ») : expositions_des_applications + expositions.conf.j2, alias /etc/hosts, SANs d'edge dérivés par instancier.py ; - 3 mécanismes transverses ajoutés (résolution d'annuaire, plancher de résolution, resoudre_base nommé dans les bindings app→base) ; - 5 entrées d'index ajoutées : réseau/pare-feu, ordre de déploiement, preuve/recette, exploitation courante, wiki — pans du corpus non indexés ; - ce qui reste ouvert est marqué : meta/liens.yml sur le seul serveur_postfix, requiert non consommé au déploiement (l'ordre vient des couches + du graphe). make verifier vert : ansible-lint 514 fichiers, tests, syntax-check, 23 preuves CONFORME / 0 échec / 0 sauté. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
# serveur_debian
|
|
|
|
**Rôle-catégorie** du socle : il ne porte **aucune tâche**. Son unique contenu est
|
|
`meta/flux.yml` — la déclaration du **plan de gestion** (SSH) de tout nœud de la flotte.
|
|
|
|
## Pourquoi un rôle sans tâches
|
|
Le résolveur de flux (`scripts/resoudre_flux.py`, `make flux`) agrège les
|
|
`roles/<rôle>/meta/flux.yml` **par nom de groupe**. Le groupe `serveur_debian` est le socle
|
|
appliqué à tous les hôtes ; c'est donc ici que se déclare le flux SSH d'administration.
|
|
|
|
> ⚠️ **Critique** : sans cette déclaration, les rulesets nftables générés
|
|
> (`nftables_baseline`, `policy drop`) couperaient l'accès Ansible/SSH à toute la flotte.
|
|
|
|
## Le travail réel
|
|
Il est fait par le playbook du groupe, `playbooks/groupes/serveur_debian.yml`, qui applique
|
|
dans l'ordre :
|
|
|
|
| Rôle | Apport |
|
|
| --- | --- |
|
|
| `common_packages` | Paquets de base |
|
|
| `hosts_statiques` | Plancher de résolution `/etc/hosts` (indépendant du DNS) |
|
|
| `qemu_guest_agent` | Agent invité Proxmox |
|
|
| `cloud_init` | Cohérence du premier démarrage |
|
|
| `sudo_ansible` | Compte de déploiement |
|
|
| `chrony` | Horloge (`fuseau_horaire`) |
|
|
| `ssh_baseline` | Base SSH |
|
|
| `systemd_ssh_auto` | Démarrage SSH fiable |
|
|
| `motd` | Bannière |
|
|
|
|
Le playbook refuse toute cible non-Debian (assertion `ansible_facts.distribution`).
|
|
|
|
## Place dans l'ordre
|
|
Couche **socle** (`docs/couches-deploiement.yml`) — la première. Le durcissement
|
|
(`serveur_durci`) vient juste après, tout le reste ensuite.
|
|
|
|
## Notes
|
|
- Ajouter un flux réseau **du socle** (pas d'un service) se fait ici, pas ailleurs.
|
|
- `hosts_statiques` étant appliqué ici, la résolution par nom fonctionne dès le socle,
|
|
avant que PowerDNS existe — c'est ce qui permet l'ordre de reconstruction from-zero.
|