Composants¶
Cette section documente chaque brique technologique de la plateforme, une page par brique, avec la même structure : à quoi elle sert ici et pourquoi ce choix, où elle tourne, version épinglée (et où), fichiers de configuration, interactions, sécurité, supervision, opérations courantes, pièges connus et lien vers la documentation officielle. Pour le récit de bout en bout, commencer par Comment tout fonctionne ; pour les décisions, voir les ADR.
Lire cette documentation en local
task docs:serve # aperçu sur http://127.0.0.1:8000, rechargement automatique
task docs:build # mkdocs build --strict (identique à la CI), sortie dans site/
.venv-docs et y installent docs/requirements.txt (versions exactes) s'il est absent ou périmé.
Sans task : python3 -m venv .venv-docs && .venv-docs/bin/pip install -r docs/requirements.txt && .venv-docs/bin/mkdocs serve.
Les versions viennent du dépôt (contrat, versions.yml, Chart, package.json...) ; le chemin exact est donné dans chaque page.
Renovate les maintient à jour (page).
Hyperviseur et réseau¶
| Brique | Rôle | Où elle tourne | Version épinglée |
|---|---|---|---|
| Proxmox VE | Hyperviseur : VM, LXC, stockage ZFS, bridges | hôte bare metal (le seul serveur) | 9.x (prérequis, non piloté par le dépôt) |
| OpenTofu | Infrastructure as code déclarative (9 stacks) | poste opérateur et CI (jamais sur le serveur) | >= 1.10.0 (version du devshell Nix) |
| Provider bpg/proxmox | Crée bridges et VLAN, LXC (Debian 13, non privilégiés, nesting et keyctl pour Docker), la VM OPNsense et le template Talos, et télécharge les images avec vérification de checksum | poste opérateur (via OpenTofu) | 0.116.1 |
| Provider browningluke/opnsense | Gère toute la matrice de flux d'OPNsense (règles « automation » évaluées en premier, blocage par défaut intégré d'OPNsense, journalisé, en fin de chaîne) | poste opérateur (via OpenTofu) | 0.26.0 |
| Provider goauthentik/authentik | Déclare dans Authentik les groupes du contrat, les providers OAuth2 et applications (un par client OIDC), les flows d'inscription joueur et staff, les stages (captcha, e-mail, mot de passe) et le provider proxy (forward-auth) des interfaces internes | poste opérateur (via OpenTofu) | 2026.8.0 |
| Provider netbirdio/netbird | Configure NetBird : groupes, networks (pad-instances, pad-bastion), routing peers, clés d'installation, connecteur d'identité Authentik, utilisateur de service pour netbird-sync et policy staff vers bastion |
poste opérateur (via OpenTofu) | 0.0.10 |
| Provider warp-tech/warpgate | Crée dans Warpgate un rôle par groupe d'accès (défaut infra-admins) et les cibles SSH (LXC, OPNsense, hôte) et HTTP (UI OPNsense, UI Proxmox), rattachées à ces rôles |
poste opérateur (via OpenTofu) | 1.2.0 |
| Provider ovh/ovh | Publie les enregistrements DNS A publics (front, auth, vpn, status) vers l'IP WAN de la plateforme | poste opérateur (via OpenTofu) | 2.22.0 |
| Provider carlpett/sops | Lit les fichiers `* | poste opérateur (via OpenTofu) | 1.4.1 |
| Ansible | Configure l'hôte Proxmox et déploie les services Docker Compose des LXC | poste opérateur (connexion SSH vers l'hôte et les LXC) | collections épinglées (voir ci-dessous) ; ansible du devshell |
| OPNsense | Routeur, pare-feu inter-zones, DNS interne, IDS | VM Proxmox (VMID 200, 2 vCPU, 1,5 Go) | 25.7 (image nano épinglée par sha256) |
Services LXC¶
| Brique | Rôle | Où elle tourne | Version épinglée |
|---|---|---|---|
| Traefik (edge) | Reverse proxy public, TLS, bouncer CrowdSec | LXC edge (zone DMZ, 10.20.20.10) |
v3.7.15 (image épinglée par digest) |
| CrowdSec | Détection de comportements, bannissement, WAF (AppSec) | LXC edge (Docker Compose, avec Traefik) |
v1.8.1 (image épinglée par digest) |
| NetBird | VPN WireGuard des joueurs et du staff | LXC netbird (zone DMZ, 10.20.20.11) + routing peers |
serveur 0.81.0, dashboard v2.95.0 (digests épinglés) |
| Warpgate | Bastion SSH/HTTPS du personnel, avec audit | LXC warpgate (zone BASTION, 10.20.30.10) |
0.29.2 (image épinglée par digest) |
| Authentik | Fournisseur d'identité OIDC unique (SSO) | LXC authentik (zone IDENTITY, 10.20.40.10) |
2026.8.4 (image) ; PostgreSQL 16.15 |
| Docker et Compose (dans les LXC) | Runtime des services d'infrastructure hors Kubernetes | chaque LXC de services (edge, netbird, warpgate, authentik, monitoring) | docker-ce 5:29.9.1, containerd 2.4.2, compose 5.6.0 |
Observabilité¶
| Brique | Rôle | Où elle tourne | Version épinglée |
|---|---|---|---|
| VictoriaMetrics et vmalert | Base de séries temporelles, scraping, règles d'alerte | LXC monitoring (zone MONITORING, 10.20.50.10), Docker Compose |
v1.154.0 (victoria-metrics et vmalert, digests épinglés) |
| Loki | Stockage et requêtes des logs | LXC monitoring (zone MONITORING, 10.20.50.10), Docker Compose |
3.7.8 (image épinglée par digest) |
| Tempo | Stockage des traces distribuées (OTLP) | LXC monitoring (zone MONITORING, 10.20.50.10), Docker Compose |
3.1.0 (image épinglée par digest) |
| Grafana | Tableaux de bord et exploration | LXC monitoring (zone MONITORING, 10.20.50.10), Docker Compose |
13.2.4 (image épinglée par digest) |
| Alertmanager | Routage, regroupement et inhibition des alertes | LXC monitoring (zone MONITORING, 10.20.50.10), Docker Compose |
v0.34.1 (image épinglée par digest) |
| Uptime Kuma | Sondes externes, page de statut publique, dead-man's switch | LXC monitoring (zone MONITORING, 10.20.50.10), Docker Compose |
2.5.6 (image épinglée par digest) |
| Grafana Alloy | Agent de collecte : métriques, logs, traces | hôte Proxmox et chaque LXC (paquet apt), DaemonSet dans le cluster | 1.20.1 (paquet 1.20.1-1, image v1.20.1, chart 1.13.1) |
| Exporters (node, pve, kube-state-metrics, Docker) | Sources de métriques de l'infrastructure | hôte, LXC et cluster | node-exporter v1.12.1 (cluster), kube-state-metrics v2.20.0, pve-exporter (PyPI, épinglé) |
Cluster Kubernetes¶
| Brique | Rôle | Où elle tourne | Version épinglée |
|---|---|---|---|
| Talos Linux | Système d'exploitation immuable des nœuds Kubernetes | VM Proxmox (control plane en zone PROD, workers PROD et CHALLENGES) | v1.11.6 (Kubernetes v1.34.1) |
| Cluster API (core) | Cycle de vie déclaratif du cluster (Cluster, Machine, MachineDeployment) | pods du cluster pad-prod (auto-hébergé) ; kind pendant le bootstrap |
v1.14.3 (contrat v1beta2) |
| CAPMOX (provider Proxmox) | Provider d'infrastructure Cluster API pour Proxmox | pods du cluster (namespace des providers CAPI) | v0.9.1 (contrat v1beta2) |
| CABPT et CACPPT (providers Talos) | Génération de la configuration Talos et gestion du control plane | pods du cluster | CABPT v0.6.13, CACPPT v0.5.14 (contrat v1beta1) |
| IPAM in-cluster (Cluster API) | Allocation d'adresses IP statiques aux machines | pods du cluster | v1.1.1 |
| kind (bootstrap) | Cluster de bootstrap éphémère pour créer pad-prod | poste opérateur (Docker requis), le temps de bootstrap:cluster |
kind v0.33.0, nœud kindest/node:v1.34.11@sha256 |
| cluster-autoscaler | Ajoute et retire des workers du pool challenges | pod du cluster (pool platform) | chart 9.53.0 |
| Cilium et Hubble | CNI, remplacement de kube-proxy, LoadBalancer, chiffrement, observabilité réseau | DaemonSet sur tous les nœuds + operator, Hubble relay et UI | chart 1.20.3 |
| Proxmox CCM | Initialisation des nœuds : providerID CAPMOX, labels de topologie, retrait du taint uninitialized | pod du cluster sur le control plane (namespace csi-proxmox) |
chart proxmox-cloud-controller-manager 0.2.32 (v0.16.1) |
| Proxmox CSI | Volumes persistants sur ZFS pour Kubernetes | pods du cluster (namespace csi-proxmox) ; node plugin sur tous les nœuds |
chart proxmox-csi-plugin 0.5.12 |
| Traefik (cluster) | Ingress interne du cluster | pods Traefik (2 replicas, pool platform), IP 10.20.60.200 | chart 42.0.0 |
Plateforme GitOps¶
| Brique | Rôle | Où elle tourne | Version épinglée |
|---|---|---|---|
| ArgoCD | GitOps : synchronise le cluster avec le dépôt | pods du cluster (namespace argocd, pool platform) |
chart argo-cd 10.10.5 |
| SOPS, age et ksops | Secrets chiffrés dans Git, déchiffrés par chaque consommateur | poste opérateur (sops, age), repo-server ArgoCD (ksops), CI (clé éphémère) | ksops v4.5.1 ; sops et age du devshell |
| cert-manager | Certificats TLS automatisés (ACME DNS-01 et CA interne) | pods du cluster (namespace cert-manager) |
chart v1.21.2 ; webhook OVH 0.9.18 |
| Kyverno | Politiques d'admission et génération de NetworkPolicy | pods du cluster (namespace kyverno, pool platform) |
chart 3.9.1 |
| KEDA | Autoscaling horizontal des applications sur métriques | pods du cluster (namespace keda) |
chart 2.21.0 |
| external-dns | DNS dynamique pour les Services et Ingress (désactivé par défaut) | pod du cluster (0 réplica tant que non activé) | chart 1.23.0 |
| mariadb-operator et MariaDB | Base de données de CTFd, opérée par un operator | pods du cluster (namespace ctfd, StatefulSet), operator dans mariadb-operator |
operator 26.10.1, MariaDB 10.11.19 |
| Valkey | Cache et état partagé (sessions, jetons, verrous) | pod du cluster (namespace storage, StatefulSet) |
chart 0.12.0, image 9.1.2 |
| Garage (S3) | Stockage d'objets S3 : fichiers de challenges et sauvegardes | pod du cluster (StatefulSet garage-0, namespace storage) |
v2.4.1 |
| Zot (registry OCI) | Registry d'images interne avec scan de vulnérabilités | pod du cluster (namespace registry), registry.pad.internal |
chart 0.1.128, image v2.1.22 |
| cosign et Trivy | Signature des images et détection de vulnérabilités | CI (signature, scan), Zot (scan CVE), Kyverno (vérification) | cosign et trivy du devshell (flake.lock) ; Trivy DB via Zot |
Applications CTF¶
| Brique | Rôle | Où elle tourne | Version épinglée |
|---|---|---|---|
| CTFd (headless) | Moteur de CTF : challenges, équipes, soumissions, scoreboard | pods du cluster (namespace ctfd, 2 à 4 replicas) |
3.8.8 (image ctfd/ctfd épinglée par digest) + plugins pad_* |
| Plugin CTFd pad_common | Bibliothèque partagée des plugins (auth, rôles, rate limit, audit) | dans le pod CTFd (plugin chargé depuis CTFd/plugins/) |
version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt |
| Plugin CTFd sso_bridge | Pont SSO : identité OIDC vers session API CTFd | dans le pod CTFd (plugin chargé depuis CTFd/plugins/) |
version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt |
| Plugin CTFd chall_manager_bridge | Type de challenge dynamic_instance et API des instances | dans le pod CTFd (plugin chargé depuis CTFd/plugins/) |
version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt |
| Plugin CTFd pad_teams | Création, adhésion et sortie d'équipe sûres | dans le pod CTFd (plugin chargé depuis CTFd/plugins/) |
version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt |
| Plugin CTFd pad_public | Lectures publiques : état de l'événement et first bloods | dans le pod CTFd (plugin chargé depuis CTFd/plugins/) |
version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt |
| Plugin CTFd manager_api | API du portail manager : import, statistiques, modération, événement | dans le pod CTFd (plugin chargé depuis CTFd/plugins/) |
version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt |
| Plugin CTFd metrics_exporter | Endpoint /metrics au format Prometheus | dans le pod CTFd (plugin chargé depuis CTFd/plugins/) |
version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt |
| chall-manager | Orchestrateur d'instances de challenges | pod du cluster (namespace chall-manager, 1 réplica) + CronJob janitor |
v0.6.6 (serveur et janitor, digests épinglés) |
| Scénario Pulumi Go (instance générique) | Programme qui construit une instance : namespace, pod, Service, NetworkPolicy | binaire exécuté par chall-manager ; publié en OCI dans Zot | scénario 0.1.0 ; Go 1.27.2, Pulumi SDK v3.219.0, SDK chall-manager v0.6.6 |
| netbird-sync | Contrôleur : ouvre l'accès NetBird à l'équipe propriétaire de l'instance | pod du cluster (namespace netbird-sync) |
image 0.1.0 ; Go 1.26, controller-runtime v0.25.2 |
| Front Next.js (Auth.js et BFF) | Interface joueur et manager, et BFF devant CTFd | pods du cluster (namespace frontend, 2 à 4 replicas) |
Next.js 16.4.2, React 19.3.1, next-auth 5.0.0-beta.32 |
Outillage et CI¶
| Brique | Rôle | Où elle tourne | Version épinglée |
|---|---|---|---|
| Nix (devshell) | Environnement de développement reproductible | poste opérateur, CI | nixpkgs 25.05 (figé par flake.lock) |
| Taskfile (go-task) | Point d'entrée unique des commandes | poste opérateur, CI | go-task du devshell |
| GitHub Actions | Intégration continue : validations, images signées, documentation | runners GitHub (ubuntu-24.04) | actions épinglées par SHA de commit |
| Renovate et Dependabot | Mise à jour automatique des versions épinglées | services SaaS (propositions de PR) | configuration renovate.json ; .github/dependabot.yml |
| k6 (tests de charge) | Test de charge du front, de CTFd et du cycle d'instance | poste opérateur (idéalement depuis NetBird) | k6 du devshell (flake.lock) |
| Playwright (tests e2e du front) | Tests de bout en bout du front en mode simulé | poste de dev et CI | @playwright/test 1.64.1 |
| MkDocs Material (documentation) | Génération du site de documentation | poste de dev et CI | mkdocs 1.6.1, mkdocs-material 9.6.23 |