From 22629e10435abd964f62552dbde5b462b9a3989c Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 2 May 2026 11:35:02 +0900 Subject: [PATCH] =?UTF-8?q?fix(docs):=20=E3=82=B9=E3=83=8A=E3=83=83?= =?UTF-8?q?=E3=83=97=E3=82=B7=E3=83=A7=E3=83=83=E3=83=88=E5=AF=BE=E8=B1=A1?= =?UTF-8?q?=E3=82=92=20/work=20=E3=81=8B=E3=82=89=20/home/ubuntu=20?= =?UTF-8?q?=E5=85=B1=E9=80=9A=E3=83=9C=E3=83=AA=E3=83=A5=E3=83=BC=E3=83=A0?= =?UTF-8?q?=E3=81=AB=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 実装 (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) --- README.md | 2 +- docs/user/snapshot-guide.md | 6 +++--- docs/user/troubleshooting.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index f405835..a0dbaa5 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ devbaseは、Docker Composeを使った再現性の高い開発環境を提供 - **豊富なツールセット**: Docker CLI、AWS CLI、gcloud SDK、Terraform、Node.js、AI CLIツールがプリインストール - **複数コンテナの並行開発**: `devbase container scale`で既存コンテナを再起動せずにスケール可能 - **データ永続化**: 名前付きボリュームでコンテナ再起動後もデータを保持 -- **スナップショット管理**: `/work` ボリュームの増分バックアップ・復元・世代管理 +- **スナップショット管理**: `/home/ubuntu` 共通ボリュームの増分バックアップ・復元・世代管理 - **環境変数の自動収集**: `devbase env init`でAWS/Git/GCP認証情報を対話的に設定 ## クイックスタート diff --git a/docs/user/snapshot-guide.md b/docs/user/snapshot-guide.md index a1d4d7d..2bf12f5 100644 --- a/docs/user/snapshot-guide.md +++ b/docs/user/snapshot-guide.md @@ -1,6 +1,6 @@ # スナップショットガイド -devbase のスナップショット機能は、コンテナの `/work` ボリュームを増分バックアップし、世代管理と復元を提供します。 +devbase のスナップショット機能は、コンテナの `/home/ubuntu` 共通ボリューム (`devbase_home_ubuntu`) を増分バックアップし、世代管理と復元を提供します。`/work` 配下のプロジェクト作業ファイルはバックアップ対象外なので、重要なファイルは Git に push するか別途バックアップを取ってください。 ## 仕組み @@ -20,7 +20,7 @@ graph LR style D fill:#e8f4e8 ``` -- **フルバックアップ**: `/work` ボリューム全体をアーカイブ +- **フルバックアップ**: `/home/ubuntu` 共通ボリューム全体をアーカイブ - **差分バックアップ**: 前回からの変更分のみをアーカイブ - **圧縮**: zstd `-1 -T0`（圧縮レベル 1、全 CPU コア使用）で高速圧縮 @@ -200,7 +200,7 @@ graph LR #### 復元の安全性 -復元を実行する前に、現在の `/work` ボリュームの状態が `pre-restore-` という名前で自動バックアップされます。 +復元を実行する前に、現在の `/home/ubuntu` 共通ボリュームの状態が `pre-restore-` という名前で自動バックアップされます。 ```bash # 復元前に自動作成されるバックアップ diff --git a/docs/user/troubleshooting.md b/docs/user/troubleshooting.md index a12b404..f9bfc0f 100644 --- a/docs/user/troubleshooting.md +++ b/docs/user/troubleshooting.md @@ -373,10 +373,10 @@ devbase snapshot delete **原因と解決策:** -フルバックアップは `/work` ボリューム全体を圧縮するため、データ量に比例して時間がかかります。 +フルバックアップは `/home/ubuntu` 共通ボリューム全体を圧縮するため、データ量に比例して時間がかかります。 - 差分バックアップ（`--full` なし）を使用すると、変更分のみのため高速です -- 大きな一時ファイルや不要なファイルを `/work` から削除してからバックアップしてください +- 大きな一時ファイルや不要なファイルを `/home/ubuntu` から削除してからバックアップしてください ## 6. ボリューム関連