Sauvegardes et export

2 mécanismes complémentaires : backups automatisés stockés sur Nextcloud (long-terme), et exports téléchargeables à la demande (migration / récupération rapide).

Backups Nextcloud

Backup complet d'un site : compose + volumes Docker + dumps SQL des DBs attachées, uploadé sur Nextcloud WebDAV.

Créer un backup manuel

1. Détail site → section Backups → Backup now
2. Ou via API : POST /api/v1/sites/<id>/backups

Ce qui est backupé

• docker-compose.yml du site
• MANIFEST.json avec métadonnées (site_id, slug, runtime, timestamp)
• Contenu du dossier /opt/iridflow/<projet>/<site>/ (sans node_modules, .next, vendor, .git)
• Volumes Docker du site (tarés depuis un container helper alpine, pas de sudo)
• Dumps SQL des DBs attachées (mariadb-dump, pg_dump)

Combien de temps elles sont gardées

Trente jours par défaut. Chaque ligne de la section Backups affiche sa date d'expiration : passée cette date, la sauvegarde est effacée et n'est plus restaurable. Ce qui doit être gardé plus longtemps doit sortir par un export téléchargeable.

Backup automatique quotidien

Toggle par site : cron interne 03:00 UTC chaque nuit qui :

• Boucle sur les sites auto_backup=true (skip si dernier backup < 20h)
• Crée un backup scheduled
• Purge les backups expirés (row DB + fichier Nextcloud) selon IRIDFLOW_BACKUPS_RETENTION_DAYS (30j default)

Activation : détail site → Backups → checkbox Backup automatique quotidien. Ou :

set_backup_schedule({ site_id: "site_xxx", enabled: true })
// ou
PATCH /api/v1/sites/site_xxx/backup-schedule
Body: {"enabled": true}

List / Delete

list_backups({ site_id: "site_xxx" })      // par site
list_backups({})                             // tous (admin only)
delete_backup({ backup_id: "bak_xxx" })      // row DB + fichier Nextcloud

delete_backup supprime aussi le fichier Nextcloud en best-effort (WebDAV DELETE). Un delete_site cascade tous ses backups (Nextcloud + DB) automatiquement.

Restaurer

Restaurer remet le site dans l'état de la sauvegarde choisie : le site est arrêté, ses données sont remplacées par celles de la sauvegarde, puis il redémarre. Tout ce qui a été écrit depuis est perdu, sans retour arrière possible.

Le chemin dans l'interface, la confirmation demandée et le détail de ce que tu perds sont sur la page Restaurer une sauvegarde.

Export téléchargeable (V1)

Alternative au backup Nextcloud : génère un tarball local avec URL signée valide 24h. Idéal pour migration rapide, dev local, audit code.

Générer un export

1. Détail site → section Export téléchargeable → Générer un export
2. Ou via API : POST /api/v1/sites/<id>/export

Retour :

{
  "token": "a8e9006e9bd406a7b7eefca27274f2e8f73f98ceb78741ae",
  "download_url": "https://mcp.iridflow.com/api/v1/exports/<token>/download",
  "size_bytes": 9269,
  "size_mb": "0.01",
  "has_sql_dump": false,
  "sql_dbs": [],
  "expires_at": "2026-08-30T22:10:45.591Z",
  "ttl_hours": 24
}

Contenu du tarball

• MANIFEST.json : métadonnées site
• code.tar.gz : sources du site (sans node_modules/.next/vendor/.git/__pycache__)
• sql/<db-slug>.sql : dumps SQL des DBs attachées (best-effort)

URL de download

• Route publique authentifiée par le token dans l'URL (32 hex bytes = auth crypto)
• TTL 24h, purge auto via systemd timer iridflow-exports-cleanup.timer
• Peut être téléchargée depuis n'importe quel navigateur / curl / wget

Backups vs Export : lequel utiliser