Set-OPS-Public/roles/client_unbound
Daniel Allaire e276e76f32 dns : client_unbound universel, et un resolveur d'amorcage
Une VM ne peut pas s'installer sans resoudre des noms. PowerDNS repond
UNIQUEMENT pour la zone souveraine et ne recurse pour personne : il manquait un
resolveur recursif. `client_unbound` est l'outil ecrit pour ca — il rejoint
`client_journal` et `client_metrique` parmi les integrations universelles.

`infra-dns-01` est exempte (PowerDNS occupe son port 53), et
`serveur_powerdns_listen_addresses` passe de 0.0.0.0 a l'adresse de l'hote pour
laisser 127.0.0.1:53 libre. Mais l'appartenance au groupe est AUSSI ce qui ouvre
le port 53 a la frontiere : en exemptant la machine, je lui retirais le droit de
resoudre. `serveur_powerdns` declare donc son propre flux sortant — il ne
recurse pour personne, mais doit resoudre pour lui-meme.

Nouvel intrant `dns_amorcage`, derive jusqu'a `make creer-vm`. Cloud-init
l'ecrit bien mais sans effet : `dns-nameservers` exige `resolvconf`, absent du
gabarit, et installer resolvconf demande apt, qui demande la resolution.
`serveur_debian` pose donc le resolveur en pre_tasks, avant le premier apt, avec
une garde qui respecte la bascule ulterieure de client_unbound.

Defaut corrige en chemin : `_intrants_communs()` lisait `instance/` en dur ; le
chemin derive maintenant de l'inventaire recu, et un test le prouve.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 21:41:58 -04:00
..
defaults Retirer 3 rôles legacy (serveur_sendmail, client_dns, client_ldap) + nettoyage 2026-07-04 12:14:04 -04:00
handlers client_unbound : résolveur local (DNS dynamique) — éprouvé sur un nœud 2026-07-03 14:35:00 -04:00
meta dns : client_unbound universel, et un resolveur d'amorcage 2026-08-06 21:41:58 -04:00
tasks client_unbound : résolveur local (DNS dynamique) — éprouvé sur un nœud 2026-07-03 14:35:00 -04:00
templates client_unbound : résolveur local (DNS dynamique) — éprouvé sur un nœud 2026-07-03 14:35:00 -04:00
README.md docs : un README par rôle (12 manquants) + carte remise à l'état du code 2026-07-29 11:32:06 -04:00

client_unbound

Résolveur local par nœud (Unbound) : cache + récursion, avec une stub-zone vers l'autoritatif interne (PowerDNS). Rend la résolution dynamique sans casser Internet. Troisième et dernière couche du DNS interne (docs/dns-interne.md).

Les trois couches

  1. hosts_statiques — plancher /etc/hosts, toujours là, indépendant de tout service ;
  2. serveur_powerdns — autoritatif de la zone interne ;
  3. ce rôle — résolveur local, opt-in, qui rend la résolution dynamique par nœud.

Rôle

  • Installe unbound et bind9-dnsutils (dig, pour valider avant de basculer).
  • Déploie setops.conf : écoute sur 127.0.0.1, stub-zone vers l'autoritatif interne, récursion (ou transitaires) pour le reste d'Internet.
  • Valide la configuration (unbound-checkconf), active le service.
  • Bascule /etc/resolv.conf vers 127.0.0.1 — protégée (voir ci-dessous).

Garde-fou de bascule (anti-coupure)

Changer le résolveur d'un nœud à distance, c'est risquer de le rendre muet. Le rôle exige donc deux interrupteurs, et vérifie avant d'agir :

client_unbound_apply: true
client_unbound_confirm: true

Sans les deux, le rôle installe et démarre Unbound mais ne touche pas à /etc/resolv.conf (refus explicite). Avec les deux, il applique d'abord les redémarrages en attente, puis valide qu'Unbound résout réellement (un nom interne et un nom Internet) — et ne bascule qu'ensuite. Même doctrine que la règle 4 d'AGENTS.md : action risquée = confirmation explicite.

Variables

Variable Défaut Rôle
client_unbound_ecoute 127.0.0.1 Écoute (boucle locale)
client_unbound_zone_interne {{ domaine_interne }} Zone en stub
client_unbound_dns_autoritatif dérivé du groupe serveur_powerdns Cible de la stub-zone
client_unbound_transitaires [] Vide = récursion propre (racine + DNSSEC)
client_unbound_apply / _confirm false / false Bascule de /etc/resolv.conf

Flux (meta/flux.yml)

53/udp entrant en localhost · 53/tcp sortant vers serveur_powerdns.

Notes / limites

  • Transitaires vides = Unbound récurse lui-même (racine + DNSSEC). Si la récursion sortante est bloquée par le réseau, renseigner client_unbound_transitaires.
  • Le rôle exige l'IP de l'autoritatif interne (assertion) : serveur_powerdns doit être dans l'inventaire avec un ansible_host.
  • DoT (DNS chiffré) n'est pas encore branché — c'est un des flux restants du zéro-confiance.

Prérequis

  • serveur_powerdns actif. Couche agents.