From 8cd4253a9fb18d949e437fd19147107d35e2418d Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Tue, 6 Oct 2026 07:16:18 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=E3=82=A4=E3=83=A1=E3=83=BC=E3=82=B8?= =?UTF-8?q?=E3=81=AE=E8=A1=A8=E3=81=A8=E5=9B=B3=E3=81=AE=E7=B6=99=E6=89=BF?= =?UTF-8?q?=E5=85=83=E3=82=92=E5=90=84=20Dockerfile=20=E3=81=AE=20FROM=20?= =?UTF-8?q?=E3=81=AB=E5=90=88=E3=82=8F=E3=81=9B=E3=82=8B=EF=BC=88#251?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - php / php85 / latex は base を継ぐ。図と表を general の下から base の下へ移す - general は base に何も足さない。AWS CLI・gcloud・Node.js（LTS）・AI CLI は base の内容として書き、 Terraform と Node.js 20 の記述を外す。terraform は標準イメージに無いことと入れ方への案内を足す - AI CLI のエイリアスは base 以降で使えると書く - イメージ選択の図はクラウド CLI の有無で base と general を分けない。plugin-dev の表に browser を足す - bi-tools / trygroup は特定のプロジェクト用のイメージとして表の外に注記する Co-Authored-By: Claude Opus 5.5 --- docs/plugin-dev/compose-yml-guidelines.md | 18 ++++++++++------- docs/plugin-dev/quickstart.md | 14 ++++++++----- docs/user/container-operations.md | 24 ++++++++++++++--------- 3 files changed, 35 insertions(+), 21 deletions(-) diff --git a/docs/plugin-dev/compose-yml-guidelines.md b/docs/plugin-dev/compose-yml-guidelines.md index 72d3a594..05459b6a 100644 --- a/docs/plugin-dev/compose-yml-guidelines.md +++ b/docs/plugin-dev/compose-yml-guidelines.md @@ -144,21 +144,25 @@ flowchart TD Q1{主な開発言語は?} Q1 -->|Go| IMG_GO["go"] Q1 -->|PHP| IMG_PHP["php"] - Q1 -->|Python/Node.js/汎用| Q2{クラウドCLIは必要?} + Q1 -->|Python/Node.js/汎用| IMG_GENERAL["general"] Q1 -->|LaTeX/文書作成| IMG_LATEX["latex"] - Q2 -->|Yes| IMG_GENERAL["general"] - Q2 -->|No| IMG_BASE["base"] + Q1 -->|ブラウザの操作・HTML の PDF 化| IMG_BROWSER["browser"] ``` | イメージ | ベース | 主要ツール | 典型的な用途 | |---------|--------|-----------|-------------| -| `base` | Ubuntu 26.04 | Docker CLI、Python 3 | 軽量な自動化・スクリプト | -| `general` | base | AWS CLI、gcloud、Terraform、Node.js 20、AI CLI | Webアプリ、インフラ管理 | +| `base` | Ubuntu 26.04 | Docker CLI、Python 3、AWS CLI、gcloud、Node.js（LTS）、AI CLI | 派生イメージの土台 | +| `general` | base | base のまま（道具を足さない） | Webアプリ、インフラ管理 | | `go` | base | Go開発環境 | APIサーバー、CLIツール | -| `php` | general | PHP 8.5、Composer | Laravel、WordPress | -| `latex` | general | LaTeX | 論文、技術文書、レポート | +| `php` | base | PHP 8.5、Composer | Laravel、WordPress | +| `latex` | base | LaTeX | 論文、技術文書、レポート | +| `browser` | base | Playwright の Chromium、追加の太さのフォント | ブラウザの操作、HTML の PDF・スクリーンショット | | `snapshot` | Ubuntu 26.04 | zstd | スナップショットの取得・復元 | +どの派生イメージも base を継ぐため、AWS CLI・gcloud・AI CLI はどれを選んでも使えます。 +terraform はどの標準イメージにも入っていません（入れ方は +[コンテナ操作ガイド](../user/container-operations.md#ブラウザ追加の太さのフォントterraform-を使う)）。 + ### 4.2 標準イメージの使用 標準イメージを使用する場合は、`containers/` ディレクトリ内のDockerfileを参照します。 diff --git a/docs/plugin-dev/quickstart.md b/docs/plugin-dev/quickstart.md index 6b558713..9ceb366d 100644 --- a/docs/plugin-dev/quickstart.md +++ b/docs/plugin-dev/quickstart.md @@ -333,14 +333,18 @@ flowchart LR | イメージ | ベース | 主要ツール | 推奨用途 | |---------|--------|-----------|---------| -| `base` | Ubuntu 26.04 | Docker CLI、Python 3 | 軽量な開発環境 | -| `general` | base | AWS CLI、gcloud、Terraform、Node.js 20、AI CLI | 汎用開発 | +| `base` | Ubuntu 26.04 | Docker CLI、Python 3、AWS CLI、gcloud、Node.js（LTS）、AI CLI | 派生イメージの土台 | +| `general` | base | base のまま（道具を足さない） | 汎用開発 | | `go` | base | Go開発環境 | Go言語プロジェクト | -| `php` | general | PHP 8.5、Composer | PHP 8.5 系プロジェクト | -| `php85` | general | PHP 8.5、Composer | PHP 8.5 系プロジェクト | -| `latex` | general | LaTeX | 文書・論文作成 | +| `php` | base | PHP 8.5、Composer | PHP 8.5 系プロジェクト | +| `php85` | base | PHP 8.5、Composer | PHP 8.5 系プロジェクト | +| `latex` | base | LaTeX | 文書・論文作成 | +| `browser` | base | Playwright の Chromium、追加の太さのフォント | ブラウザの操作、HTML の PDF・スクリーンショット | | `snapshot` | Ubuntu 26.04 | zstd | スナップショット専用 | +terraform はどの標準イメージにも入っていません（入れ方は +[コンテナ操作ガイド](../user/container-operations.md#ブラウザ追加の太さのフォントterraform-を使う)）。 + ### 5.5 Git管理のガイドライン ``` diff --git a/docs/user/container-operations.md b/docs/user/container-operations.md index f166d996..ae049bf5 100644 --- a/docs/user/container-operations.md +++ b/docs/user/container-operations.md @@ -387,9 +387,9 @@ graph TD B --> C[general] B --> G[go] B --> J[browser] - C --> D[php] - C --> I[php85] - C --> E[latex] + B --> D[php] + B --> I[php85] + B --> E[latex] A --> H[snapshot] style A fill:#f0f0f0 @@ -403,15 +403,21 @@ graph TD | イメージ | ベース | 主な内容 | 用途 | |---------|-------|---------|------| -| **base** | Ubuntu 26.04 | Docker CLI、Python 3、日本語フォント、PDF / OOXML の道具、shellcheck | 最小限の開発環境 | -| **general** | base | AWS CLI、gcloud、Node.js 20、AI CLI | 汎用開発環境 | -| **php** | general | PHP 8.5、Composer、MySQL Shell | PHP 8.5 系 開発 | -| **php85** | general | PHP 8.5、Composer、MySQL Shell | PHP 8.5 系 開発 | -| **latex** | general | LaTeX | 文書作成 | +| **base** | Ubuntu 26.04 | Docker CLI、Python 3、AWS CLI、gcloud、Node.js（LTS）、AI CLI、日本語フォント、PDF / OOXML の道具、shellcheck | 汎用開発環境の土台 | +| **general** | base | base のまま（道具を足さない） | 汎用開発環境 | +| **php** | base | PHP 8.5、Composer、MySQL Shell | PHP 8.5 系 開発 | +| **php85** | base | PHP 8.5、Composer、MySQL Shell | PHP 8.5 系 開発 | +| **latex** | base | LaTeX | 文書作成 | | **go** | base | Go 開発環境 | Go 開発 | | **browser** | base | Playwright の Chromium とその依存パッケージ、Noto CJK の追加の太さ（Thin〜Black） | ブラウザの操作、HTML の PDF・スクリーンショット | | **snapshot** | Ubuntu 26.04 | zstd のみ（約 80MB） | スナップショット専用 | +派生イメージはどれも base を継ぐため、AWS CLI・gcloud・Node.js・AI CLI はどの派生イメージでも +使えます。terraform はどの標準イメージにも入っていません（入れ方は +[ブラウザ・追加の太さのフォント・terraform を使う](#ブラウザ追加の太さのフォントterraform-を使う)）。 +`containers/` にはこのほか、特定のプロジェクト用のイメージ（`bi-tools` / `trygroup`）があり、 +どちらも base を継ぎます。 + ### 文字の描画と、文書を扱う道具（base 以降） base イメージは、文字を描くときの既定を**日本語**にしています。総称ファミリ（`sans-serif` / @@ -555,7 +561,7 @@ bash-language-server などの言語サーバは Bash の診断を `shellcheck` ### AI CLI エイリアス -general イメージ以降のコンテナ内では、以下の AI CLI ツールがエイリアスとして利用可能です。 +base イメージ以降（snapshot を除くすべての標準イメージ）のコンテナ内では、以下の AI CLI ツールがエイリアスとして利用可能です。 | エイリアス | ツール | モード | 説明 | |-----------|-------|--------|------|