docs: ホームボリュームのマウント先を /persistent/ai に修正し AI 設定永続化を明文化#78
Merged
Conversation
ドキュメントが実装と乖離していた点を是正する。
## 修正内容
1. マウント先の誤り訂正 (/home/ubuntu → /persistent/ai)
- devbase_home_ubuntu ボリュームは /persistent/ai にマウントされる
(lib/devbase/volume/compose.py:13-14 で /home/ubuntu は _DEPRECATED_TARGET
として除去、/persistent/ai にマップ)。
- /home/ubuntu 直下はコンテナ層(揮発)で、永続化されるのは entrypoint が
/persistent/ai 配下へ symlink する設定のみ。「シェル履歴等も永続」という
記述は誤りだったため訂正。
- 対象: container-operations.md / compose-yml-guidelines.md /
quickstart.md / snapshot-guide.md / troubleshooting.md / README.md
2. AI 設定の永続化を明文化 (container-operations.md に新セクション)
- symlink 機構と対象一覧 (.claude / .codex / .gemini / .serena / .ssh /
.kiro / share) を記載。PR #77 で追加した .kiro / share を反映。
- share が全コンテナ共有のファイル置き場であること、DEVBASE_WORKSPACE との
関連を追記。
3. rebuild / --no-cache の説明訂正 (README.md)
- 「devbase rebuild で docker compose build --no-cache 相当」は誤り。
rebuild は build --expires=7 で齢ゲート付き。無条件 no-cache は
devbase build --no-cache であることを明記。
4. entrypoint/Dockerfile 変更時の再ビルド注記 (cli-reference.md)
- devbase up はイメージ齢 7 日未満だと再ビルドをスキップするため、
entrypoint 変更は build --no-cache が必要な旨を追記。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
takemi-ohama
commented
Jun 27, 2026
takemi-ohama
left a comment
Contributor
Author
There was a problem hiding this comment.
🤖 cross-review | round 1 | codex | APPROVE
修正必須の指摘はありません。
takemi-ohama
commented
Jun 27, 2026
takemi-ohama
left a comment
Contributor
Author
There was a problem hiding this comment.
🤖 cross-review | round 1 | gemini | APPROVE
ドキュメントの更新内容を確認しました。コードの実装(/persistent/ai へのマウント先変更、entrypoint.sh での symlink 構築、build / rebuild の挙動)とすべてのドキュメントが完全に一致しており、不整合や誤りはありません。特に修正が必要な点はありません。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
PR #77(
.kiro/share追加・DEVBASE_WORKSPACE)に関連してドキュメント整合性を調査したところ、実装と乖離した記述が複数見つかったため是正する。乖離自体は一部 #77 以前から存在していた既存バグを含む。背景(実装の事実)
実コンテナ・コードで確認:
devbase_home_ubuntuボリュームは/persistent/aiにマウントされる(docker inspectで確認)。lib/devbase/volume/compose.py:13-14で/home/ubuntuは_DEPRECATED_TARGETとして除去され、/persistent/aiにマップされる。/home/ubuntu直下は overlay(揮発するコンテナ層)。永続化されるのは entrypoint(containers/base/entrypoint.sh)が/persistent/ai配下へ symlink する設定群(.claude/.codex/.gemini/.serena/.ssh/.claude.json/.kiro/share)のみ。devbase_home_ubuntu)でバックアップするため、対象実体は/persistent/aiの内容。修正内容
マウント先の誤り訂正(
/home/ubuntu→/persistent/ai)container-operations.md/compose-yml-guidelines.md/quickstart.md/snapshot-guide.md/troubleshooting.md/README.md。「シェル履歴等も永続」という誤記も訂正(symlink 対象外は揮発)。AI 設定の永続化を明文化(
container-operations.mdに新セクション)symlink 機構・対象一覧・PR feat(up): DEVBASE_WORKSPACE で VS Code ワークスペースを開く + 共有ディレクトリ (share/.kiro) 追加 #77 で追加した
.kiro/share・shareが全コンテナ共有置き場である点・DEVBASE_WORKSPACEとの関連を記載。rebuild/--no-cacheの説明訂正(README.md)「
devbase rebuildでdocker compose build --no-cache相当」は誤り。rebuildはbuild --expires=7(齢ゲート付き)。無条件 no-cache はdevbase build --no-cache。entrypoint/Dockerfile 変更時の再ビルド注記(
cli-reference.md)devbase upはイメージ齢 7 日未満だと再ビルドをスキップするため、entrypoint 変更時はbuild --no-cacheが必要な旨を追記。補足
containers/base/Dockerfile:161のCOPY entrypoint.sh /entrypoint.shにより焼き込まれており実機でもbuild --no-cacheが必要だった。本 PR はその訂正も反映している。🤖 Generated with Claude Code