Exploitation

Restauration

Remettre une sauvegarde complète dans un bind mount ou un volume nommé.

La restauration remplace les données actives. Arrêtez NasDash, gardez une sauvegarde vérifiée de l’état actuel, identifiez le format de l’archive et utilisez d’abord la même version du produit. Conservez la configuration de secret et l’UID:GID d’exécution. L’interface ne restaure pas les sauvegardes.

Copie NasDash ou archive de l’interface

Une archive .tar.gz de l’interface contient nasdash-backup.json et data/. Extrayez-la d’abord dans un nouveau dossier privé ; une copie CLI possède déjà ce format. Depuis un clone du produit avec Node.js 22, restaurez vers le véritable dossier monté sur l’hôte. --force autorise le remplacement ; la cible existante est renommée en dossier voisin .pre-restore-* pour récupération. Gardez-le jusqu’à validation. --target est nécessaire si les données actives diffèrent du dossier par défaut du clone.

# Interface archive only: extract into a NEW directory
umask 077
mkdir ./backups/nasdash-snapshot
tar -xzf ./backups/nasdash-interface-backup.tar.gz -C ./backups/nasdash-snapshot
docker compose stop nasdash
npm run data:restore -- --from ./backups/nasdash-snapshot --target ./data --force
# Grant the actual runtime UID:GID access to restored files before starting
docker compose start nasdash

Archive brute du montage

Une archive brute créée avec tar -C data . contient directement les fichiers. L’outil de copie ne peut pas la restaurer. Arrêtez NasDash, renommez le dossier actuel, créez une nouvelle cible et extrayez-y l’archive. Ne superposez pas une archive sur un dossier existant : des fichiers ou clés périmés resteraient présents. Rétablissez l’accès du propriétaire et des ACL pour l’identité d’exécution, puis démarrez NasDash.

Volume nommé

Préférez un nouveau volume nommé vide et gardez l’ancien pour revenir en arrière. Cet exemple suppose que nasdash-data-restore est un nouveau volume vide et que l’archive brute a été vérifiée. Pour une archive de l’interface, copiez seulement le contenu du dossier data/ extrait. Changez le montage Compose vers le volume restauré après préparation des permissions. Ne supprimez jamais l’ancien volume avant validation.

docker compose -f docker-compose.named-volume.yml stop nasdash
docker run --rm \
  --volume nasdash-data-restore:/target \
  --volume "$PWD/backups:/backup:ro" \
  alpine sh -c 'tar -xzf /backup/nasdash-data-backup.tar.gz -C /target'

Vérifiez /api/health, la connexion administrateur et les éventuels comptes lecteurs configurés, les pages, services, la topologie, les logos et chaque intégration. En mode public, vérifiez l’accès anonyme selon les permissions du lecteur enregistré. Conservez les anciennes données et la sauvegarde jusqu’au bon fonctionnement de l’instance restaurée. Les réglages restaurés peuvent relancer les sauvegardes planifiées ; vérifiez-les aussi.