Aller au contenu

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.

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é.

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.

É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.