Démarrage rapide¶
Ce résumé déploie la plateforme complète sur un hyperviseur Proxmox VE neuf. Compter une à deux heures à la première exécution, hors temps de préparation des prérequis.
Prérequis¶
Matériel¶
Budget de ressources cible de la plateforme (voir Scaling) :
| Ressource | Cible | Remarque |
|---|---|---|
| CPU | 8 vCPU | surcommit accepté |
| RAM | environ 26 Go | le total alloué va d'environ 17 Go (minimum) à 22 Go (maximum) |
| Disque | stockage ZFS | l'ARC ZFS est limité à 4 Go |
| Réseau | une IP publique | idéalement une IP supplémentaire routée vers la VM routeur, sinon le mode nat |
Comptes et accès¶
- Un hôte Proxmox VE 9.x, vierge ou sans conflit de VMID ni de bridge avec le contrat, et un token API Proxmox (privilèges VM, LXC, stockage et réseau).
- Un accès SSH à l'hôte, root ou sudo, pour le rôle
host-tuning(ARC ZFS, nftables, sysctl). - Un domaine et un token API DNS (OVH par défaut) pour cert-manager et external-dns.
- Un webhook Discord et un SMTP pour les notifications d'alerte.
- Un dépôt Git joignable par le cluster (ArgoCD) et, si le dépôt est privé, une clé de déploiement.
Poste opérateur¶
Le shell de développement est fourni par Nix et épingle tous les outils :
Il apporte task, tofu, ansible, kubectl, helm, clusterctl, kind, sops, age, yq, k6 et le reste.
Un démon Docker local est nécessaire pour le cluster kind éphémère du bootstrap.
Guide complet
Pour déployer phase par phase, en vérifiant chaque étape (et savoir détruire et repartir de zéro), suivre le Guide de déploiement. Cette page n'en est que le résumé.
1. Valeurs de site¶
Les valeurs propres à votre hôte (URL de l'API Proxmox, accès SSH, IP publique, passerelle, MAC) sont des entrées
que vous fournissez dans secrets/site.sops.yaml, chiffré comme les autres secrets (étape suivante) :
Le nœud Proxmox s'appelle pve dans le contrat ; pour un autre nom : task site:node -- <nom>.
Détails dans Valeurs de site.
2. Secrets¶
Les secrets sont commités chiffrés (SOPS + age). Procédure complète : Secrets.
task secrets:keys # clés age opérateur et cluster, hors du dépôt (à sauvegarder hors machine)
task secrets:init # crée tous les *.sops.yaml manquants (valeurs aléatoires fortes)
task secrets:pending # liste ce qu'il reste à renseigner à la main (valeurs de site, jeton Proxmox, OVH, Discord, SMTP...)
sops secrets/proxmox.sops.yaml
task phase:0-prereqs # tri des valeurs exigibles maintenant ; secrets:check ne sera OK qu'à la fin du déploiement
Sauvegardez les clés privées age
Sans la clé opérateur, les secrets du dépôt sont illisibles. Sans la clé du cluster, ArgoCD ne peut plus déchiffrer les Secrets Kubernetes. Elles ne sont jamais dans le dépôt.
3. Déployer¶
task up enchaîne, dans l'ordre et de façon idempotente :
- réseau de l'hôte (
vmbr2) et réglages de l'hôte (Ansible) ; - routeur OPNsense, image Talos, règles du pare-feu ;
- LXC de services, DNS public, puis leur configuration par Ansible, première passe (monitoring, Authentik, edge) ;
- configuration d'Authentik (OIDC, groupes, flows, MFA du staff), recopie des secrets OIDC générés dans les sops (
secrets:oidc-sync), puis seconde passe Ansible (Warpgate, NetBird, Grafana) ; - cluster
kindéphémère, Cluster API, clusterpad-prod, pivot ; - ArgoCD et l'Application
root, qui synchronise la plateforme puis les applications ; - accès NetBird et Warpgate, puis smoke tests.
Chaque phase peut être relancée seule (task tofu:apply-stack STACK=60-opnsense-rules, task bootstrap:gitops...).
Voir Tâches task et le détail pas à pas dans le runbook up.
4. Actions manuelles¶
Quelques actions ne sont pas automatisables (policy NetBird par défaut, jeton de netbird-sync, clés du captcha, enrôlement MFA du premier administrateur,
clé cosign, règle d'accès Zot, protection de la branche main, fichiers de verrouillage). Elles sont toutes dans
Actions manuelles après déploiement. Ne pas ouvrir l'événement aux joueurs
avant de les avoir faites.
5. Vérifier¶
Le script contrôle les endpoints publics, la découverte OIDC, la santé du front, les nœuds Kubernetes, l'état Synced/Healthy des Applications ArgoCD, l'isolement de la zone CHALLENGES et VictoriaMetrics. Il doit être lancé depuis un poste connecté à NetBird (ou passant par le bastion).
Et ensuite¶
- Créer le premier compte manager dans Authentik (groupe
ctf-managers) puis suivre le guide manager. - Régler les alertes : Supervision.
- Faire une sauvegarde avant tout changement lourd.