バックアップと復元
バックアップは整合したProfileスナップショットを取得します。復元は必ず存在しない新Profileディレクトリへ公開し、ライブデータに重ね書きしません。
バックアップを作る
anyy backup create
既定ではProfileのバックアップ領域へ日時付き名で保存します。別宛先は次です。
anyy backup create --output /secure/path/anyy-backup.tar.gz
Gatewayに到達できれば常駐ランタイムに整合スナップショットを依頼します。オフラインでは、可変状態を読む前に排他的Profile所有権を取得する必要があります。
含まれるもの
設定、Role／Skill、Workspace／メモリ、スケジュール、Channel設定、DBスナップショット、参照された永続オブジェクト／Artifactを含められます。
対象は選択した1Profileで、兄弟Profileや実行ファイルは同梱しません。Profileごとにバックアップします。
一時ランタイムファイルは除外し、シンボリックリンクはProfile外へ追わず拒否します。
管理認証情報ディレクトリは明示的に含める
既定では管理対象secrets/とmcp/oauth/を除外します。Profileシークレットと対応MCP/OAuth資料を含めるには次です。
anyy backup create --include-secrets
このフラグはそのディレクトリだけを制御し、全収録ファイルからシークレットを走査しません。設定とユーザーファイルは内容のまま含むため、config.yamlの直接記述MCP環境値／ヘッダーや、Workspaceなどのシークレットは、--include-secretsなしでも入り得ます。アーカイブ全体の秘匿処理はしません。
暗号化し、アクセスを制限し、通常のファイル共有やissue trackerにアップロードしないでください。管理認証ディレクトリを除外しても、シークレット不在は保証しません。
一覧を表示する
anyy backup list
anyy backup list --json
Profileのバックアップ場所で認識したアーカイブを報告します。独自パスのものも直接指定して復元できます。
安全に復元する
存在しない対象ディレクトリを選びます。
anyy backup restore \
--archive /secure/path/anyy-backup.tar.gz \
--target-home /path/to/new-profile
公開前にマニフェスト、ハッシュ、容量、パス、構造を検証します。隣に一時配置し、必要なインデックスと監査状態を再構築して原子的に公開します。
復元後：
anyy status --home /path/to/new-profile
anyy doctor --home /path/to/new-profile
コマンドとTUIでは復元Homeを明示します。
anyy --home /path/to/new-profile
anyy dashboard --home /path/to/new-profile
Profileのimport/registerコマンドはありません。名前付きProfileへ復元するには、未存在の正規対象BASE_HOME/profiles/NAMEを選んで検証し、anyy --profile-root BASE_HOME profile use NAMEを実行します。先にprofile create NAMEをしないでください。ディレクトリができ、復元が拒否されます。
復旧の規則
- 現在Homeを
--target-homeにしません。 - 既存ディレクトリへ復元しません。
statusとdoctor合格まで元アーカイブを保持します。- 送信Channelや有料プロバイダーを有効にする前に、省略認証を再接続します。
- 定期的に復元テストします。未検証アーカイブはバックアップの試行にすぎません。
トラブルシューティング
| 症状 | 説明 |
|---|---|
| オフラインバックアップ拒否 | ライブプロセスが所有中。常駐経路か停止を使用 |
| 対象が存在すると表示 | 新しい空パスを選ぶ。重ね書き復元は意図的に未対応 |
| ハッシュ／マニフェスト不正 | 迂回せず別の正常アーカイブを使用 |
| 復元後に認証不能 | 管理認証省略か、参照が利用不可の可能性。再接続 |