Sauvegarde et restauration

La sauvegarde Anyy capture un instantané cohérent du profil. La restauration publie toujours dans un nouveau répertoire de profil inexistant ; elle ne recouvre jamais des données actives.

Créer une sauvegarde

anyy backup create

L’archive par défaut est écrite dans l’espace de sauvegarde du profil avec un nom horodaté. Choisissez une autre destination au besoin :

anyy backup create --output /secure/path/anyy-backup.tar.gz

Si le Gateway est joignable, la commande demande à l’environnement résident de créer l’instantané cohérent. Hors ligne, Anyy doit obtenir la propriété exclusive du profil avant de lire l’état modifiable.

Contenu inclus

L’archive peut inclure configuration du profil, fichiers de rôles et Skills, données Workspace et mémoire, planifications, configuration des canaux, instantané de base de données et objets ou artifacts durables référencés.

Une sauvegarde capture un profil sélectionné, sans profils voisins ni exécutable Anyy installé. Sauvegardez chaque profil séparément.

Les fichiers temporaires d’exécution sont exclus. Les liens symboliques sont refusés pour ne pas suivre de contenu hors du profil.

Répertoires d’identifiants gérés sur demande explicite

Par défaut, la sauvegarde omet les répertoires gérés secrets/ et mcp/oauth/. Incluez explicitement les secrets du profil et les données MCP/OAuth compatibles :

anyy backup create --include-secrets

Cette option contrôle ces répertoires gérés sans rechercher de secrets dans tous les fichiers inclus. Configuration et fichiers utilisateur sont inclus avec leur contenu : les valeurs d’environnement/en-têtes MCP en clair dans config.yaml, ou les secrets du Workspace et d’autres fichiers capturés, peuvent entrer dans l’archive même sans --include-secrets. La sauvegarde n’effectue aucun masquage global de l’archive.

Protéger chaque sauvegarde comme des données sensibles

Chiffrez les archives, limitez leur accès et ne les importez pas dans un partage ordinaire ou un outil de suivi des incidents. Omettre les répertoires gérés ne garantit pas une archive sans secrets.

Lister les sauvegardes

anyy backup list
anyy backup list --json

La commande liste les archives reconnues à l’emplacement de sauvegarde du profil. Une archive située ailleurs peut être restaurée en précisant directement son chemin.

Restaurer en sécurité

Choisissez un répertoire cible inexistant :

anyy backup restore \
  --archive /secure/path/anyy-backup.tar.gz \
  --target-home /path/to/new-profile

Avant de publier la cible, la restauration valide manifeste, empreintes de fichiers, espace disponible, chemins et structure d’archive. Elle prépare le résultat à côté de la cible, reconstruit les index et l’état d’audit requis, puis le publie atomiquement.

Après restauration :

anyy status --home /path/to/new-profile
anyy doctor --home /path/to/new-profile

Utilisez explicitement le répertoire restauré pour les commandes et la TUI :

anyy --home /path/to/new-profile
anyy dashboard --home /path/to/new-profile

Aucune commande d’import/enregistrement de profil n’existe. Pour restaurer un profil nommé, choisissez la cible canonique encore inexistante BASE_HOME/profiles/NAME, vérifiez-la puis lancez anyy --profile-root BASE_HOME profile use NAME. Ne lancez pas d’abord profile create NAME : cela crée le répertoire, que la restauration refusera.

Règles de récupération

• Ne choisissez jamais le répertoire actuel du profil comme --target-home.
• Ne restaurez jamais sur un répertoire existant.
• Gardez l’archive source jusqu’à réussite de status et doctor sur le profil restauré.
• Reconnectez les identifiants omis avant d’activer les canaux sortants ou fournisseurs payants.
• Testez périodiquement une restauration ; une archive non testée reste une simple tentative de sauvegarde.

Dépannage

Symptôme	Explication
Sauvegarde hors ligne refusée	Un processus actif possède encore le profil ; utilisez la voie résidente ou arrêtez-le
La cible de restauration existe	Choisissez un nouveau chemin ; la restauration par recouvrement n’est volontairement pas prise en charge
Échec de validation du manifeste ou des empreintes	Ne contournez pas ce contrôle ; utilisez une autre archive fiable
Les fournisseurs restaurés ne s’authentifient pas	La sauvegarde peut avoir omis des identifiants gérés ou dépendre de références indisponibles ; reconnectez-les