Décisions d'architecture (ADR)¶
Chaque page décrit une décision structurante : le contexte, ce qui a été retenu, les alternatives écartées et les conséquences. Les décisions ont été validées au lancement du projet ; le tableau de synthèse est aussi dans le plan.
| # | Sujet | Choix |
|---|---|---|
| 1 | Routeur et pare-feu : OPNsense en VM | OPNsense (VM, 2 vCPU, 1,5 Go) |
| 2 | Fournisseur d'identité : Authentik | Authentik, avec PostgreSQL, en LXC |
| 3 | IaC de l'hyperviseur : OpenTofu et bpg/proxmox | OpenTofu >= 1.10 et provider bpg/proxmox |
| 4 | Système du cluster : Talos Linux | Talos Linux avec un schematic Image Factory (qemu-guest-agent) |
| 5 | Cycle de vie du cluster : Cluster API auto-hébergé | Cluster API (CAPMOX, CABPT, CACPPT, IPAM in-cluster), auto-hébergé |
| 6 | Autoscaling des nœuds : cluster-autoscaler | cluster-autoscaler (provider clusterapi) sur la MachineDeployment challenges |
| 7 | GitOps : ArgoCD dans le cluster de production | ArgoCD en apps-of-apps et ApplicationSets |
| 8 | Secrets : SOPS et age | SOPS + age, ksops, community.sops, carlpett/sops |
| 9 | CNI : Cilium | Cilium sans kube-proxy, LB-IPAM, policies L3/L7, Hubble, WireGuard |
| 10 | Stockage : Proxmox CSI et Garage | Proxmox CSI (ZFS) pour les volumes, Garage (S3) pour les objets |
| 11 | Bases de données : MariaDB et Valkey | mariadb-operator (MariaDB) et Valkey |
| 12 | Instanciation des challenges : chall-manager | chall-manager (ctfer-io) avec un scénario Kubernetes générique |
| 13 | Registry d'images : Zot | Zot avec scan Trivy et signature cosign |
| 14 | Politiques d'admission : Kyverno | Kyverno |
Décisions transverses¶
- Source unique : toute IP, nom, port ou groupe vient de
infra/contracts.yaml(contrat). - Versions épinglées exactement : providers, charts et collections ; images par digest.
- Pas d'action manuelle sur le serveur : après le bootstrap, tout passe par ArgoCD.
- Le front est public, les challenges ne sont joignables que par NetBird.
- CTFd en headless derrière un front Next.js sur mesure.