Aller au contenu

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 ScaledObject est 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. La CiliumNetworkPolicy chall-manager-egress-fqdn n'autorise que les hôtes de releases GitHub (github.com, api.github.com, objects.githubusercontent.com, release-assets.githubusercontent.com) et get.pulumi.com sur 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 (premier pulumi up réussi), retirer la règle toFQDNs pour 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, regarder hubble observe --namespace chall-manager --verdict DROPPED et ajouter l'hôte manquant.

Documentation officielle

ctfer.io/docs/chall-manager

Retour à l'index des composants