Repository navigation
container-operations.md の「イメージの詳細」の表のベース列が実際の FROM と違う #251
Description
何を見つけたか
利用者とプラグインの作者向けの文書のイメージの表・図が、各 Dockerfile と合っていない。
| イメージ | 文書の記述 | 実際 |
|---|---|---|
| php | ベース general | FROM devbase-base:latest |
| php85 | ベース general | FROM devbase-base:latest |
| latex | ベース general | FROM devbase-base:latest |
| bi-tools | （行が無い） | FROM devbase-base:latest |
| trygroup | （行が無い） | FROM devbase-base:latest |
| general の主な内容 | AWS CLI・gcloud・Terraform・Node.js 20・AI CLI | general は FROM devbase-base:latest だけで何も足さない。AWS CLI・gcloud・Node.js（LTS）・AI CLI は base にある。terraform はどの標準イメージにも無い（#402。入れ方は docs/user/container-operations.md の「ブラウザ・追加の太さのフォント・terraform を使う」） |
確かめ方: grep -H '^FROM' containers/*/Dockerfile と containers/base/Dockerfile / containers/general/Dockerfile の中身。
$ grep -h '^FROM' containers/{php,php85,latex}/Dockerfile
FROM devbase-base:latest
FROM devbase-base:latest
FROM devbase-base:latest
どこにあるか
| 場所 | 内容 |
|---|---|
docs/user/container-operations.md:385-401 |
イメージ階層の mermaid 図。php / php85 / latex を general の下に描く |
docs/user/container-operations.md:403-414 |
「### イメージの詳細」の表。php / php85 / latex のベースを general、general の主な内容を AWS CLI・gcloud・Node.js 20・AI CLI とする |
docs/user/container-operations.md:559 |
「general イメージ以降のコンテナ内では AI CLI がエイリアスとして使える」。エイリアスは base の /etc/devbase/ai-cli-aliases.sh（containers/base/Dockerfile:247）にあり、base 以降で使える |
docs/plugin-dev/compose-yml-guidelines.md:142-151 |
イメージ選択の mermaid 図。「クラウドCLIは必要?」で No なら base、Yes なら general へ分ける。クラウド CLI は base にある |
docs/plugin-dev/compose-yml-guidelines.md:153-161 |
イメージの表。general の主要ツールを AWS CLI・gcloud・Terraform・Node.js 20・AI CLI とし、php / latex のベースを general とする |
docs/plugin-dev/quickstart.md:333-343 |
同じ形のイメージの表。php / php85 / latex を general 系とし、general に Terraform を書く |
「Node.js 20」の記述も合っていない。base は setup_lts.x（containers/base/Dockerfile:59）で LTS を追っており、20 に固定していない。
表に足す行の扱い:
| 行 | 扱い |
|---|---|
| bi-tools / trygroup | 特定のプロジェクト用のイメージ（各 Dockerfile の冒頭に用途のプロジェクトを書いている）。標準イメージの表に載せるかは決まっていない（#294 は扱いを決めずに閉じた）。着手のときに決める |
| browser | docs/user/container-operations.md の表と図にはある。docs/plugin-dev/ の 2 つの表には無い。プラグインの作者がブラウザを使うときの選択肢として足すかを着手のときに決める |
受け入れ条件
- 図と表の継承元が
containers/*/DockerfileのFROMと一致する - general の主な内容が、base に何も足さないことと合っている（Terraform を書かない、Node.js は LTS）
- 「general 以降」を前提にした記述（AI CLI のエイリアスなど）が実際の中身と合っている
- イメージ選択の図が、クラウド CLI の有無で base と general を分けない
直さないと何が起きるか
利用者が AWS CLI や AI CLI のために general が要ると思い込む。terraform が general にあると読んで、入れずに使おうとする。
依存
なし。
由来
issue #249 の実装中に見つけた。#413（スプリント m7c の確定仕様化 #412 で見つけた同じ食い違い）をここへ寄せた。
進行
モード: —
- 要求と受け入れ条件
- 作業場所の用意 — 2026-10-06 06:32
- 設計
- 素材の収集と出典の確定
- ドキュメント再構成
- ドキュメントレビュー
- 計画 — 2026-10-06 06:31
- 実装 — 2026-10-06 07:15
- 構造改善 — 2026-10-06 07:21
- 実装レビュー — 2026-10-06 07:33
- 完了判定 — 2026-10-06 07:16
- Pull Request — 2026-10-06 07:18
- 確定仕様化
- 後片付け
- 配布 — 2026-10-06 12:59
- 体裁レビュー
- リリース後テスト — 2026-10-06 12:59
- 振り返り — 2026-10-06 14:55
- 棚卸し — 2026-10-06 20:16
振り返り: #432 (comment)
Activity
Merge pull request #431 from devbasex/feat/issue-251-m7e