Sauvegarde et restauration¶
task backup sauvegarde les deux sources de données de la plateforme : la base MariaDB de CTFd et les buckets
Garage (ctfd-uploads pour les fichiers de challenges, backups pour les sauvegardes planifiées de
mariadb-operator). Une réplication vers un S3 externe est optionnelle mais recommandée.
Ce qui est couvert (et ce qui ne l'est pas)¶
| Donnée | Sauvegardée par | Où |
|---|---|---|
| Comptes, équipes, scores, soumissions CTFd | task backup (dump MariaDB) |
<dir>/mariadb/<horodatage>/ctfd.sql.gz[.age] |
| Fichiers de challenges | task backup (copie rclone de Garage) |
<dir>/garage/<bucket>/ |
| Base d'Authentik (PostgreSQL) | timer authentik-backup dans le LXC |
/var/backups/authentik/ (dans le LXC, à copier hors machine) |
| Configuration de la plateforme | Git (code) + SOPS (secrets) | dépôt, clés age |
| State OpenTofu | rien d'automatique | .state/tofu : à sauvegarder avec sa passphrase |
| Dashboards, règles | Git | monitoring/ |
| Métriques et logs historiques | rien | perdus à la destruction |
<dir> vaut PAD_BACKUP_DIR (défaut .state/backups, ignoré par Git) sur le poste opérateur.
Sauvegarder¶
Le dump est écrit en *.partial puis renommé (jamais de fichier tronqué), accompagné de son empreinte .sha256. Les
14 derniers dumps sont gardés (PAD_BACKUP_KEEP). La copie Garage est incrémentale et ne supprime jamais.
Clé S3 : backup.sh et restore.sh lisent le Secret garage-s3-credentials. S'il contient la clé de sauvegarde dédiée (backup_access_key_id, facultative, voir Secrets), elle sert pour le bucket backups
(le seul où elle a des droits) et la clé principale pour ctfd-uploads ; sinon la clé principale sert pour les deux. Une erreur 403 sur backups signifie que la clé dédiée est dans le Secret mais pas encore importée dans Garage
(relancer la synchronisation ArgoCD, le Job garage-init s'en charge).
Chiffrer le dump¶
Un dump contient des données personnelles (e-mails des joueurs) et des empreintes de mots de passe de comptes locaux. Le chiffrer avant tout stockage hors du poste :
export PAD_BACKUP_AGE_RECIPIENT="age1...clé-publique" # une clé publique ; la privée reste hors du dépôt
task backup
Export vers un S3 externe¶
Définir PAD_BACKUP_S3_ENDPOINT, PAD_BACKUP_S3_BUCKET, PAD_BACKUP_S3_ACCESS_KEY_ID et
PAD_BACKUP_S3_SECRET_ACCESS_KEY (et PAD_BACKUP_S3_REGION, PAD_BACKUP_S3_PREFIX), ou créer le secret chiffré
secrets/backup-s3.sops.yaml (task secrets:init -- --all). Sans configuration, l'étape est ignorée sans erreur.
Automatiser¶
Aucune planification n'est installée : lancer task backup avant chaque opération risquée et, pendant un événement,
depuis un cron ou un timer du poste opérateur. Les sauvegardes planifiées de mariadb-operator (ressource Backup
du cluster) écrivent dans le bucket Garage backups, couvert par la copie ci-dessus.
Vérifier une sauvegarde¶
Une sauvegarde jamais testée n'est pas une sauvegarde.
cd .state/backups/mariadb/<horodatage>
sha256sum -c ctfd.sql.gz.sha256
zcat ctfd.sql.gz | head -20 # (ou : age -d -i <identité> ctfd.sql.gz.age | zcat | head -20)
Un test de restauration complet se fait sur un cluster de test ou après un rebuild.
Restaurer¶
task restore # dernier dump local, MariaDB + Garage
task restore -- --stamp 20261016T120000Z --only mariadb
task restore -- --from external # rapatrie d'abord depuis le S3 externe
Opération destructive
La restauration écrase la base ctfd (le dump contient DROP DATABASE) et recopie les objets Garage.
Elle demande de taper restore (ou --yes, ou PAD_RESTORE_CONFIRM=restore).
Le script vérifie l'empreinte, déchiffre si besoin (PAD_BACKUP_AGE_IDENTITY = fichier d'identité age), importe dans le
pod MariaDB, puis redémarre le Deployment ctfd pour vider connexions et caches.
Sur un cluster neuf¶
- Laisser ArgoCD terminer la synchronisation : MariaDB et Garage doivent être
Ready, et le Jobgarage-initdoit avoir créé les buckets (kubectl -n storage get pods,kubectl -n ctfd get mariadb). task restore.- Vérifier la connexion au front, le scoreboard et le téléchargement d'un fichier de challenge.
- Les instances de challenges ne sont pas restaurées : les joueurs les relancent.
Authentik¶
Voir Authentik pour restaurer PostgreSQL depuis /var/backups/authentik. Sans cette sauvegarde, la
configuration reste reconstructible (stack 30-authentik), mais les comptes des joueurs sont perdus.