Aller au contenu
Documentation
Le projet

CLI — Commandes

restore — Restaurer une sauvegarde

Restaurer une sauvegarde.

restore lit une sauvegarde Aède et présente chaque magasin qu’il peut remplacer avant confirmation. Un magasin lisible présent remplace son équivalent actuel. Un magasin absent ou non pris en charge reste intact, jamais supprimé. C’est un remplacement, contrairement aux imports notes/rules qui fusionnent.

Arrêter le serveur pour une récupération réelle. Sauvegarder les données actuelles avant pour revenir en arrière. Pour un essai, utiliser un dossier --data vide distinct et examiner son contenu avant la production. --yes saute volontairement la confirmation.

Restaurer les comptes conserve propriétaires stables et vérificateurs des mots de passe, mais renouvelle l’époque des identifiants pour invalider toutes les anciennes sessions. Les versions 1 et 2, sans comptes, laissent les identifiants existants intacts. Destinations de comptes et archives avec identifiants exigent des permissions Unix privées. Reset préserve aussi les comptes.

La version 4 peut aussi restaurer les règles parentales des administrateurs et les compteurs d’écoute. Cette partie remplace parental.json uniquement si elle est présente et prise en charge ; une ancienne sauvegarde ou une partie parentale absente ou illisible conserve les règles et compteurs actuels. Une règle restaurée s’applique au prochain contrôle authentifié ; la restauration ne lance jamais de lecture. Les réservations conservées restent comptées de manière prudente, et les sessions suivent toujours la règle distincte de restauration des comptes ci-dessus. Les destinations et sauvegardes parentales exigent les mêmes permissions privées que les identifiants.

Le catalogue est une photographie de la date de sauvegarde. Exécuter scan ensuite pour rapprocher musique ajoutée/retirée, toutes les racines accessibles. restore ne récupère pas l’audio absent, non inclus. Un fichier illisible ou sans magasin restaurable est refusé.

Syntaxe et arguments#

aede restore <file>

Exactement un fichier ordinaire de sauvegarde Aède existant ; pas un dossier musical, fichier spécial, CSV ou rapport FlacCompagnon. Les arguments supplémentaires sont refusés.

Options de cette commande#

OptionEffet
--yesAccepter la confirmation demandée par cette commande. Vérifier l’opération auparavant ; réserver aux exécutions automatisées maîtrisées.

La référence des options explique --data, --no-color, --help/-h, --version/-v/-V, valeurs et règles d’export/pagination. Elles ne rendent pas CSV/JSON ou pagination disponibles partout.

Exemples#

aede restore aede-backup.aede --data "/path/to/rehearsal-data"
aede restore aede-backup.aede

Résultat et erreurs#

Avant confirmation, chaque magasin indique remplacement des données actuelles, création ou conservation sans changement. Toutes les destinations incluses sont vérifiées d’abord : liens finaux et fichiers non ordinaires sont refusés, et l’archive d’entrée ne peut pas être un magasin remplacé. Une destination ultérieure déjà invalide laisse donc tous les magasins actuels intacts. Les parties invalides ou non prises en charge sont ignorées individuellement ; les parties compatibles restent restaurables.

Le bilan compte magasins restaurés, date du catalogue sauvegardé et racines absentes sur cette machine. Monter ces racines avant de scanner pour rafraîchir leurs entrées ; une racine temporairement indisponible est conservée sans rafraîchissement. Refuser la confirmation renvoie “nothing was restored” ; bundle illisible ou sans magasin compatible : erreur. Chaque magasin est remplacé atomiquement, mais un échec d’écriture imprévu après une première publication peut encore laisser une restauration partielle. Sauvegarder les données actuelles et arrêter les écritures concurrentes avant ; ce n’est pas une transaction unique pour tous les magasins.

Pour continuer#

backup, scan.

Guide détaillé existant : operating.md.