Aller au contenu

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.