Scénario Pulumi Go (instance générique)¶
Couche : Applications CTF · Où : binaire exécuté par chall-manager ; publié en OCI dans Zot · Version : scénario 0.1.0 ; Go 1.27.2, Pulumi SDK v3.219.0, SDK chall-manager v0.6.6
À quoi elle sert ici et pourquoi ce choix¶
Un seul scénario générique, paramétré par le challenge (image, ports, limites, TTL, DNS), suffit pour les challenges « un conteneur ». Il crée tout ce qu'il faut pour une instance isolée et
renvoie la connection_info (IP:port) au joueur. Il refuse avant toute création de ressource une image hors du registre interne ou sans empreinte, et des limites au-delà des plafonds.
Où elle tourne et comment elle est déployée¶
apps/chall-manager-scenario/build.sh compile un binaire statique et pousse Pulumi.yaml et main en artefact OCI (oras) dans Zot. chall-manager le récupère au moment de créer l'instance ;
aucune toolchain Go n'est nécessaire dans le cluster.
Version épinglée¶
apps/chall-manager-scenario/go.mod (Go 1.27.2 ; pulumi-kubernetes/sdk/v4 v4.25.0 ; pulumi/sdk/v3 v3.219.0) ; référence OCI : apps.chall_manager.generic_scenario du contrat, tag 0.1.0
(PAD_GENERIC_SCENARIO dans gitops/apps/ctfd/deployment.yaml).
Fichiers de configuration dans le dépôt¶
apps/chall-manager-scenario/ : main.go, scenario.go (ressources), config.go (validation des clés additional), Pulumi.yaml, build.sh, tests *_test.go.
Interactions avec les autres briques¶
Exécuté par chall-manager ; l'IP est allouée par Cilium (pool instances) ; les pods sont admis par Kyverno ; l'accès est ouvert par netbird-sync.
Sécurité¶
- Namespace
inst-<identité>en PSSrestricted; podrunAsNonRoot,seccomp: RuntimeDefault,allowPrivilegeEscalation: false,drop: ALL, sans jeton de ServiceAccount ni variables de service. - User namespace :
hostUsers: falsepar défaut (le root du conteneur n'est pas root sur le worker) ;PAD_HOST_USERS=trueest l'échappatoire. Option sandbox noyau :PAD_RUNTIME_CLASS(RuntimeClass gVisor ou Kata, non activée). - Image imposée : sous
PAD_IMAGE_PREFIX(registry.pad.internal/ctf/) et épinglée par@sha256:(même règle que le schémachallenge.ymlet que Kyverno). - Ressources bornées :
requestsetlimitstoujours posés (défauts 500m / 256Mi / 256Mi de disque éphémère), plafonnés à 2 CPU, 1Gi, 1Gi ; Kyverno ajouteResourceQuotaetLimitRange. - Placement sur le pool
challenges(nodeSelector et toleration du taint), dont le kubelet limite à 256 PIDs par pod et 40 pods par nœud. NetworkPolicypad-instance: entrée uniquement depuis le routing peer NetBird (PAD_FROM_CIDRS=10.20.70.10/32, masquerade) sur les ports déclarés ; l'overlay100.64.0.0/10est refusé par le scénario, l'accès par équipe est porté par les policies NetBird de netbird-sync. Aucune sortie, DNS compris (un DNS ouvert permettrait un tunnel vers Internet).- DNS en opt-in : la clé
dns: clusterduchallenge.yml(réservée aux administrateurs) pose le labelpad.io/dns=cluster-localsur le namespace ; Kyverno génère alors uneCiliumNetworkPolicyqui ne laisse passer vers CoreDNS que les noms*.cluster.local. Défaut :none. externalTrafficPolicy: Localpour préserver l'IP source de la policy.
Supervision¶
Erreurs de création : ChallManagerErrorRate (Instances) ; pool d'IP épuisé : message « aucune IP LoadBalancer allouée (pool épuisé ?) ».
Opérations courantes¶
cd apps/chall-manager-scenario && go test ./...
./build.sh 0.1.0 # binaire dans dist/
./build.sh 0.1.0 --push # publie dans Zot (oras login requis)
Pièges connus¶
- L'identité (
team-<id>) devient un nom de namespace DNS-1123 de 63 caractères au plus ; les caractères invalides sont remplacés. - Les labels
pad.io/teametpad.io/challengesont posés sur les ressources : netbird-sync en dépend. - Une image sans empreinte, hors préfixe, ou des limites trop hautes font échouer la création de l'instance dès la validation, avec un message explicite (rien n'est créé dans le cluster).
- Les nœuds challenges doivent pouvoir tirer
registry.pad.internal/ctf/: règle d'accès Zot et identifiants de pull, voir Actions manuelles. - Un pool
instancesde 100 adresses borne le nombre d'instances simultanées.