Aller au contenu

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 PSS restricted ; pod runAsNonRoot, seccomp: RuntimeDefault, allowPrivilegeEscalation: false, drop: ALL, sans jeton de ServiceAccount ni variables de service.
  • User namespace : hostUsers: false par défaut (le root du conteneur n'est pas root sur le worker) ; PAD_HOST_USERS=true est 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éma challenge.yml et que Kyverno).
  • Ressources bornées : requests et limits toujours posés (défauts 500m / 256Mi / 256Mi de disque éphémère), plafonnés à 2 CPU, 1Gi, 1Gi ; Kyverno ajoute ResourceQuota et LimitRange.
  • Placement sur le pool challenges (nodeSelector et toleration du taint), dont le kubelet limite à 256 PIDs par pod et 40 pods par nœud.
  • NetworkPolicy pad-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'overlay 100.64.0.0/10 est 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: cluster du challenge.yml (réservée aux administrateurs) pose le label pad.io/dns=cluster-local sur le namespace ; Kyverno génère alors une CiliumNetworkPolicy qui ne laisse passer vers CoreDNS que les noms *.cluster.local. Défaut : none.
  • externalTrafficPolicy: Local pour 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/team et pad.io/challenge sont 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 instances de 100 adresses borne le nombre d'instances simultanées.

Documentation officielle

www.pulumi.com/docs · ctfer.io/docs/chall-manager

Retour à l'index des composants