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 ツールがエイリアスとして利用可能です。 | エイリアス | ツール | モード | 説明 | |-----------|-------|--------|------|