History

Daniel Allaire 8eedeaf31f sauvegarde : le catalogue derive du groupe, et P36 le prouve Correction : l'entree precedente attribuait le defaut a la reconstruction from-zero. C'est faux — le commit fondateur `7476a54` (2026-07-03) disait lui-meme « Reste : jobs Tier 1 (pg_dump/slapcat/vmail/forgejo) ». Ils n'ont jamais ete ecrits, et infra-pki-01 a ensuite perdu son integration client_backup. Le role qui POSSEDE la donnee dit comment la sortir : client_backup_jobs est l'intersection du catalogue et des group_names du noeud. Un tenant qui deplace un service emporte sa sauvegarde avec lui. On sauvegarde l'etat NON REGENERABLE : ni zones PowerDNS ni tableaux Grafana, ils se redeploient. L'unite qui ment est RETIREE, pas rendue bloquante : refuser le deploiement aurait casse infra-edge-01, infra-dns-01 et mon-01, qui ne detiennent legitimement rien. Le defaut etait le timer qui echouait chaque nuit en donnant l'apparence d'une sauvegarde. P36 (D-75) lit les groupes detenteurs dans le catalogue : ajouter un role au catalogue etend la preuve du meme geste. Elle a attrape infra-pki-01 — les cles de l'AC — corrige au plan. Mesure hors-noeud : collab-01 64,0 MiB/272, edge-mta-01 4,4 MiB/139, data-sql-01 1,0 MiB (pg_dumpall complet), forge-01 26,4 KiB/68, infra-pki-01 20,1 KiB/21, idm-01 2,3 KiB/5 (slapcat). 9 hotes, 9 success. Reste : rien ne surveille l'unite — c'est ce silence qui a laisse le defaut vivre un mois. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>		2026-08-11 20:50:46 -04:00
..
defaults	sauvegarde : le catalogue derive du groupe, et P36 le prouve	2026-08-11 20:50:46 -04:00
handlers	sauvegarde : le catalogue derive du groupe, et P36 le prouve	2026-08-11 20:50:46 -04:00
meta	Reconstruction propre : orchestrateur ordonné, registre des flux + pare-feu	2026-07-07 03:08:09 -04:00
tasks	sauvegarde : le catalogue derive du groupe, et P36 le prouve	2026-08-11 20:50:46 -04:00
templates	Sauvegardes applicatives (restic) : serveur_backup + client_backup — Tier 0 prouvé	2026-07-03 22:49:26 -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

README.md

client_backup

Intégration cliente sauvegarde : le nœud pousse ses données (pas sa VM) vers le dépôt restic hors-nœud (serveur_backup), chiffrées côté client, sur un timer systemd.

Principe

L'infrastructure est reconstructible par le code (make reconstruire). Ce qui ne se reconstruit pas, c'est l'état : clés de l'AC, annuaire, bases, courrier, dépôts Git. C'est cet état — et lui seul — que ce rôle sauvegarde.

Rôle

Installe restic.
Dépose la clé SSH privée de sauvegarde et le mot de passe restic dans /etc/setops (0600), depuis la voûte.
Configure l'accès SSH vers la cible (utilisateur restreint restic).
Déploie sauvegarder.sh + l'unité et le timer systemd, et l'active.

Jobs déclaratifs

Chaque nœud déclare ses client_backup_jobs (en group_vars/host_vars) :

client_backup_jobs:
  - nom: step_ca
    chemins: [/etc/step-ca]
  - nom: postgresql
    commande: "sudo -u postgres pg_dumpall > /var/backups/setops/postgresql/all.sql"
    chemins: [/var/backups/setops/postgresql]

Le script exécute, dans l'ordre : les commande (dumps vers le staging) → restic init si le dépôt est neuf → restic backup de tous les chemins → restic forget --prune (rétention).

Secrets requis (Vault)

vault_restic_password      # mot de passe du dépôt restic (le chiffrement)
vault_backup_ssh_privkey   # clé privée SSH vers la cible (publique côté serveur_backup)

Sans eux, le rôle refuse de s'exécuter (assertion).

Variables principales

Variable	Défaut	Rôle
`client_backup_cible`	`backup-01.{{ domaine_interne }}`	Nœud dépôt
`client_backup_repo`	`sftp:restic@<cible>:<hôte>`	Un sous-dossier par nœud
`client_backup_staging`	`/var/backups/setops`	Préparation des dumps
`client_backup_retention`	`--keep-daily 7 --keep-weekly 4 --keep-monthly 6`	`restic forget`
`client_backup_horaire`	`--* 02:30:00`	Timer systemd
`client_backup_jobs`	`[]`	À déclarer par nœud

Notes / limites

Chiffrement côté client : la cible ne voit que des blocs chiffrés — elle n'a donc pas besoin d'être aussi protégée que les sources.
client_backup_jobs: [] = le timer tourne mais ne sauvegarde rien. C'est silencieux : vérifier que chaque nœud porteur d'état déclare ses jobs.
Un dépôt neuf est vide jusqu'à la première exécution : après une reconstruction from-zero, déclencher une première sauvegarde plutôt que d'attendre 02:30.
Restauration : restic restore avec le même mot de passe (cf. docs/runbooks-exploitation.md).

Prérequis

serveur_backup déployé, et sa serveur_backup_pubkey correspondant à la clé privée de la voûte. Couche agents (après les services).