Passer au contenu principal
Afficher en Markdown

Instantané et restauration

Les instantanés vous permettent de sauvegarder tout ce que Crew connaît et fait (mémoire, tâches planifiées, Skills, configuration, paramètres de l'agent) dans un seul fichier portable. Utilisez-les pour passer à une nouvelle machine, récupérer après un problème ou garder deux instances synchronisées.

Créer un instantané

Depuis la CLI

bash
kirocrew snapshot # → ~/.kiro/crew/snapshots/ kirocrew snapshot ~/my-snapshots --keep 3 # custom dir, prune to 3 kirocrew snapshot --list # list existing snapshots

Ce qui est inclus

ComposantCe qu'il couvre
Mémoirememory.db, memory_index.db, préférences, projets, historique et bibliothèque de connaissances (workspace/memory/ et workspace/knowledge/)
Espace de travailArborescences complètes workspace/ et plan_memory/, y compris les sous-arborescences de mémoire lorsqu'elles sont sélectionnées
Tâches planifiéesToutes les tâches planifiées
ConfigurationParamètres, mappage de session, hooks, chemins de projet/espace de travail
SkillsDéfinitions de Skills personnalisées
NotificationsHistorique des notifications du tableau de bord
Sécuritételemetry_salt seulement. La clé de signature d'audit (sel_hmac.key) n'est jamais incluse; elle est régénérée lors de la restauration afin que les HMAC du journal d'audit restent liés à l'hôte qui les a écrits.

Restaurer à partir d'un instantané

Arrêtez la Gateway avant d'effectuer une restauration. kirocrew restore refuse de s'exécuter lorsqu'une Gateway est à l'écoute, car elle pourrait écraser l'état restauré. Utilisez --force seulement si vous savez que le service à l'écoute sur ce port appartient à une autre instance.

Depuis la CLI

bash
kirocrew stop kirocrew restore snapshot.tar.gz # auto-detect mode kirocrew restore snapshot.tar.gz --components memory,crons # selective kirocrew restore snapshot.tar.gz --dry-run # preview without writing kirocrew restart

Deux modes de restauration

  • Replace: remplace l'état actif par le contenu de l'instantané pour les composants sélectionnés
  • Merge: ajoute les données de l'instantané sans écraser les données déjà présentes

Le mode est détecté automatiquement selon la présence de memory.db à destination : une base existante sélectionne Merge; son absence sélectionne Replace. Remplacez ce choix avec --mode replace ou --mode merge.

Récupération en mode Replace

En mode Replace, Crew déplace l'état qui sera écrasé dans un dossier pre-restore-<timestamp>/ du répertoire de données avant d'appliquer l'instantané. Si la restauration échoue après le début des modifications, Crew tente de rétablir automatiquement l'état précédent. Si cette récupération est incomplète, la commande indique le dossier sauvegardé et les éléments à récupérer manuellement.

Planifier vos propres instantanés

Les instantanés locaux ne sont pas automatiques. Planifiez vous-même kirocrew snapshot --keep 7 si vous voulez des sauvegardes locales régulières, puis vérifiez la création des archives avec kirocrew snapshot --list. AWS Control exécute sa propre sauvegarde hors hôte chaque nuit après sa configuration.

Modèles courants

Passer à une nouvelle machine

bash
# On the source kirocrew snapshot ~/migrate # Copy the tarball to the new machine, then: kirocrew restore ~/migrate/kirocrew-snapshot-*.tar.gz kirocrew doctor

Récupération à un instant précis

bash
kirocrew snapshot --list kirocrew restore ~/.kiro/crew/snapshots/kirocrew-snapshot-2026-08-15.tar.gz --mode replace

Restauration sélective

Vous voulez seulement les tâches planifiées d'un instantané, pas la mémoire?

bash
kirocrew restore snapshot.tar.gz --components crons

Sauvegarde dans le nuage

Pour une sauvegarde continue dans le nuage, utilisez l'application AWS Control. Elle stocke les instantanés dans un compartiment S3 privé, versionné et réservé au propriétaire. Pour en restaurer un, téléchargez l'archive depuis la vue Backup et exécutez kirocrew restore <path> avec le fichier local.

Ce que les instantanés ne couvrent pas

Certains éléments se trouvent en dehors du répertoire de données et ne sont pas inclus :

  • Identifiants kiro-cli — connectez-vous séparément sur la machine cible
  • Identifiants AWS — ~/.aws/*
  • Définitions d'applications Slack/Discord/Telegram — régénérées pour chaque espace de travail
  • Applications installées — leurs fichiers d'état sont couverts, mais le code de l'application doit être réinstallé via l'App Store

Pour une migration complète : instantané + kirocrew setup sur la nouvelle machine + réinstallation des applications.

Page mise à jour : 11 septembre 2026