Aller au contenu

Tâches task

Tout passe par Task (Taskfile racine, qui inclut infra/tofu, infra/ansible, bootstrap, apps, scripts/Taskfile.secrets.yml et scripts/Taskfile.docs.yml). task --list-all affiche la liste à jour ; cette page la décrit. Le parcours complet, pas à pas : Guide de déploiement.

Déploiement par phases

task up enchaîne les phases 0 à 12. Chaque phase:* fait son action, puis lance sa vérification (lecture seule, OK/KO/WARN) et consigne sa réussite pour task status. PAD_CHECK_MODE=warn empêche un KO de bloquer l'enchaînement.

Tâche Effet
up phases 0 à 12 dans l'ordre (idempotent, reprenable)
phase:0-prereqs outils, clés age, secrets, SSH et API Proxmox, privilèges du jeton, stockages (dont point de montage du dataset ZFS des VM)
phase:1-reseau 00-host-network puis ansible:host
phase:2-routeur 10-router, attente d'OPNsense, host:route, 60-opnsense-rules
phase:3-image-talos 15-talos-image (template Talos)
phase:4-lxc 20-services-lxc (six LXC, inventaire Ansible)
phase:5-dns 70-dns (A publics)
phase:6-services-1 Ansible : monitoring, authentik, edge
phase:7-identite 30-authentik puis secrets:oidc-sync
phase:8-services-2 Ansible : monitoring, warpgate, netbird
phase:9-cluster bootstrap:cluster (kind, CAPI, VMs Talos, pivot)
phase:10-gitops contrôle « tout est poussé », bootstrap:gitops
phase:11-acces contrôle des jetons, Ansible netbird, 40-netbird, netbird:sync-keys, netbird:sync-tokens, netbird:agents (routing peers), 50-warpgate
netbird:sync-keys setup keys de 40-netbird vers secrets/netbird-agent.sops.yaml
zot:pull-auth identifiants de pull Zot (pad-pull) sur chaque nœud du pool challenges (API Talos) ; redémarre seulement les nœuds qui les reçoivent ; à rejouer après chaque nouveau nœud
netbird:sync-tokens PAT des utilisateurs de service (netbird_token de 40-netbird) vers les secrets de gitops/apps/netbird-sync et gitops/apps/frontend
netbird:agents /dev/net/tun (hôte) puis agents NetBird de nbrouter et warpgate
netbird:rotate-keys recrée les setup keys, les recopie, rejoue les agents
phase:12-verify smoke tests et rappel des actions manuelles
check:0-prereqs … check:12-verify la vérification d'une phase, seule
check:cluster-detruit, check:tout-detruit contrôles après destruction
status quelles phases semblent faites (hors ligne) ; task status -- --live rejoue les vérifications
plan:<stack> tofu plan d'une stack (plan:00-host-network, plan:10-router, plan:15-talos-image, plan:20-services-lxc, plan:30-authentik, plan:40-netbird, plan:50-warpgate, plan:60-opnsense-rules, plan:70-dns)
host:route rejoue le rôle host-tuning (tag host_route) : route de l'hôte vers les zones via OPNsense, permanente et idempotente (déjà jouée par la phase 2)
host:lxc-features rejoue le rôle host-tuning (tag host_lxc_features) : keyctl sur les LXC de services, réservé à root@pam côté API (déjà jouée par la phase 4)
verify smoke tests (scripts/verify.sh)

Destruction et reconstruction

Toutes passent par scripts/confirm-destroy.sh (taper destroy, ou PAD_CONFIRM_DESTROY=destroy). Voir Détruire, reconstruire.

Tâche Effet
cluster:destroy cluster seul : pivot inverse vers kind, suppression des VMs par Cluster API
cluster:destroy-force cluster cassé : suppression directe des VMs par tag via l'API Proxmox
cluster:rebuild cluster:destroy puis phases 9 et 10
destroy tout sauf l'hôte, en ordre inverse : runbook
rebuild destroy puis up, chronométré : runbook
state:purge efface l'état local après destruction (-- --force, -- --backups)

Valeurs de site, sauvegardes, tests, documentation

