Skip to content

docs: ホームボリュームのマウント先を /persistent/ai に修正し AI 設定永続化を明文化#78

Merged
takemi-ohama merged 1 commit into
mainfrom
docs/fix-home-volume-and-ai-persistence
Jun 27, 2026
Merged

docs: ホームボリュームのマウント先を /persistent/ai に修正し AI 設定永続化を明文化#78
takemi-ohama merged 1 commit into
mainfrom
docs/fix-home-volume-and-ai-persistence

Conversation

@takemi-ohama

Copy link
Copy Markdown
Contributor

概要

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のみ
  • snapshot はボリューム名(devbase_home_ubuntu)でバックアップするため、対象実体は /persistent/ai の内容。

修正内容

  1. マウント先の誤り訂正(/home/ubuntu/persistent/ai
    container-operations.md / compose-yml-guidelines.md / quickstart.md / snapshot-guide.md / troubleshooting.md / README.md。「シェル履歴等も永続」という誤記も訂正(symlink 対象外は揮発)。

  2. AI 設定の永続化を明文化container-operations.md に新セクション)
    symlink 機構・対象一覧・PR feat(up): DEVBASE_WORKSPACE で VS Code ワークスペースを開く + 共有ディレクトリ (share/.kiro) 追加 #77 で追加した .kiro / shareshare が全コンテナ共有置き場である点・DEVBASE_WORKSPACE との関連を記載。

  3. rebuild / --no-cache の説明訂正README.md
    devbase rebuilddocker compose build --no-cache 相当」は誤り。rebuildbuild --expires=7(齢ゲート付き)。無条件 no-cache は devbase build --no-cache

  4. entrypoint/Dockerfile 変更時の再ビルド注記cli-reference.md
    devbase up はイメージ齢 7 日未満だと再ビルドをスキップするため、entrypoint 変更時は build --no-cache が必要な旨を追記。

補足

  • 調査時のサブエージェントが「entrypoint.sh は Dockerfile に含まれないので rebuild 不要」と誤結論したが、containers/base/Dockerfile:161COPY entrypoint.sh /entrypoint.sh により焼き込まれており実機でも build --no-cache が必要だった。本 PR はその訂正も反映している。
  • コード変更なし(docs のみ)。

🤖 Generated with Claude Code

ドキュメントが実装と乖離していた点を是正する。

## 修正内容

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 takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | codex | APPROVE

修正必須の指摘はありません。

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | gemini | APPROVE

ドキュメントの更新内容を確認しました。コードの実装(/persistent/ai へのマウント先変更、entrypoint.sh での symlink 構築、build / rebuild の挙動)とすべてのドキュメントが完全に一致しており、不整合や誤りはありません。特に修正が必要な点はありません。

@takemi-ohama takemi-ohama merged commit 8833481 into main Jun 27, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant