Skip to content

Commit e1b396b

Browse files
takemi-ohamaclaude
andauthored
fix(docs): スナップショット対象を /work から /home/ubuntu 共通ボリュームに修正 (#8)
実装 (lib/devbase/snapshot/manager.py:17 VOLUME_NAME = 'devbase_home_ubuntu') と異なり、ドキュメントが「/work ボリュームを増分バックアップ」と記載 していたため整合性を失っていた。 PR #6 で README と snapshot-guide.md を「/work」に修正したのは誤り (元の「ホームボリューム」が正しかった)。今回正しい記述に統一する。 修正: - README.md L16: スナップショット対象の表記 - docs/user/snapshot-guide.md L3, L23, L203: 同上 + 「/work 配下はバックアップ対象外」の注記を追加 - docs/user/troubleshooting.md L376, L379: 高速化のヒントの対象パス 参考: スナップショット対象の実装 lib/devbase/snapshot/manager.py: VOLUME_NAME = 'devbase_home_ubuntu' # /home/ubuntu にマウントされる共通ボリューム ユーザ視点では /home/ubuntu が個人設定 / シェル履歴 / SSH 鍵 / AI CLI キャッシュ / VS Code 拡張機能の保存先で、スナップショットは これらを保護する目的。プロジェクト作業ファイル (/work 配下) は Git で管理する前提。 Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent e5f3f35 commit e1b396b

3 files changed

Lines changed: 6 additions & 6 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ devbaseは、Docker Composeを使った再現性の高い開発環境を提供
1313
- **豊富なツールセット**: Docker CLI、AWS CLI、gcloud SDK、Terraform、Node.js、AI CLIツールがプリインストール
1414
- **複数コンテナの並行開発**: `devbase container scale`で既存コンテナを再起動せずにスケール可能
1515
- **データ永続化**: 名前付きボリュームでコンテナ再起動後もデータを保持
16-
- **スナップショット管理**: `/work` ボリュームの増分バックアップ・復元・世代管理
16+
- **スナップショット管理**: `/home/ubuntu` 共通ボリュームの増分バックアップ・復元・世代管理
1717
- **環境変数の自動収集**: `devbase env init`でAWS/Git/GCP認証情報を対話的に設定
1818

1919
## クイックスタート

docs/user/snapshot-guide.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# スナップショットガイド
22

3-
devbase のスナップショット機能は、コンテナの `/work` ボリュームを増分バックアップし、世代管理と復元を提供します。
3+
devbase のスナップショット機能は、コンテナの `/home/ubuntu` 共通ボリューム (`devbase_home_ubuntu`) を増分バックアップし、世代管理と復元を提供します`/work` 配下のプロジェクト作業ファイルはバックアップ対象外なので、重要なファイルは Git に push するか別途バックアップを取ってください
44

55
## 仕組み
66

@@ -20,7 +20,7 @@ graph LR
2020
style D fill:#e8f4e8
2121
```
2222

23-
- **フルバックアップ**: `/work` ボリューム全体をアーカイブ
23+
- **フルバックアップ**: `/home/ubuntu` 共通ボリューム全体をアーカイブ
2424
- **差分バックアップ**: 前回からの変更分のみをアーカイブ
2525
- **圧縮**: zstd `-1 -T0`(圧縮レベル 1、全 CPU コア使用)で高速圧縮
2626

@@ -200,7 +200,7 @@ graph LR
200200

201201
#### 復元の安全性
202202

203-
復元を実行する前に、現在の `/work` ボリュームの状態が `pre-restore-<timestamp>` という名前で自動バックアップされます。
203+
復元を実行する前に、現在の `/home/ubuntu` 共通ボリュームの状態が `pre-restore-<timestamp>` という名前で自動バックアップされます。
204204

205205
```bash
206206
# 復元前に自動作成されるバックアップ

docs/user/troubleshooting.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -373,10 +373,10 @@ devbase snapshot delete <name>
373373

374374
**原因と解決策:**
375375

376-
フルバックアップは `/work` ボリューム全体を圧縮するため、データ量に比例して時間がかかります。
376+
フルバックアップは `/home/ubuntu` 共通ボリューム全体を圧縮するため、データ量に比例して時間がかかります。
377377

378378
- 差分バックアップ(`--full` なし)を使用すると、変更分のみのため高速です
379-
- 大きな一時ファイルや不要なファイルを `/work` から削除してからバックアップしてください
379+
- 大きな一時ファイルや不要なファイルを `/home/ubuntu` から削除してからバックアップしてください
380380

381381
## 6. ボリューム関連
382382

0 commit comments

Comments
 (0)