Tâche Effet
site:set -- cle=valeur… valeurs non secrètes à mettre dans le dépôt (node, datastore_vm, datastore_vm_type, datastore_iso, domain, acme_email, git_repo, git_ssh, dns_zone, zones_bridge, transit_bridge, wan_mode) : contrat + manifests marqués (zones_bridge/transit_bridge : à changer si l'hôte utilise déjà vmbr2/vmbr1, la phase 0 refuse un pont déjà utilisé) ; -- --show
task site:sync après git pull upstream main : réaligne les fichiers gitops/ sur les valeurs de votre contrat (domaine, dépôt, nœud, stockages)
site:node -- <nom> alias de site:set -- node=<nom>
backup / restore MariaDB + Garage : runbook
e2e pile e2e locale (docker compose) et smoke tests ; task e2e -- down l'arrête
load test de charge k6 (PAD_PROFILE=smoke, load, stress)
lint toutes les vérifications statiques, identiques à la CI (scripts/lint.sh)
docs:serve, docs:build, docs:venv aperçu local sur http://127.0.0.1:8000, build strict, venv de la documentation

OpenTofu (task tofu:...)

Tâche Effet
tofu:apply-stack STACK=<nom> init + apply d'une stack
tofu:plan-stack STACK=<nom> init + plan
tofu:destroy-stack STACK=<nom> [MODE=tolerant] destroy ; ignoré sans state ; tolerant met le state de côté si l'API du service a disparu
tofu:apply-netbird, tofu:apply-warpgate applique 40-netbird et 50-warpgate (jetons requis)
tofu:fmt, tofu:validate-all formatage, fmt -check + validate sans accès serveur
tofu:lock régénère les .terraform.lock.hcl multi-plateformes

Stacks : 00-host-network, 10-router, 15-talos-image, 20-services-lxc, 30-authentik, 40-netbird, 50-warpgate, 60-opnsense-rules, 70-dns.

Ansible (task ansible:...)

Tâche Effet
ansible:deps installe les collections épinglées
ansible:host configure l'hôte Proxmox (inventaire d'exemple tant que les LXC n'existent pas)
ansible:services déploie edge, netbird, warpgate, authentik, monitoring (-- --tags …, -- --limit …)
ansible:syntax, ansible:lint contrôles sans contact avec le serveur

Bootstrap (task bootstrap:...)

Tâche Effet
bootstrap:cluster kind éphémère, Cluster API, pad-prod, Cilium, pivot (reprenable)
bootstrap:gitops ArgoCD, Secret sops-age, Secret du dépôt, Application root
bootstrap:destroy pivot inverse et suppression du cluster (utilisé par cluster:destroy et destroy)
bootstrap:kubeconfig affiche KUBECONFIG / TALOSCONFIG (régénère si absents)
bootstrap:render-providers rend les manifestes des providers CAPI depuis le contrat

Applications (task apps:...)

Tâche Effet
apps:pin-digests -- [tag] épingle dans les manifests les empreintes des images publiées sur ghcr (tag = sha court, défaut HEAD) : Images signées
apps:zot:publish -- [tag] publie dans Zot le scénario chall-manager (OCI, oras) et copie les images de challenge de ghcr vers registry.pad.internal/ctf/ (même empreinte) ; après la phase 10 : Guide, phase 11
apps:build, apps:push, apps:sign construit / pousse / pousse et signe (cosign) les images
apps:build:ctfd, :frontend, :netbird-sync, :chall-manager-scenario image d'un composant
apps:build:chal-pwn-ret2win-instanced, :chal-web-sqli-instanced images des exemples de challenges

Secrets (task secrets:...)

Tâche Effet
secrets:keys génère les clés age opérateur et cluster (hors dépôt) et renseigne .sops.yaml
secrets:init crée les *.sops.yaml manquants depuis les *.example.yaml (jamais de réécriture)
secrets:pending liste les valeurs encore à CHANGEME (noms de clés uniquement)
secrets:check examples/sops cohérents, aucun CHANGEME, aucune clé en clair suivie
secrets:check-structure garde-fou sans clé (identique à la CI)
secrets:update-keys applique les recipients de .sops.yaml à tous les fichiers
secrets:rotate-cluster-key rotation de la clé du cluster (runbook)
secrets:validate-gitops kustomize build + kubeconform avec des sops factices

Validations par zone

Zone Commande
tout bash scripts/lint.sh (PAD_LINT_FULL=1 ajoute le harnais pytest CTFd)
secrets bash scripts/check-sops.sh, task secrets:check
gitops bash scripts/validate-gitops.sh
tofu tofu fmt -check -recursive, tofu init -backend=false && tofu validate par stack
ansible ansible-lint (profil production)
monitoring bash monitoring/scripts/check.sh
CTFd bash apps/ctfd/scripts/test.sh
Go go test ./... dans apps/netbird-sync et apps/chall-manager-scenario
front pnpm lint && pnpm typecheck && pnpm test && pnpm build, puis Playwright en mode mock (PAD_MOCK=1)
documentation pip install -r docs/requirements.txt && mkdocs build --strict

Construire la documentation

python3 -m venv .venv-docs && . .venv-docs/bin/activate
pip install -r docs/requirements.txt
mkdocs serve                 # http://127.0.0.1:8000, rechargement automatique
mkdocs build --strict        # échoue sur un lien cassé (comme la CI)