Déploiement et exploitation

Rétention du journal et rôles PostgreSQL

Le journal des actions grandit sans cesse. Une tâche dédiée exporte les entrées anciennes puis les purge, de façon bornée. Elle repose sur trois rôles PostgreSQL distincts, présentés ici.

Qui peut le faire : l'exploitant, sur le serveur Docker.

Durées de conservation#

DonnéeDurée par défautRéglageMécanisme
Journal des actions180 joursMVP_AUDIT_RETENTION_DAYS (180 à 3 650)Export puis purge, profil maintenance
Alertes résolues90 joursMVP_ALERT_RETENTION_DAYS (7 à 3 650)Automatique, par le worker
Journaux techniques5 fichiers de 10 Mo par conteneurComposeRotation Docker
Sauvegardes14 jours proposésPlanification de l'hôteHors application

Descendre sous 180 jours est refusé par la base. Une obligation plus longue se règle en augmentant MVP_AUDIT_RETENTION_DAYS.

Lancer une rétention#

  1. Créez sur l'hôte un dossier privé, propriété de l'UID 1000, droits 0700.
  2. Renseignez AUDIT_EXPORT_DIR avec ce dossier.
  3. Lancez :
bash
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> --profile maintenance run --rm retention
  1. Chiffrez puis archivez l'export hors du serveur, comme une sauvegarde.

Planifiez cette commande sur l'hôte (cron ou tâche planifiée). La page Exploitation affiche la Dernière purge bornée (31 jours).

Ce que fait la tâche#

Pour chaque organisation :

  1. Export. Elle écrit les entrées antérieures au seuil dans un fichier JSON Lines privé (fichier 0600), au plus MVP_AUDIT_RETENTION_MAX_ROWS lignes. Si ce plafond est atteint, le seuil de purge recule : une entrée supprimée figure toujours dans l'export.
  2. Preuve de l'export. Elle inscrit data.audit_export au journal, avec le nombre d'entrées et l'empreinte SHA-256 du fichier.
  3. Purge. Elle supprime les entrées exportées par lots de 1 000 au plus. Chaque lot laisse une preuve operations.retention_purge.

La purge n'est jamais lancée si l'export a échoué. Les entrées qui servent encore de preuve à un travail en cours sont conservées.

Les trois rôles PostgreSQL#

RôleNom par défautAttributsUtilisé par
Migrationmaintain_ownerConnexion, propriétaire de la base, ni superutilisateur ni création de rôlesrelease, legacy-import, retention (export)
Runtimemaintain_runtimeConnexion, droits limités accordés explicitementweb, worker
Maintenancemaintain_retentionSans connexion, seulement la fonction de purge bornéeretention (purge), endossé par le rôle de migration

Le superutilisateur postgres sert à l'initialisation, aux sauvegardes et à l'exploitation. Il n'est transmis à aucun service applicatif.

Pourquoi trois rôles#

  • Le rôle runtime ne peut ni modifier ni supprimer une entrée du journal. Une faille de l'application ne peut donc pas effacer les traces.
  • La release refuse un superutilisateur et des rôles confondus.
  • /readyz refuse un rôle runtime qui posséderait le schéma : la capacité database reste indisponible.
  • Les opérations d'exploitation (migrations, sauvegardes, restaurations, exports) écrivent au journal avec les privilèges du rôle runtime, jamais avec ceux du propriétaire.

Création des rôles#

Les rôles et leurs mots de passe sont créés une seule fois, à l'initialisation d'un volume PostgreSQL vide. Le journal du premier démarrage affiche Rôles MVP initialisés. Les mots de passe ne sont jamais affichés.

Changer une variable de mot de passe après coup ne change pas le rôle : voir Mises à jour et retour arrière, section « Changer un mot de passe de rôle PostgreSQL ».

Volume initialisé par une version plus ancienne#

Si le rôle de migration ne peut pas endosser le rôle de maintenance, la purge échoue. Accordez ce droit une fois avec le superutilisateur :

bash
docker exec -it <conteneur-postgres> psql -U postgres -d maintain -c 'GRANT maintain_retention TO maintain_owner WITH INHERIT FALSE, SET TRUE, ADMIN FALSE'

Pour continuer#

Pour reprendre les données d’une installation antérieure, voyez la page de migration des données.