Files

Gabriel Radureau 8330d82225 docs(runbooks): add "new web app" setup runbook under doc/runbooks/

Document, as a tree-docs tree, the end-to-end procedure to stand up a new
web application on the Arcodange platform — a mechanic spread across the
factory, tools and app repos with non-trivial ordering dependencies.

Covers: Gitea repo creation (org-secret inheritance), Postgres DB + owner
role (factory/postgres/iac), platform Vault declaration (gitea_cicd_<app>
+ policies, tools/hashicorp-vault/iac), the app Helm chart (VSO dynamic
secrets via pgbouncer), the app Terraform (app_roles module), the CI
workflows (tofu apply + image build, incl. the copy-pasted role pitfall),
and ArgoCD registration (factory/argocd/values.yaml). Adds a naming-
conventions concept page and an ordered checklist.

Wires the legacy doc/adr "setup hello world web app" item and the factory
README to the runbook. New docs live under doc/ (singular) per the PR #8
convention.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-05-31 17:22:30 +02:00

993 B

Raw Permalink Blame History

Factory > Doc > Runbooks

Runbooks

Scope : procédures opérationnelles pas-à-pas de la plateforme Arcodange. Chaque runbook se lit du début à la fin et mène à un résultat vérifiable. Pour le pourquoi (décisions d'architecture), voir les ADR.

%%{init: {'theme': 'base'}}%%
flowchart LR
    classDef node fill:#059669,stroke:#047857,color:#fff
    OP["Opérateur"]:::node --> RB["Runbook<br>(procédure ordonnée)"]:::node --> RES["Résultat vérifiable<br>(app en ligne, etc.)"]:::node

Index

Runbook	Résumé	Statut
Nouvelle application web	Créer une app web de zéro dans un nouveau dépôt Gitea : dépôt, base de données, Vault, chart Helm, Terraform, CI, ArgoCD	✅

Tip

Pour ajouter un runbook : créer un dossier kebab-case/ avec son README.md (front door : intro + diagramme + index), puis ajouter sa ligne ci-dessus.

993 B Raw Permalink Blame History

Runbooks

Index

993 B

Raw Permalink Blame History