Décisions d'architecture
Chaque décision structurante de cette plateforme a sa page. Pas un résumé écrit après coup : le raisonnement au moment du choix, avec ce qui a été écarté et ce que le choix a coûté.
L’objectif n’est pas de justifier. Il est de répondre à la question qui revient six mois plus tard : « pourquoi c’est fait comme ça, et est-ce que la raison tient encore ? » Sans trace écrite, la réponse est une reconstruction. Avec, c’est une vérification.
Le format
Section intitulée « Le format »Quatre parties, toujours dans cet ordre.
Contexte et contrainte. L’état du monde au moment du choix, et ce qui limitait. Sans cette partie, une décision paraît soit arbitraire, soit évidente — jamais juste.
Options envisagées. Ce qui a été regardé, y compris ce qui a été écarté vite. Une option absente de cette liste est une option qui n’a pas été considérée, et c’est une information en soi.
Décision. Ce qui a été retenu, et la raison qui a fait pencher. Une seule raison principale : quand trois arguments semblent à égalité, c’est généralement que le vrai critère n’a pas encore été trouvé.
Conséquences. Ce que la décision entraîne, en commençant par ce qu’elle coûte. Une page qui n’aurait que des conséquences favorables ne serait pas une décision, ce serait une publicité.
La convention de nommage
Section intitulée « La convention de nommage »NN-sujet-en-minuscules.md, sur deux chiffres, à partir de 01.
Un numéro n’est jamais réutilisé, même si la décision est abandonnée. Il identifie une décision, pas une position dans une liste.
Une décision ne se modifie pas après coup. Si le contexte change et que le choix n’est plus le bon, une nouvelle décision est écrite et l’ancienne est marquée comme remplacée. Un ADR réécrit perd exactement ce qui fait sa valeur : il dit ce qu’on pense aujourd’hui, plus ce qu’on pensait alors.
Les décisions enregistrées
Section intitulée « Les décisions enregistrées »- 01 — OpenTofu plutôt que Terraform : un choix d’outil tranché sur la licence, et la dette d’état qu’il a mise au jour.
- 02 — Pas de haute disponibilité : pourquoi l’engagement porte sur la reconstructibilité et pas sur la disponibilité.
- 03 — Ansible écarté : la règle qui décide de l’ajout d’un outil, appliquée à celui qu’on attend le plus.
- 04 — VictoriaMetrics plutôt que la pile Prometheus : une décision qui n’a pas d’intérêt en soi, et qui rend les autres possibles.
- 05 — Teleport plutôt qu’un bastion SSH : ce que coûtent des certificats de courte durée, y compris la seule étape manuelle qui reste.
Les décisions à venir
Section intitulée « Les décisions à venir »Écrites dans cet ordre, à mesure que les sujets se stabilisent.
- 06 — Debian plutôt qu’Alpine : qu’une base d’image se juge sur le coût de débogage et la bibliothèque C, pas sur la taille affichée.
- 07 — Redis Streams plutôt que RabbitMQ : qu’un composant déjà présent pour le cache et les sessions peut porter la file, et qu’un courtier dédié se paierait en mémoire.
- 08 — KEDA plutôt qu’un autoscaler CPU : que la grandeur qu’on choisit de mesurer détermine ce qu’on est capable de corriger.
- 09 — GitHub Actions plutôt que Jenkins : qu’un exécuteur hébergé hors du cluster évite de faire tourner l’usine sur la machine qu’elle déploie.
- 10 — SOPS et age plutôt que Vault : que le chiffrement dans Git suffit sans rotation automatique ni secrets dynamiques, et ce qu’on perd en renonçant à Vault.
- 11 — Script post-installation et conséquences sur les secrets : comment la clé de déchiffrement atteint un nœud neuf sans se trouver dans Git, et pourquoi c’est le maillon le plus délicat de l’amorçage.
- 12 — Budget mémoire sur 8 Go : la répartition poste par poste, et la règle qui sert à trancher chaque ajout.
- 13 — Documentation découplée du cluster : qu’un runbook hébergé sur la machine qu’il sert à réparer ne vaut rien.
- 14 — Organisation GitHub plutôt que compte personnel : que séparer les identités prépare un transfert, et ce que cela change pour la signature keyless, dont l’identité signataire devient celle de l’organisation.
