chall-manager¶
Couche : Applications CTF · Où : pod du cluster (namespace chall-manager, 1 réplica) + CronJob janitor · Version : v0.6.6 (serveur et janitor, digests épinglés)
À quoi elle sert ici et pourquoi ce choix¶
Crée et détruit, à la demande, l'environnement d'un challenge pour une équipe, avec un TTL. Il exécute un scénario Pulumi (le scénario générique), ce qui permet des challenges qui ne sont pas un simple conteneur. Décision : ADR 12.
Où elle tourne et comment elle est déployée¶
gitops/apps/chall-manager : un Deployment (état Pulumi en backend fichier sur un PVC, plugins et scénarios OCI en cache sur le même volume), un ServiceAccount avec un ClusterRole limité
(namespaces, services, deployments, networkpolicies) et un CronJob janitor toutes les minutes qui détruit les instances expirées.
Version épinglée¶
Images docker.io/ctferio/chall-manager:v0.6.6@sha256:... et chall-manager-janitor:v0.6.6@sha256:... dans gitops/apps/chall-manager/deployment.yaml ; SDK du scénario chall-manager/sdk v0.6.6 (apps/chall-manager-scenario/go.mod).
Fichiers de configuration dans le dépôt¶
gitops/apps/chall-manager/:deployment.yaml,rbac.yaml,networkpolicy.yaml,scaledobject.yaml,secret.example.yaml,secret-generator.yaml.- Variables du scénario (hérités par le programme Pulumi) :
PAD_LB_POOL,PAD_LB_POOL_LABEL,PAD_FROM_CIDRS(routing peer NetBird seul,10.20.70.10/32),PAD_IMAGE_PREFIX(registry.pad.internal/ctf/),PAD_HOST_USERS(false: user namespaces) et, en option,PAD_RUNTIME_CLASS. Elles reprennent le contrat (netbird.routing_peer_ip,instances.*).
Interactions avec les autres briques¶
Appelé par le plugin chall_manager_bridge ; télécharge le scénario depuis Zot ; crée les ressources via l'API Kubernetes ; envoie des traces à Tempo.
Sécurité¶
- Seuls les pods du namespace CTFd peuvent l'appeler (NetworkPolicy) ; Swagger désactivé ;
readOnlyRootFilesystem,drop: ALL,seccomp: RuntimeDefault. - Droits RBAC limités aux objets que crée le scénario ; pull du scénario avec un compte registry en lecture seule (
pad-pull). - Les instances qu'il crée sont isolées par le scénario (entrée limitée au routing peer, aucune sortie, user namespace, image du registre interne par empreinte) et bornées par Kyverno (quota, LimitRange).
Supervision¶
Alertes ChallManagerDeploymentDown, ChallManagerErrorRate : Instances ; traces OTLP dans Tempo ; dashboard pad-live-ctf.
Opérations courantes¶
kubectl -n chall-manager get pods,cronjob
kubectl -n chall-manager logs deploy/chall-manager --tail=50
kubectl get ns | grep '^inst-'
Pièges connus¶
- Un seul réplica (état Pulumi sur fichier) : le
ScaledObjectest borné à 1. - Le premier lancement télécharge les plugins Pulumi : prévoir un délai (volume de cache persistant).
- Egress restreint : plus de
0.0.0.0/0:443. LaCiliumNetworkPolicychall-manager-egress-fqdnn'autorise que les hôtes de releases GitHub (github.com,api.github.com,objects.githubusercontent.com,release-assets.githubusercontent.com) etget.pulumi.comsur le port 443 (téléchargement des plugins), et filtre le DNS (ces noms, le registre interne,*.cluster.local). Choix : l'image officielle n'embarque pas les plugins et Zot ne les sert pas ; une image maison ajouterait une chaîne de build à maintenir. Le cache des plugins vit sur le PVC : une fois chaud (premierpulumi upréussi), retirer la règletoFQDNspour couper tout egress Internet ; la remettre pour monter la version du provider Kubernetes du scénario. Si une instance échoue sur un téléchargement, regarderhubble observe --namespace chall-manager --verdict DROPPEDet ajouter l'hôte manquant.