From 3021dcd8c9a8ca76f62a491f3c3c9a9386bbde0e Mon Sep 17 00:00:00 2001 From: masatoshi-kameyama Date: Tue, 16 Jul 2024 18:53:51 +0900 Subject: [PATCH] =?UTF-8?q?Lagoon=E5=8C=96=20Docker=E3=82=A4=E3=83=A1?= =?UTF-8?q?=E3=83=BC=E3=82=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/ja/docker-images/commons.md | 18 ++-- docs/ja/docker-images/mariadb.md | 69 +++++++------- docs/ja/docker-images/mongodb.md | 10 +- docs/ja/docker-images/mysql.md | 93 +++++++++++++++++++ docs/ja/docker-images/nginx.md | 47 +++++----- docs/ja/docker-images/nodejs.md | 44 ++++----- docs/ja/docker-images/opensearch.md | 12 ++- docs/ja/docker-images/php-cli.md | 32 +++---- docs/ja/docker-images/php-fpm.md | 136 ++++++++++++++-------------- docs/ja/docker-images/postgres.md | 19 ++-- docs/ja/docker-images/python.md | 34 +++---- docs/ja/docker-images/rabbitmq.md | 36 ++++---- docs/ja/docker-images/redis.md | 86 +++++++++--------- docs/ja/docker-images/ruby.md | 15 +-- docs/ja/docker-images/solr.md | 24 ++--- docs/ja/docker-images/varnish.md | 43 ++++----- 16 files changed, 407 insertions(+), 311 deletions(-) create mode 100644 docs/ja/docker-images/mysql.md diff --git a/docs/ja/docker-images/commons.md b/docs/ja/docker-images/commons.md index c02ecaec46..12985752ca 100644 --- a/docs/ja/docker-images/commons.md +++ b/docs/ja/docker-images/commons.md @@ -1,17 +1,17 @@ # Commons -[Lagoon `commons` Dockerイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/commons)。[公式のAlpineイメージ](https://hub.docker.com/_/alpine/)を基にしています。 +[Lagoon `commons` Dockerイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/commons)。[公式のAlpineイメージ](https://hub.docker.com/_/alpine/)をベースにしています。 -このイメージ自体には機能はありませんが、代わりに基本イメージであり、他のイメージを構築するために拡張して利用されることを目的としています。Lagoonのすべてのalpineベースのイメージは、共有リソースからコンポーネントを継承しています。 +このイメージ自体は機能を持ちません。代わりに、他のイメージをビルドするための基本イメージとして使用されます。Lagoon内のすべてのalpineベースのイメージは、commonsからコンポーネントを継承しています。 -## 含まれるツール +## ツール -- `docker-sleep` - 標準化された1時間のスリープ -- `fix-permissions` - 指定したディレクトリのパーミッションを自動的に全グループの読み書き可能に修正 -- `wait-for` - サービスが正しい順序で起動していることを保証する小さなスクリプト - https://github.com/eficode/wait-for を基にしています +- `docker-sleep` - 標準化された1時間のスリープ機能 +- `fix-permissions` - 指定したディレクトリのパーミッションを自動的に全グループの読み書き可能に変更 +- `wait-for` - サービスが正しい順序で起動していることを確認する小さなスクリプト - https://github.com/eficode/wait-for を基にしています - `entrypoint-readiness` - 長時間実行されるエントリーポイントが完了したことを確認 -- `entrypoints` - /lagoon/entrypoints/* の下にあるすべてのエントリーポイントをアルファベット/数値順にソースするスクリプト +- `entrypoints` - /lagoon/entrypoints/* ディレクトリ内のすべてのエントリーポイントをアルファベット順/数値順に読み込むスクリプト -## 含まれるエントリーポイント +## エントリーポイント -このイメージのデフォルトのエントリーポイントのリストは[https://github.com/uselagoon/lagoon-images/tree/main/images/commons/lagoon/entrypoints](https://github.com/uselagoon/lagoon-images/tree/main/images/commons/lagoon/entrypoints)で見つけることができます。それに続くダウンストリームのイメージ 最終的なイメージで実行される`/lagoon`の下にエントリーポイントを提供します。 +このイメージのデフォルトのエントリーポイントの一覧は[https://github.com/uselagoon/lagoon-images/tree/main/images/commons/lagoon/entrypoints](https://github.com/uselagoon/lagoon-images/tree/main/images/commons/lagoon/entrypoints)にあります。以降の下流イメージも、`/lagoon`配下にエントリーポイントを追加でき、最終的なイメージで実行さます。 diff --git a/docs/ja/docker-images/mariadb.md b/docs/ja/docker-images/mariadb.md index 8c7e4c1f43..2e3f3ab02b 100644 --- a/docs/ja/docker-images/mariadb.md +++ b/docs/ja/docker-images/mariadb.md @@ -1,27 +1,28 @@ # MariaDB -MariaDBは、オープンソースのMySQL後継者です。 +MariaDBは、MySQLの後継のオープンソースです。 -[Lagoonの `MariaDB` イメージDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/10.6.Dockerfile) は、上流のAlpineイメージが提供する公式パッケージ [`mariadb`](https://pkgs.alpinelinux.org/packages?name=mariadb&branch=edge) と [`mariadb-client`](https://pkgs.alpinelinux.org/packages?name=mariadb-client&branch=edge) をベースにしています。 +[Lagoonの `MariaDB` イメージのDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/10.6.Dockerfile)は、公式のAlpineイメージで提供される [`mariadb`](https://pkgs.alpinelinux.org/packages?name=mariadb&branch=edge) と [`mariadb-client`](https://pkgs.alpinelinux.org/packages?name=mariadb-client&branch=edge) パッケージをベースにしています。 -このDockerfileは、スタンドアロンのMariaDBデータベースサーバを設定するために使用されることを意図しています。 +このDockerfileは、スタンドアロンのMariaDBデータベースサーバーをセットアップするために使用されます。 * 10.4 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/10.4.Dockerfile) (Alpine 3.12 は2022年5月までサポート) - `uselagoon/mariadb-10.4` * 10.5 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/10.5.Dockerfile) (Alpine 3.14 は2023年5月までサポート) - `uselagoon/mariadb-10.5` * 10.6 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/10.6.Dockerfile) (Alpine 3.16 は2024年5月までサポート) - `uselagoon/mariadb-10.6` -* 10.11 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/10.11.Dockerfile) (Alpine 3.18 は2025年5月までサポート) - `uselagoon/mariadb-10.11` !!!情報 - これらのイメージは、上流のMariaDBイメージから構築されていないため、サポートは別のサイクルに従います - そして、基礎となるAlpineイメージがサポートを受けている限りのみアップデートを受けます - [https://alpinelinux.org/releases/](https://alpinelinux.org/releases/)を参照してください。実際には、ほとんどのMariaDBユーザーはこれらのコンテナをローカルで実行しています - 本番環境ではDBaaSオペレーターが提供するManaged Cloud Databasesを使用します。 +* 10.11 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/10.11.Dockerfile) (Alpine 3.18 は2025年5月までサポート) - `uselagoon/mariadb-10.11` +!!!情報 + これらのイメージは、公式のMariaDBイメージから構築されていないため、サポートサイクルが異なり、基盤となるAlpineイメージがサポートされている期間のみアップデートが提供されます。詳細は[https://alpinelinux.org/releases/](https://alpinelinux.org/releases/)を参照してください。実際にはほとんどの場合、MariaDBコンテナをローカルでのみ実行し、本番環境ではDBaaSオペレーターが提供するManaged Cloud Databasesを利用します。 ## Lagoonの適応 { #lagoon-adaptions } MariaDBコンテナのデフォルトの公開ポートはポート`3306`です。 -LagoonがMariaDBコンテナを最良の方法で実行することを可能にするために、`lagoon.type: mariadb`を使用します - これにより、DBaaSオペレーターがクラスターで利用可能な場合にクラウドデータベースをプロビジョニングできます。コンテナ内のMariaDBを特にリクエストするには、`lagoon.type: mariadb-single`を使用します。永続的なストレージは、常に`/var/lib/mysql`でMariaDBコンテナに対してプロビジョニングされます。 +LagoonがMariaDBコンテナの実行方法を最適に選択できるようにするには、`lagoon.type: mariadb`を使用します。これにより、DBaaSオペレーターは、クラスター内で利用可能な場合、クラウドデータベースをプロビジョニングできます。コンテナ内でMariaDBを確実に実行したい場合は、`lagoon.type: mariadb-single`を使用してください。MariaDBコンテナに対しては、永続ストレージが常に`/var/lib/mysql`にプロビジョニングされます。 -このイメージはLagoonで使用するために準備されています。したがって、すでにいくつかのことが行われています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダのパーミッションは自動的に[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で調整されるため、このイメージは ランダムなユーザー。 -* MariaDBコンテナが準備完了したことを確認するための `readiness-probe.sh` スクリプト。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 +* `readiness-probe.sh` スクリプト、MariaDB コンテナの準備完了状態を確認します。 ## `docker-compose.yml` スニペット { #docker-composeyml-snippet } @@ -29,44 +30,44 @@ LagoonがMariaDBコンテナを最良の方法で実行することを可能に mariadb: image: uselagoon/mariadb-10.6-drupal:latest labels: - # LagoonにこれがMariaDBデータベースであることを伝える + # LagoonにMariaDBデータベースであることを伝える lagoon.type: mariadb ports: # ポート3306をランダムなローカルポートで公開し、`docker-compose port mariadb 3306`でそれを見つける - "3306" volumes: - # 名前付きボリュームをMariaDBのデフォルトパスにマウントする + # MariaDB用のデフォルトパスに名前付きボリュームをマウントする - db:/var/lib/mysql ``` -## 含まれるツール +## ツール { #included-tools } -* [`mysqltuner.pl`](https://github.com/major/MySQLTuner-perl) - データベースパラメータのチューニングに役立つPerlスクリプト。 -* [`mysql-backup.sh`](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/mysql-backup.sh) - 開発環境での日次MySQLバックアップを自動化するスクリプト。 +* [`mysqltuner.pl`](https://github.com/major/MySQLTuner-perl) - データベースのパラメータ調整に便利なPerlスクリプト。 +* [`mysql-backup.sh`](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/mysql-backup.sh) - 開発環境で MySQL の日次バックアップを自動化するスクリプト。 * [`pwgen`](https://linux.die.net/man/1/pwgen) - ランダムで複雑なパスワードを生成するユーティリティ。 -## 含まれる `my.cnf` 設定ファイル +## `my.cnf` 設定ファイル { #included-mycnf-configuration-file } -このイメージには、_デフォルト_ のMariaDB設定ファイルが含まれており、Lagoonで動作するように最適化されています。一部のオプションは[環境変数](../concepts-advanced/environment-variables.md)を介して設定可能です。 +このイメージには、Lagoonで動作するように最適化された _デフォルト_ のMariaDB設定ファイルが付属しています。一部のオプションは[環境変数](../concepts-advanced/environment-variables.md)で設定可能です。 ## 環境変数 { #environment-variables } -| 環境 | 変数名 | デフォルト | 説明 | +| 環境変数名 | デフォルト | 説明 | | :----------------------------------- | :-------------------- | :--------------------------------------------------------------------------- | -| MARIADB_DATABASE | lagoon | 起動時に作成されるデータベース名。 | -| MARIADB_USER | lagoon | 起動時に作成されるデフォルトユーザー。 | -| MARIADB_PASSWORD | lagoon | 起動時に作成されるデフォルトユーザーのパスワード。 | -| MARIADB_ROOT_PASSWORD | Lag00n | MariaDBのルートユーザーのパスワード。 | -| MARIADB_CHARSET | utf8mb4 | サーバーの文字セットを設定する。 | -| MARIADB_COLLATION | utf8mb4_bin | サーバーの照合順序を設定する。 | -| MARIADB_MAX_ALLOWED_PACKET | 64M | `max_allowed_packet`のサイズを設定する。 | -| MARIADB_INNODB_BUFFER_POOL_SIZE | 256M | MariaDB InnoDBバッファプールのサイズを設定します。 | -| MARIADB_INNODB_BUFFER_POOL_INSTANCES | 1 | InnoDBバッファプールインスタンスの数。 | -| MARIADB_INNODB_LOG_FILE_SIZE | 64M | InnoDBログファイルのサイズ。 | -| MARIADB_LOG_SLOW | (設定なし) | 遅いクエリの保存を制御する変数。 | -| MARIADB_LOG_QUERIES | (設定なし) | すべてのクエリの保存を制御する変数。 | -| BACKUPS_DIR | /var/lib/mysql/backup | データベースのバックアップのデフォルトパス。 | -| MARIADB_DATA_DIR | /var/lib/mysql | MariaDBのデータディレクトリのパス。注意してください、これを変更するとデータの損失が発生する可能性があります！ | -| MARIADB_COPY_DATA_DIR_SOURCE | (設定なし) | mariadbのエントリーポイントスクリプトが定義した`Mをコピーするために使用するパス。 `ARIADB_DATA_DIR`は、MariaDBにデータベースを事前に入れるために使用できます。このスクリプトは、sqlファイルではなく、実際のMariaDBデータファイルを期待しています！また、目的地にすでにmysqlのdatadirが存在しない場合にのみデータをコピーします。| - -`LAGOON_ENVIRONMENT_TYPE`変数が`production`に設定されている場合、パフォーマンスは`MARIADB_INNODB_BUFFER_POOL_SIZE=1024`および`MARIADB_INNODB_LOG_FILE_SIZE=256`を使用して適切に設定されます。 +| MARIADB_DATABASE | lagoon | 起動時に作成されるデータベース名 | +| MARIADB_USER | lagoon | 起動時に作成されるデフォルトユーザー | +| MARIADB_PASSWORD | lagoon | 起動時に作成されるデフォルトユーザーのパスワード | +| MARIADB_ROOT_PASSWORD | Lag00n | MariaDBのルートユーザーのパスワード | +| MARIADB_CHARSET | utf8mb4 | サーバーの文字セットを設定する | +| MARIADB_COLLATION | utf8mb4_bin | サーバーの照合順序を設定する | +| MARIADB_MAX_ALLOWED_PACKET | 64M | `max_allowed_packet`のサイズを設定する | +| MARIADB_INNODB_BUFFER_POOL_SIZE | 256M | MariaDB InnoDBバッファプールのサイズを設定します | +| MARIADB_INNODB_BUFFER_POOL_INSTANCES | 1 | InnoDBバッファプールインスタンスの数 | +| MARIADB_INNODB_LOG_FILE_SIZE | 64M | InnoDBログファイルのサイズ | +| MARIADB_LOG_SLOW | (設定なし) | 遅いクエリの保存を制御する変数 | +| MARIADB_LOG_QUERIES | (設定なし) | すべてのクエリの保存を制御する変数 | +| BACKUPS_DIR | /var/lib/mysql/backup | データベースのバックアップのデフォルトパス | +| MARIADB_DATA_DIR | /var/lib/mysql | MariaDBのデータディレクトリのパス。注意してください、この値を変更するとデータ損失が発生する可能性があります！ | +| MARIADB_COPY_DATA_DIR_SOURCE | (設定なし) | Mariadbのエントリーポイントスクリプトが、設定された`ARIADB_DATA_DIR`ディレクトリにデータをコピーする際に使用するパスについてセル名します。このパスを利用して、データベースをあらかじめMariaDBに投入することができます。 ただし、スクリプトはSQLファイルではなく、実際のMariaDBデータファイルの存在を前提としています。 さらに、スクリプトは、コピー先のディレクトリに既存のMySQLデータディレクトリが存在しない場合にのみ、データをコピーします。| + +`LAGOON_ENVIRONMENT_TYPE` 変数が `production` に設定されている場合、パフォーマンスは `MARIADB_INNODB_BUFFER_POOL_SIZE=1024` および `MARIADB_INNODB_LOG_FILE_SIZE=256` に設定することで最適化されます。 diff --git a/docs/ja/docker-images/mongodb.md b/docs/ja/docker-images/mongodb.md index 8ebc30dd62..db0fe22d8b 100644 --- a/docs/ja/docker-images/mongodb.md +++ b/docs/ja/docker-images/mongodb.md @@ -1,17 +1,17 @@ # MongoDB -> _MongoDBは、モダンなアプリケーション開発者とクラウド時代のために構築された、汎用的な、ドキュメントベースの分散データベースです。MongoDBはドキュメントデータベースであり、JSON形式のドキュメントとしてデータを格納します。_ +> _MongoDBは、汎用的なドキュメント型分散データベースであり、現代のアプリケーション開発者やクラウド時代のニーズに合わせて構築されています。データは JSONのような形式のドキュメントで保存されます_ > -> * [mongodb.com](https://www.mongodb.com/)から +> * 出典: [mongodb.com](https://www.mongodb.com/) ## サポートされているバージョン { #supported-versions } 4.0 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mongo/4.Dockerfile) - `uselagoon/mongo-4` -このDockerfileは、スタンドアロンのMongoDBデータベースサーバーをセットアップするためのものです。 +このDockerfileは、スタンドアロンのMongoDBデータベースサーバーをセットアップするために使用されます。 ## Lagoonの適応 { #lagoon-adaptions } -このイメージはLagoonで使用するために準備されています。したがって、すでにいくつかのことが行われています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダーの権限は自動的に[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で適応されるため、このイメージはランダムなユーザーで動作し、したがってKubernetesまたはOpenShiftでも動作します。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されます。これにより、ランダムなユーザーでも動作するようにするため、KubernetesやOpenShiftでも使用できます。 diff --git a/docs/ja/docker-images/mysql.md b/docs/ja/docker-images/mysql.md new file mode 100644 index 0000000000..4ceffe77f1 --- /dev/null +++ b/docs/ja/docker-images/mysql.md @@ -0,0 +1,93 @@ +# MySQL + +MySQLは人気のあるオープンソースのリレーショナルデータベース管理システム(RDBMS)です。 + +[Lagoonの `MySQl` イメージのDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mysql/8.4.Dockerfile)は、公式のアップストリームdocker イメージ[`mysql`](https://hub.docker.com/_/mysql)(Oracle Linux variant)をベースに作成されています。 + +このDockerfileは、スタンドアロンのMariaDBデータベースサーバーをセットアップするために使用されます。 + +* 8.0 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mysql/8.0.Dockerfile) (2026年4月まで延長サポート) - `uselagoon/mysql-8.0` +* 8.4 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/mysql/8.4.Dockerfile) (2032年4月まで延長サポート) - `uselagoon/mysql-8.4` + +!!!情報 + このイメージはMariaDBイメージの完全な代替品として作られたものではありません。そのため、ローカル開発環境で動作させるにはカスタマイズが必要な場合があります。 + +## Lagoonの適応 { #lagoon-adaptions } + +MySQLコンテナのデフォルトの公開ポートはポート`3306`です。 + +LagoonがMySQLコンテナの実行方法を最適に選択できるようにするには、`lagoon.type: mariadb`を使用します。これにより、DBaaSオペレーターは、クラスター内で利用可能な場合、クラウドデータベースをプロビジョニングできます。コンテナ内でMySQLを確実に実行したい場合は、`lagoon.type: mariadb-single`を使用してください。MySQLコンテナに対しては、永続ストレージが常に`/var/lib/mysql`にプロビジョニングされます。 + +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: + +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 +* `readiness-probe.sh` スクリプト、MariaDB コンテナの準備完了状態を確認します。 + +## 非Drupalプロジェクト用の`docker-compose.yml` スニペット { #docker-composeyml-snippet-for-non-drupal-projects } + +```yaml title="docker-compose.yml" + mariadb: + image: uselagoon/mysql-8.4:latest + labels: + # LagoonにMariaDB互換のデータベースであることを伝える + lagoon.type: mariadb + ports: + # ポート3306をランダムなローカルポートで公開し、`docker-compose port mysql 3306`でそれを見つける + - "3306" + volumes: + # MySQL用のデフォルトパスに名前付きボリュームをマウントする + - db:/var/lib/mysql +``` + +## Drupalプロジェクト用の`docker-compose.yml` スニペット { #docker-composeyml-snippet-for-drupal-projects } + +```yaml title="docker-compose.yml" + mariadb: + image: uselagoon/mysql-8.4:latest + labels: + # LagoonにMariaDB互換のデータベースであることを伝える + lagoon.type: mariadb + ports: + # ポート3306をランダムなローカルポートで公開し、`docker-compose port mysql 3306`でそれを見つける + - "3306" + environment: + # LagoonでDrupalがデフォルトで期待する認証情報と一致するように、デフォルトの認証情報をオーバーライドします。 + - MYSQL_DATABASE=drupal + - MYSQL_USER=drupal + - MYSQL_PASSWORD=drupal + volumes: + # MySQL用のデフォルトパスに名前付きボリュームをマウントする + - db:/var/lib/mysql +``` + +## ツール { #included-tools } + +* [`mysqltuner.pl`](https://github.com/major/MySQLTuner-perl) - データベースのパラメータ調整に便利なPerlスクリプト。 +* [`mysql-backup.sh`](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/mysql-backup.sh) - 開発環境で MySQL の日次バックアップを自動化するスクリプト。 +* [`pwgen`](https://linux.die.net/man/1/pwgen) - ランダムで複雑なパスワードを生成するユーティリティ。 + +## `my.cnf` 設定ファイル { #included-mycnf-configuration-file } + +このイメージには、Lagoonで動作するように最適化された _デフォルト_ のMariaDB設定ファイルが含まれています。一部のオプションは[環境変数](../concepts-advanced/environment-variables.md)で設定可能です。 + +## 環境変数 { #environment-variables } + +| 環境変数名 | デフォルト | 説明 | +| :----------------------------------- | :-------------------- | :--------------------------------------------------------------------------- | +| MYSQL_DATABASE | lagoon | 起動時に作成されるデータベース名 | +| MYSQL_USER | lagoon | 起動時に作成されるデフォルトユーザー | +| MYSQL_PASSWORD | lagoon | 起動時に作成されるデフォルトユーザーのパスワード | +| MYSQL_ROOT_PASSWORD | Lag00n | MariaDBのルートユーザーのパスワード | +| MYSQL_CHARSET | utf8mb4 | サーバーの文字セットを設定する | +| MYSQL_COLLATION | utf8mb4_bin | サーバーの照合順序を設定する | +| MYSQL_MAX_ALLOWED_PACKET | 64M | `max_allowed_packet`のサイズを設定する | +| MYSQL_INNODB_BUFFER_POOL_SIZE | 256M | MySQL InnoDBバッファプールのサイズを設定します | +| MYSQL_INNODB_BUFFER_POOL_INSTANCES | 1 | InnoDBバッファプールインスタンスの数 | +| MYSQL_INNODB_LOG_FILE_SIZE | 64M | InnoDBログファイルのサイズ | +| MYSQL_LOG_SLOW | (設定なし) | 遅いクエリの保存を制御する変数 | +| MYSQL_LOG_QUERIES | (設定なし) | すべてのクエリの保存を制御する変数 | +| BACKUPS_DIR | /var/lib/mysql/backup | データベースのバックアップのデフォルトパス | +| MYSQL_DATA_DIR | /var/lib/mysql | MySQLのデータディレクトリのパス。注意してください、この値を変更するとデータ損失が発生する可能性があります！ | +| MARIADB_COPY_DATA_DIR_SOURCE | (設定なし) | MySQLのエントリーポイントスクリプトが、設定された`MYSQL_DATA_DIR`ディレクトリにデータをコピーする際に使用するパスについてセル名します。このパスを利用して、データベースをあらかじめMySQLに投入することができます。 ただし、スクリプトはSQLファイルではなく、実際のMySQLデータファイルの存在を前提としています。 さらに、スクリプトは、コピー先のディレクトリに既存のMySQLデータディレクトリが存在しない場合にのみ、データをコピーします。| + +`LAGOON_ENVIRONMENT_TYPE` 変数が `production` に設定されている場合、パフォーマンスは `MYSQL_INNODB_BUFFER_POOL_SIZE=1024` および `MYSQL_INNODB_LOG_FILE_SIZE=256` に設定することで最適化されます。 diff --git a/docs/ja/docker-images/nginx.md b/docs/ja/docker-images/nginx.md index 6181e9d327..5872ec980b 100644 --- a/docs/ja/docker-images/nginx.md +++ b/docs/ja/docker-images/nginx.md @@ -1,67 +1,64 @@ # NGINX -[Lagoonの `nginx` イメージDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/nginx/Dockerfile)です。公式の[`openresty/openresty` イメージ](https://hub.docker.com/r/openresty/openresty/)を基に作成されています。 +[Lagoonの `nginx` イメージDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/nginx/Dockerfile)です。公式の[`openresty/openresty` イメージ](https://hub.docker.com/r/openresty/openresty/)をベースに作成されています。 -このDockerfileは、Lagoon内の任意のウェブサーバーのベースとして使用することを目的としています。 +このDockerfileは、Lagoon内のあらゆるウェブサーバーのベースとして使用することを想定しています。 ## Lagoonの調整事項 NGINXコンテナのデフォルトの公開ポートは `8080` ポートです。 -このイメージはLagoonで使用するために準備されています。そのため、すでにいくつかの事項が処理されています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)により自動的に適応されるため、このイメージはランダムなユーザーでも動作します。 -* `/etc/nginx/*` 内のファイルは、コンテナエントリーポイントを使用して [`envplate`](https://github.com/kreuzwerker/envplate) を通じて解析されます。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 +* `/etc/nginx/*` 内のファイルは、コンテナエントリーポイントによって [`envplate`](https://github.com/kreuzwerker/envplate) を通じて処理されます。 -## 含まれる `NGINX` 設定(`static-files.conf`) +## `NGINX` 設定(`static-files.conf`) !!! Warning "警告" - デフォルトでは `NGINX` は静的ファイルのみを提供します - これはデータベースやPHPコンポーネントが必要ない静的サイトに使用できます:例えば、静的サイトジェネレーターの [Hugo](https://gohugo.io/)、[Jekyll](https://jekyllrb.com/)、[Gatsby](https://www.gatsbyjs.org/) などです。 + デフォルトでは `NGINX` は静的ファイルのみを提供します。これはデータベースやPHPコンポーネントが必要ない静的サイトに使用できます:例えば、静的サイトジェネレーターの [Hugo](https://gohugo.io/)、[Jekyll](https://jekyllrb.com/)、[Gatsby](https://www.gatsbyjs.org/) などです。 -PHPが必要な場合は、以下を参照してください。 `php-fpm`イメージを見て、`nginx`と`php-fpm`を一緒に使用します。 +PHPが必要な場合は、`php-fpm`イメージを参照し、`nginx`と`php-fpm`を一緒に使用してください。 -ビルドプロセス中にコンテンツをビルドし、それを`nginx`コンテナに注入します。 +コンテンツはビルドプロセス中にビルドし、`nginx`コンテナに投入します。 ## ヘルパー ### `redirects-map.conf` -リダイレクトを作成するために、私たちは`redirects-map.conf`を設置しています。これにより、マーケティングドメインをサブサイトにリダイレクトしたり、非wwwからwwwへのリダイレクトを行うことができます。**リダイレクトが多い場合は、`redirects-map.conf`をコードの隣に保存することでメンテナンスが容易になります。** +リダイレクトを作成するために、`redirects-map.conf`ファイルが用意されています。これを使用して、マーケティングドメインをサブサイトにリダイレクトしたり、wwwなしをwww付きにするリダイレクトを行うことができます。**リダイレクトが多い場合は、メンテナンス性を向上させるために`redirects-map.conf`をコードの隣に保存することを推奨します。** !!! Note "注意:" - リダイレクトが少ない場合は、`RUN`コマンドを使って`nginx.dockerfile`でリダイレクトを作成する便利な方法があります。 + リダイレクトが少ない場合は、`nginx.dockerfile`の`RUN`コマンドを使用してリダイレクトを作成する便利な方法があります。 -以下は、`www.example.com`を`example.com`にリダイレクトし、リクエストを保持する方法を示した例です: +以下は、`www.example.com`を`example.com`にリダイレクトし、リクエストを保持する方法を示す例です: ```bash title="Redirect" RUN echo "~^www.example.com http://example.com\$request_uri;" >> /etc/nginx/redirects-map.conf ``` -達成可能なさまざまなタイプのリダイレクトについて詳しく知りたい場合は、[`redirects-map.conf`](https://github.com/uselagoon/lagoon-images/blob/main/images/nginx/redirects-map.conf)のドキュメンテーションを直接参照してください。 +リダイレクトの種類の詳細については、[`redirects-map.conf`](https://github.com/uselagoon/lagoon-images/blob/main/images/nginx/redirects-map.conf)のドキュメントを参照してください。 -`redirects-map.conf`を設置した後、それを`nginx.dockerfile`にも含める必要があります。 ビルドに設定ファイルを取り込む方法。 +`redirects-map.conf`を配置したら、ビルドに設定ファイルを取り込むために、`nginx.dockerfile`にもそれをインクルードする必要があります。 ```bash title="nginx.dockerfile" COPY redirects-map.conf /etc/nginx/redirects-map.conf ``` -### 基本認証 +### ベーシック認証 -`BASIC_AUTH_USERNAME` -および `BASIC_AUTH_PASSWORD` [環境 -変数](../concepts-advanced/environment-variables.md)が設定されている場合、基本認証は自動的に有効になります。 +`BASIC_AUTH_USERNAME`および `BASIC_AUTH_PASSWORD` [環境変数](../concepts-advanced/environment-variables.md)が設定されている場合、ベーシック認証は自動的に有効になります。 !!! Warning "警告" - 自動基本認証設定は便宜上提供されています。ウェブサイトやプライベートデータを保護する安全な方法とは考えられません。 + ベーシック認証の自動設定は、利便性のために提供されています。ウェブサイトや機密データを保護するための安全な方法とはみなされません。 ## 環境変数 { #environment-variables } -いくつかのオプションは[環境 -変数](../concepts-advanced/environment-variables.md)を介して設定可能です。 +いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)を使用して設定できます。 | 環境変数 | デフォルト | 説明 | | :------------------- | :--------- | :--- | -| BASIC_AUTH | restricted | 基本認証を無効にするには `off` に設定します。 | -| BASIC_AUTH_USERNAME | (設定なし) | 基本認証のユーザーネーム。 | -| BASIC_AUTH_PASSWORD | (設定なし) | 基本認証のパスワード。 基本認証(非暗号化)。 | -| FAST_HEALTH_CHECK | (未設定) | 特定のユーザーエージェント(StatusCake、Pingdom、Site25x7、Uptime、nagios)からのGETリクエストを軽量なLagoonサービスヘルスチェックにリダイレクトするには、`true`に設定します。 | +| BASIC_AUTH | restricted | ベーシック認証を無効にするには `off` に設定します | +| BASIC_AUTH_USERNAME | (設定なし) | ベーシック認証のユーザーネーム | +| BASIC_AUTH_PASSWORD | (設定なし) | ベーシック認証のパスワード(非暗号化) | +| FAST_HEALTH_CHECK | (設定なし) | 特定のユーザーエージェント(StatusCake、Pingdom、Site25x7、Uptime、nagios)からのGETリクエストは、軽量なLagoonサービスヘルスチェックにリダイレクトするには、`true`に設定します。 | diff --git a/docs/ja/docker-images/nodejs.md b/docs/ja/docker-images/nodejs.md index 4658f994d0..0ff409f4d0 100644 --- a/docs/ja/docker-images/nodejs.md +++ b/docs/ja/docker-images/nodejs.md @@ -1,55 +1,57 @@ # Node.js -[Lagoonの `Node.js` Dockerイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/node)です。[公式のNode Alpineイメージ](https://hub.docker.com/_/node/)を基に作成しています。 +[Lagoonの `Node.js` Dockerイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/node)です。[公式のNode Alpineイメージ](https://hub.docker.com/_/node/)をベースに作成されています。 ## サポートされているバージョン { #supported-versions } -Node.jsのイメージは2つのバージョンを提供しています:通常の `node:version` イメージと `node:version-builder`。 +Node.jsのイメージは2つのバージョンがあります。通常の`node:version`イメージと`node:version-builder`です。 -これらのイメージのビルダーバリアントには、Node.jsのアプリをビルドする際に必要な追加のツール(ビルドライブラリ、npm、Yarnなど)が含まれています。完全なリストについては、[Dockerfile](https://github.com/uselagoon/lagoon-images/tree/main/images/node-builder)をご覧ください。 +`node:version-builder`には、Node.jsアプリケーションをビルドする際に必要な追加ツール(ビルドライブラリ、npm、Yarnなど)が含まれています。詳細なリストについては、[Dockerfile](https://github.com/uselagoon/lagoon-images/tree/main/images/node-builder)を参照してください。 -* 12(互換性のためだけに利用可能、公式にはサポートされていません)- `uselagoon/node-12` -* 14(互換性のためだけに利用可能、公式にはサポートされていません)- `uselagoon/node-14` -* 16(互換性のためだけに利用可能、公式にはサポートされていません)- `uselagoon/node-16` -* 18 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/node/18.Dockerfile) (2025年4月までのセキュリティサポート) - `uselagoon/node-18` -* 20 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/node/20.Dockerfile) (2026年4月までのセキュリティサポート) - `uselagoon/node-20` +* 12(互換性のためのみ利用可能、公式サポートは終了しています)- `uselagoon/node-12` +* 14(互換性のためのみ利用可能、公式サポートは終了しています)- `uselagoon/node-14` +* 16(互換性のためのみ利用可能、公式サポートは終了しています)- `uselagoon/node-16` +* 18(互換性のためのみ利用可能、公式サポートは終了しています)- `uselagoon/node-18` +* 20 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/node/20.Dockerfile) (2025年4月までのセキュリティサポート) - `uselagoon/node-20` +* 22 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/node/22.Dockerfile) (2026年4月までのセキュリティサポート) - `uselagoon/node-22` !!! Tip "ヒント" - EOL Node.jsイメージの更新は通常、公式に発表されたEOL日付の後にリリースされるLagoonリリースと共に停止します:[https://nodejs.org/en/about/releases/](https://nodejs.org/en/about/releases/). + Lagoonは、公式にアナウンスされた終了日(EOL)の後にリリースされるバージョンで、EOLに達したNode.jsイメージの更新を停止します。詳細は[https://nodejs.org/en/about/releases/](https://nodejs.org/en/about/releases/)を参照して下さい。 ## Lagoonの適応 { #lagoon-adaptions } Node.jsコンテナのデフォルトの公開ポートはポート`3000`です。 -永続的なストレージは、`lagoon.type: node-persistent`を使用してLagoonで設定可能です。詳しくは[ドキュメンテーション](../concepts-basics/docker-compose-yml.md#persistent-storage)をご覧ください。 +Lagoonでは、`lagoon.type: node-persistent`を使用して、永続的なストレージを設定できます。詳細は[ドキュメント](../concepts-basics/docker-compose-yml.md#persistent-storage)を参照して下さい。 -次のラベルを`docker-compose.yml`ファイルで設定します: +永続ストレージを設定するには、`docker-compose.yml`ファイルで以下のラベルを使用します: -* `lagoon.persistent` = これを使用して、コンテナ内で永続的なストレージとして使用するパスを定義します - 例えば、/app/files。 -* `lagoon.persistent.size` = これを使用して、Lagoonにこのパスに割り当てるストレージの量を通知します。 +* `lagoon.persistent` = コンテナ内の永続ストレージとして使用するパスを定義します - 例えば、/app/files +* `lagoon.persistent.size` = Lagoonに対し、このパスに割り当てるストレージ容量を指定します * 同じストレージを共有する複数のサービスがある場合は、これを使用します -`lagoon.persistent.name` = (オプション)これを使用して、Lagoonに他の名前付きサービスで定義されたストレージを使用するように指示します。 +`lagoon.persistent.name` = (オプション)複数のサービスが同じストレージを共有する場合、別の名前付きサービスで定義されたストレージを使用するようにLagoonに指示します。 ## `docker-compose.yml` スニペット { #docker-composeyml-snippet } ```yaml title="docker-compose.yml" node: build: - # これはルートフォルダーのDockerfileからビルドを設定します + # ルートフォルダにあるDockerfileからビルドを設定します context: . dockerfile: Dockerfile labels: - # このテキストはLagoonに対して、/app/filesに500MBの永続的なストレージを持つノードサービスとして設定されていることを伝えています。 + # Lagoonに対して、Node.jsサービスであること、/app/filesに500MBの永続ストレージを設定します。 lagoon.type: node-persistent lagoon.persistent: /app/files lagoon.persistent.size: 500Mi ポート: - # ローカル開発専用 - # ポート3000をランダムなローカルポートとして公開します - # `docker-compose port node 3000`で探すことができます + # ローカル開発のみ適用される設定です + # ポート3000をランダムなローカルポートにマッピングし、 + # `docker-compose port node 3000`でポートを確認することができます。 - "3000" ボリューム: - # ローカル開発専用 - # 定義されたパスに名前付きボリューム(ファイル)をマウントして、このサービスの本番環境をレプリケートします + # ローカル開発のみ適用される設定です + # filesという名前のボリュームを定義されたパスにをマウントします。これは、本番環境と同じ状態を再現するためにローカル開発環境で利用されます。 - files:/app/files ``` + diff --git a/docs/ja/docker-images/opensearch.md b/docs/ja/docker-images/opensearch.md index 1e5dfef4fd..57919b50e4 100644 --- a/docs/ja/docker-images/opensearch.md +++ b/docs/ja/docker-images/opensearch.md @@ -1,6 +1,6 @@ # OpenSearch -> [_OpenSearch_](https://opensearch.org/)は、データを簡単に取り込み、検索、視覚化、分析することを可能にする、コミュニティ主導のApache 2.0ライセンスのオープンソース検索および分析スイートです。 +> [_OpenSearch_](https://opensearch.org/)は、データを簡単に取り込み、検索、可視化、分析するためのコミュニティ主導のApache2.0ライセンスを採用したオープンソースの検索および分析スイートです。 > > * 出典: [https://opensearch.org/](https://opensearch.org/) @@ -10,7 +10,7 @@ ## 環境変数 { #environment-variables } -いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)経由で設定可能です。 +OpenSearch の一部オプションは、[環境変数](../concepts-advanced/environment-variables.md)を使用して設定できます。 | 環境変数 | デフォルト値 | 説明 | | :------------------- | :---------------- | :------------------------------------------------------------------------------------------------------------------------- | @@ -18,9 +18,11 @@ ## 既知の問題 -Linuxベースのシステムでは、`vm.max_map_count`設定が低いためにOpenSearchコンテナの起動が失敗する可能性があります。 ```bash title="エラー" -opensearch_1 | エラー: [1] ブートストラップチェックが失敗しました -opensearch_1 | [1]: 最大仮想メモリエリア vm.max_map_count [65530] が低すぎます、少なくとも [262144] に増やしてください +Linuxベースのシステムでは、`vm.max_map_count`設定が低いために、OpenSearchコンテナの起動が失敗することがあります。 + + ```bash title="エラー" +opensearch_1 | ERROR: [1] bootstrap checks failed +opensearch_1 | [1]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144] ``` [この問題の解決策はここで見つけることができます](https://opensearch.org/docs/latest/opensearch/install/important-settings/). diff --git a/docs/ja/docker-images/php-cli.md b/docs/ja/docker-images/php-cli.md index 3ec8ceea3c..fc8c748be4 100644 --- a/docs/ja/docker-images/php-cli.md +++ b/docs/ja/docker-images/php-cli.md @@ -1,19 +1,19 @@ # PHP-CLI -[Lagoonの `php-cli` Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/php-cli)です。[Lagoonの `php-fpm`イメージ](./php-fpm.md)を基に、日常的な操作に必要なコマンドラインツールが全て揃っています。 +[Lagoonの `php-cli` Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/php-cli)です。[Lagoonの `php-fpm`イメージ](./php-fpm.md)をベースに、日常的な操作に必要なコマンドラインツールがすべて揃っています。 -`cli`イメージから起動されたコンテナ(またはポッド)はComposerやNode.jsベースのプロジェクトのコードを構築する責任があります。 +`cli`イメージから起動されたコンテナ(またはポッド)はComposerやNode.jsベースのプロジェクトのコードビルドを担当します。 -また、このイメージにはMariaDBとPostgreSQLの両方のデータベース`cli`が含まれています。 +また、MariaDBとPostgreSQL両方のデータベース`cli`が含まれています。 !!! Info "情報" - このDockerfileは、Lagoon内で`cli`が必要な場合に基本として使用することを意図しています。 + このDockerfileは、Lagoon内でのあらゆる`cli`ニーズの基盤として使用されることを想定しています。 ## サポートされているバージョン { #supported-versions } -* 7.3(互換性のために利用可能、公式サポートは終了) - `uselagoon/php-7.3-cli` -* 7.4(互換性のために利用可能、公式サポートは終了) - `uselagoon/php-7.4-cli` -* 8.0(互換性のために利用可能、公式サポートは終了) - `uselagoon/php-8.0-cli` +* 7.3(互換性のためのみ利用可能、公式サポートは終了しています) - `uselagoon/php-7.3-cli` +* 7.4(互換性のためのみ利用可能、公式サポートは終了しています) - `uselagoon/php-7.4-cli` +* 8.0(互換性のためのみ利用可能、公式サポートは終了しています) - `uselagoon/php-8.0-cli` * 8.1 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/php-cli/8.1.Dockerfile)(2024年11月までセキュリティサポート) - `uselagoon/php-8.1-cli` * 8.2 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/php-cli/8.2.Dockerfile)(2025年12月までセキュリティサポート) - `uselagoon/php-8.2-cli` * 8.3 [ Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/php-cli/8.3.Dockerfile) (2026年12月までのセキュリティサポート) - `uselagoon/php-8.3-cli` @@ -22,16 +22,16 @@ ## Lagoonの適応 { #lagoon-adaptions } -このイメージはLagoonで使用するために準備されています。そのため、すでにいくつかの事項が完了しています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: * フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 -* `COMPOSER_ALLOW_SUPERUSER=1`は、rootとしてのComposerの使用に関する警告を削除します。 -* `80-shell-timeout.sh`スクリプトは、コンテナがKubernetes環境で実行されているかどうかを確認し、その後、アイドル`cli`ポッドに10分のタイムアウトを設定します。 -* `cli`コンテナは、Lagoonによって注入されたSSHキーまたは`SSH_PRIVATE_KEY`環境変数に定義されたSSHキーを使用します。 +* `COMPOSER_ALLOW_SUPERUSER=1`は、rootとしてComposerを使用することに関する警告を削除します。 +* `80-shell-timeout.sh`スクリプトは、コンテナがKubernetes環境で実行されているかどうかを確認し、アイドル状態の`cli`ポッドに対して10分のタイムアウトを設定します。 +* `cli`コンテナは、Lagoonによって注入されるか、`SSH_PRIVATE_KEY`環境変数で定義されたSSHキーを使用します。 -## 含まれるCLIツール +## CLIツール -含まれるCLIツールは次のとおりです: +組み込まれているCLIツールは以下の通りです: * [`composer`バージョン1.9.0](https://getcomposer.org/) \( `COMPOSER_VERSION`および`COMPOSER_HASH_SHA256`経由で変更可能\) * [`node.js`バージョン17](https://nodejs.org/en/) \(2022年3月現在\) @@ -42,7 +42,7 @@ ### Node.jsバージョンの変更 -デフォルトでは、このイメージには`nodejs-current`パッケージ(2022年3月時点でv17)が付属しています。別のバージョンが必要な場合は、現在のバージョンを削除して選択したバージョンをインストールできます。例えば、Node.js 16をインストールするには、dockerfileを以下のように修正します。 +デフォルトでは、このイメージには`nodejs-current`パッケージ(2022年3月時点でv17)が搭載されています。別のバージョンが必要な場合は、現在のバージョンを削除して目的のバージョンをインストールできます。例えば、Node.js 16をインストールするには、Dockerfileを次のように変更します。 ```bash title="Node.jsバージョンの更新" RUN apk del nodejs-current \ @@ -51,8 +51,8 @@ RUN apk del nodejs-current \ ## 環境変数 { #environment-variables } -いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)を介して設定可能です。[php-fpm環境変数](php-fpm.md#environment-variables)も適用されます。 +いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)で設定できます。[php-fpm環境変数](php-fpm.md#environment-variables)も適用されます。 | 名前 | デフォルト | 説明 | | :------------------------- | :------ | :---------------------------------------------------- | -| MARIADB_MAX_ALLOWED_PACKET | 64M | MySqlクライアントの最大許容パケットを制御します。 | +| MARIADB_MAX_ALLOWED_PACKET | 64M | MySqlクライアントの最大許容パケットサイズを制御します。 | diff --git a/docs/ja/docker-images/php-fpm.md b/docs/ja/docker-images/php-fpm.md index 95b9e51340..11adb77e92 100644 --- a/docs/ja/docker-images/php-fpm.md +++ b/docs/ja/docker-images/php-fpm.md @@ -1,21 +1,21 @@ # PHP-FPM -[Lagoonの `php-fpm` Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/php-fpm)です。[公式のPHP Alpineイメージ](https://hub.docker.com/_/php/)に基づいています。 +[Lagoonの `php-fpm` Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/php-fpm)です。[公式のPHP Alpineイメージ](https://hub.docker.com/_/php/)をベースに作成されています。 ->_PHP-FPM(FastCGIプロセスマネージャ)は、追加機能を備えた代替PHP FastCGIの実装で、任意のサイズのサイト、特に忙しいサイトに役立ちます。_ +>_PHP-FPM(FastCGI Process Manager)は、FastCGI プロトコルを利用した PHP の実装のひとつで、様々な規模のサイト、特にトラフィックが多いサイト向けに便利な追加機能を備えています。_ > -> [https://php-fpm.org/](https://php-fpm.org/)より +> * 出典: [https://php-fpm.org/](https://php-fpm.org/) > -> FastCGIは、サーバースクリプトがタイムコンシューミングなコードを一度だけ実行する方式で、スクリプトがロードされるたびに実行されるのを防ぎ、オーバーヘッドを軽減します。 +> FastCGIは、サーバースクリプトが時間のかかるコードをスクリプトがロードされる毎度ではなく、一度だけ実行できるようにする仕組みです。これにより、オーバーヘッドを削減します。 !!! Info "情報" - このDockerfileは、Lagoon内での任意の`PHP`ニーズの基盤として使用することを目的としています。このイメージ自体はウェブサーバーを作成せず、`php-fpm` fastcgiリスナーを作成します。`php-fpm`プール設定を適応させる必要があるかもしれません。 + Dockerfileは、Lagoon内で`PHP`を利用するためのベースとして使用する想定です。このイメージ自体がウェブサーバーを作成するのではなく、`php-fpm`によるFastCGIリスナーを作成します。`php-fpm`プールの設定を調整する必要が生じるかもしれません。 ## サポートされているバージョン { #supported-versions } -* 7.3 (互換性を保つためのみに利用可能、公式サポートは終了) - `uselagoon/php-7.3-fpm` -* 7.4 (互換性を保つためのみに利用可能、公式サポートは終了) - `uselagoon/php-7.4-fpm` -* 8.0 (互換性を保つためのみに利用可能、公式サポートは終了) - `uselagoon/php-8.0-fpm` +* 7.3 (互換性のためのみ利用可能、公式サポートは終了しています) - `uselagoon/php-7.3-fpm` +* 7.4 (互換性のためのみ利用可能、公式サポートは終了しています) - `uselagoon/php-7.4-fpm` +* 8.0 (互換性のためのみ利用可能、公式サポートは終了しています) - `uselagoon/php-8.0-fpm` * 8.1 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main /images/php-fpm/8.1.Dockerfile) (2024年11月までのセキュリティサポート) - `uselagoon/php-8.1-fpm` * 8.2 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/php-fpm/8.2.Dockerfile) (2025年12月までのセキュリティサポート) - `uselagoon/php-8.2-fpm` * 8.3 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/php-fpm/8.3.Dockerfile) (2026年12月までのセキュリティサポート) - `uselagoon/php-8.3-fpm` @@ -23,86 +23,84 @@ すべてのPHPバージョンはそれぞれのDockerfilesを使用します。 !!! Tip "ヒント" - End of Life \(EOL\) PHP画像の更新は通常、公式に発表されたEOL日付の後のLagoonリリースで停止します:[https://www.php.net/supported-versions.php](https://www.php.net/supported-versions.php)。以前に公開されたバージョンは利用可能なままとなります。 + Lagoonは、公式にアナウンスされた終了日(EOL)の後にリリースされるバージョンで、EOLに達したPHPイメージの更新を停止します。詳細は[https://www.php.net/supported-versions.php](https://www.php.net/supported-versions.php)を参照して下さい。 ## Lagoonの適応 { #lagoon-adaptions } -このイメージはLagoonで使用するために準備されています。そのため、すでにいくつかのことが行われています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダの権限は[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されますので、この画像はランダムなユーザーで動作します。 -* `/usr/local/etc/php/php.ini` および `/usr/local/etc/php-fpm.conf`、および `/usr/local/etc/php-f pm.d/`は、コンテナエントリーポイントを経由して[`envplate`](https://github.com/kreuzwerker/envplate)で解析されます。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 +* `/usr/local/etc/php/php.ini` および `/usr/local/etc/php-fpm.conf`ファイル、`/usr/local/etc/php-f pm.d/`ディレクトリ内の全てのファイルは、コンテナエントリーポイントを通して[`envplate`](https://github.com/kreuzwerker/envplate)で処理されます。 * インストールされている `PHP` 拡張機能については、[Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/php-fpm/8.0.Dockerfile)を参照してください。 -* さらなる拡張機能をインストールするには、このイメージからDockerfileを拡張します。ドキュメントに従って拡張機能をインストールしてください。見出し[How to install more PHP extensions.](https://github.com/docker-library/docs/blob/master/php/README.md#how-to-install-more-php-extensions)を参照。 +* さらなる拡張機能をインストールするには、このイメージをもとにDockerfileを拡張してください。拡張機能のインストール方法は、ドキュメント[How to install more PHP extensions.](https://github.com/docker-library/docs/blob/master/php/README.md#how-to-install-more-php-extensions)を参照してください。 -## 含まれるPHP設定 +## PHP設定 -含まれる `PHP` 設定には、`PHP` プール設定の作成を容易にする合理的な値が含まれています。以下にいくつかを挙げます。すべてについては `/usr/local/etc/php.ini`、`/usr/local/etc/php-fpm.conf` を確認してください: +`PHP` 設定には、`PHP`プール設定の作成を容易にするための適切な値が設定されています。以下はその一部のリストです。詳細は`/usr/local/etc/php.ini`、`/usr/local/etc/php-fpm.conf` を確認してください: | 値 | 詳細 | | :--- | :--- | -| `max_execution_time = 900` | `PHP_MAX_EXECUTION_TIME` で変更可能。 | -| `realpath_cache_size = 256k` | 大規模なPHPプロジェクトのため。 | -| `memory_limit = 400M` | 大規模なPHPプロジェクトのため(`PHP_MEMORY_LIMIT` で変更可能)。 | -| `opcache.memory_consumption = 265` | 大規模なPHPプロジェクトのため。 | -| `opcache.enable_file_override = 1` と `opcache.huge_code_pages = 1` | 高速なPHPのため。 | -| `display_errors = Off` と `display_startup_errors = Off` | 実用的な生産値の場合 \(`PHP_DISPLAY_ERRORS` および `PHP_DISPLAY_STARTUP_ERRORS` を介して変更可能\)。 | -| `upload_max_filesize = 2048M` | 大きなファイルのアップロード用。 | -| `apc.shm_size = 32m` と `apc.enabled = 1` | `PHP_APC_SHM_SIZE` および `PHP_APC_ENABLED` を介して変更できます。 | - -また、`php-fpm` のエラー ログは `stderr` に記録されます。 - -**💡 これらの設定のいずれも気に入らない場合は、次の 3 つの方法があります:** - -1. 環境変数で変更可能な場合は、環境変数を使用します (これが推奨される方法です。以下の [環境変数の表](php-fpm.md#environment-variables)\ を参照してください)。 -2. 独自の `fpm-pool` 設定を作成し、`php_admin_value` および `php_admin_flag` で設定します。 - 1. 詳細については、[`PHP を Apache モジュールとして実行するためのこのドキュメント`](https://www.php.net/manual/en/configuration.changes.php) を参照してください。このドキュメントは Apache について説明していますが、`php-fpm` にも当てはまります。 - -_重要:_ - -1. 独自の `php-fpm` プールを提供する場合は、ファイル `/usr/local/etc/php-fpm.d/www.conf` を独自の設定で上書きするか、別の名前にしたい場合はこのファイルの名前を変更します。これを行わないと、提供されたプールが起動します。 -2. [`PHP_INI_SYSTEM`変更可能モード](https://www.php.net/manual/ja/configuration.changes.modes.php)を持つPHPの値は、`fpm-pool`設定を介して変更できません。すでに提供されている環境変数または以下の方法で変更する必要があります: -3. 独自の`php.ini`または`php-fpm.conf`ファイルを提供します(これは最も好ましくない方法です)。 +| `max_execution_time = 900` | `PHP_MAX_EXECUTION_TIME` で変更可能 | +| `realpath_cache_size = 256k` | 大規模なPHPプロジェクトを扱うための設定 | +| `memory_limit = 400M` | 大規模なPHPプロジェクトを扱うための設定(`PHP_MEMORY_LIMIT` で変更可能) | +| `opcache.memory_consumption = 265` | 大規模なPHPプロジェクトを扱うための設定 | +| `opcache.enable_file_override = 1` と `opcache.huge_code_pages = 1` | より高速なPHPのための設定 | +| `display_errors = Off` と `display_startup_errors = Off` | 実用的なproduction設定 \(`PHP_DISPLAY_ERRORS` および `PHP_DISPLAY_STARTUP_ERRORS` で変更可能\)。 | +| `upload_max_filesize = 2048M` | 大容量ファイルのアップロードのための設定 | +| `apc.shm_size = 32m` と `apc.enabled = 1` | `PHP_APC_SHM_SIZE` および `PHP_APC_ENABLED` で変更可能 | + +また、`php-fpm`のエラーログは `stderr`に記録されます。 + +**💡 これらの設定のいずれも気に入らない場合は、次の3つの方法があります:** + +1. 設定値が環境変数で変更できる場合は、環境変数を使ってください(これが推奨される方法です。[環境変数の表](php-fpm.md#environment-variables)\ の詳細は以下の表にまとめてありますので、参照ください。) +2. 以下のドキュメントにある`php_admin_value`および`php_admin_flag`を使って、独自のカスタム`fpm-pool`設定を作成し、それを適用することができます。 + - 詳細については、[`PHP を Apache モジュールとして実行するためのこのドキュメント`](https://www.php.net/manual/en/configuration.changes.php) を参照してください。このドキュメントはApacheモジュールとしてのPHP実行について説明していますが、`php-fpm` にも当てはまります。

+ _重要:_ + - 独自の `php-fpm` プールを適用したい場合は、`/usr/local/etc/php-fpm.d/www.conf`ファイルを自分の設定で上書きするか、別の名前を付けたい場合はこのファイル名を変更してください。この操作を行わないと、最初から用意されているプールが起動します。 + - [`PHP_INI_SYSTEM`変更可能モード](https://www.php.net/manual/ja/configuration.changes.modes.php)のPHPの設定値は、`fpm-pool`設定では変更できません。こういった設定値は、用意されている環境変数を使うか、または: + - 独自の`php.ini`または`php-fpm.conf`ファイルを用意する必要があります(この方法は推奨されません) ## デフォルトのfpm-pool -このイメージは、`fpm-pool`設定([`php-fpm.d/www.conf`](https://github.com/uselagoon/lagoon-images/blob/main/images/php-fpm/php-fpm.d/www.conf))が付属しており、`fpm-pool`を作成し、ポート9000でリッスンします。これは、PHPのほとんどのニーズをすでにカバーしているイメージを提供しようとしているためです。もし好きなら、自分自身で作成することも歓迎します！ +このイメージは、`fpm-pool`設定ファイル([`php-fpm.d/www.conf`](https://github.com/uselagoon/lagoon-images/blob/main/images/php-fpm/php-fpm.d/www.conf))が含まれており、このファイルは`fpm-pool`を作成し、ポート9000でリッスンします。これは、ほとんどのPHPアプリケーションのニーズを最初からカバーできるようにするためです。もちろん、必要に応じて独自の設定を作成することもできます。 -このファイルが何をするかの短い説明: +このファイルの内容の説明: * IPv4とIPv6でポート9000でリッスンします。 -* pm `dynamic`を使用し、2-50の子を作成します。 -* メモリリークを防ぐために、500のリクエスト後に`php-fpm`プールの子を再生成します。 -* `/ping`へのfastcgiリクエストに`pong`で応答します(プールが起動したかどうかを自動テストで確認するのに便利)。 -* PHPのエラーを見るために`catch_workers_output = yes`。 -* `clear_env = `を使用して、通常のDocker環境変数経由でPHP環境変数を注入できます。 +* pm `dynamic`を使用し、2から50までの子プロセスを作成します。 +* メモリリークを防ぐために、500のリクエスト後に`php-fpm`プールの子プロセスを再生成します。 +* `/ping`へのfastcgiリクエストに対して`pong`で応答します(プールが起動しているかどうかの自動テストに便利)。 +* `catch_workers_output = yes`により、PHPのエラーを確認できるようにする。 +* `clear_env = no`により、通常の Docker 環境変数を使って PHP 環境変数を注入できるようにする ## 環境変数 { #environment-variables } -一部のオプションは[環境変数](../concepts-advanced/environment-variables.md)経由で設定可能です。 +一部のオプションは[環境変数](../concepts-advanced/environment-variables.md)で設定可能です。 -| 環境変数 | デフォルト | 説明 | +| 環境変数 | デフォルト | 説明 | | :----------------------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | -| NEWRELIC_ENABLED | false | NewRelicのパフォーマンスモニタリングを有効にします。`NEWRELIC_LICENSE`の設定が必要です。 | -| NEWRELIC_LICENSE | (未設定) | 使用するNewRelicのライセンス。重要:NewRelicを有効にするには`NEWRELIC_ENABLED`を`true`に設定する必要があります。 | -| NEWRELIC_BROWSER_MONITORING_ENABLED | true | これにより、NewRelicのブラウザモニタリングのためのJavaScriptフラグメントの自動挿入が有効になります。 . 重要:`NEWRELIC_ENABLED`はNewRelicを有効にするために`true`に設定する必要があります。 | -| NEWRELIC_DISTRIBUTED_TRACING_ENABLED | false | これにより分散トレーシングが有効になります。重要:`NEWRELIC_ENABLED`はNewRelicを有効にするために`true`に設定する必要があります。 | -| PHP_APC_ENABLED | 1 | [APC](https://www.php.net/manual/en/apcu.configuration.php)を無効にするために`0`に設定することができます。 | -| PHP_APC_SHM_SIZE | 32m | 与えられた各共有メモリセグメントのサイズ。 | -| PHP_DISPLAY_ERRORS | Off | エラーが表示されるか非表示にされるかを設定します。[php.netを参照してください](https://www.php.net/display-errors)。 | -| PHP_DISPLAY_STARTUP_ERRORS | Off | スタートアップエラーが表示されるか非表示にされるかを設定します。[php.netを参照してください](https://www.php.net/display-startup-errors)。 | -| PHP_ERROR_REPORTING | Production `E_ALL & ~E _DEPRECATED & ~E_STRICT` 開発: `E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE` | PHPが使用するログレベルを設定します。[php.netを参照](https://www.php.net/manual/en/function.error-reporting.php) | -| PHP_FPM_PM_MAX_CHILDREN | 50 | 子プロセスの最大数。[php.netを参照](https://www.php.net/manual/en/install.fpm.configuration.php)。 | -| PHP_FPM_PM_MAX_REQUESTS | 500 | 各子プロセスが再生成される前に実行するべきリクエストの数。[php.netを参照](https://www.php.net/manual/en/install.fpm.configuration.php)。 | -| PHP_FPM_PM_MAX_SPARE_SERVERS | 2 | アイドル状態のサーバープロセスの最大数を設定します。[php.netを参照](https://www.php.net/manual/en/install.fpm.configuration.php)。 | -| PHP_FPM_PM_MIN_SPARE_SERVERS | 2 | アイドル状態のサーバープロセスの最小数を設定します。[php.netを参照](https://www.php.net/manual/en/install.fpm.configuration.php)。 | -| PHP_FPM_PM_PROCESS_IDLE_TIMEOUT | 60s | アイドルプロセスが強制終了されるまでの秒数。[php.netを参照](https://www.php.net /manual/ja/install.fpm.configuration.php)。 | -| PHP_FPM_PM_START_SERVERS | 2 | 起動時に作成される子プロセスの数。 [php.netを参照](https://www.php.net/manual/ja/install.fpm.configuration.php)。 | -| PHP_MAX_EXECUTION_TIME | 900 | 各スクリプトの最大実行時間(秒)。 [php.netを参照](https://www.php.net/max-execution-time)。 | -| PHP_MAX_FILE_UPLOADS | 20 | 同時にアップロードできるファイルの最大数。 [php.netを参照](https://www.php.net/manual/ja/ini.core.php#ini.max-file-uploads)。 | -| PHP_MAX_INPUT_VARS | 2000 | 受け入れ可能な入力変数の数。 [php.netを参照](https://www.php.net/manual/ja/info.configuration.php#ini.max-input-vars)。 | -| PHP_MEMORY_LIMIT | 400M | スクリプトが消費できるメモリの最大量。 [php.netを参照](https://www.php.net/memory-limit)。 | +| NEWRELIC_ENABLED | false | NewRelicのパフォーマンスモニタリングを有効にします。有効にするには`NEWRELIC_LICENSE`を設定する必要がありますす。 | +| NEWRELIC_LICENSE | (設定なし) | 使用するNewRelicのライセンス。重要:NewRelicを有効にするには`NEWRELIC_ENABLED`を`true`に設定する必要があります。 | +| NEWRELIC_BROWSER_MONITORING_ENABLED | true | NewRelicブラウザ監視用のJavaScriptフラグメントの自動挿入を有効にします。重要:NewRelicを有効にするには`NEWRELIC_ENABLED`を`true`に設定する必要があります。 | +| NEWRELIC_DISTRIBUTED_TRACING_ENABLED | false | 分散トレースを有効にします。重要:NewRelicを有効にするには、`NEWRELIC_ENABLED`を`true`に設定する必要があります。 | +| PHP_APC_ENABLED | 1 | [APC](https://www.php.net/manual/en/apcu.configuration.php)を無効にするには`0`を設定します。 | +| PHP_APC_SHM_SIZE | 32m | 各共有メモリセグメントのサイズ。 | +| PHP_DISPLAY_ERRORS | Off | エラーを表示されるか非表示にするかを設定します。詳細は、[php.net](https://www.php.net/display-errors)を参照してください。 | +| PHP_DISPLAY_STARTUP_ERRORS | Off | 起動時のエラーを表示するか非表示するかを設定します。詳細は、[php.net](https://www.php.net/display-startup-errors)を参照してください。 | +| PHP_ERROR_REPORTING | Production `E_ALL & ~E _DEPRECATED & ~E_STRICT` Development: `E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE` | PHPに使用されるdesired loggingレベルを設定します。詳細は、[php.net](https://www.php.net/manual/en/function.error-reporting.php)を参照してください。 | +| PHP_FPM_PM_MAX_CHILDREN | 50 | 子プロセスの最大数。詳細は、[php.net](https://www.php.net/manual/en/install.fpm.configuration.php)を参照。 | +| PHP_FPM_PM_MAX_REQUESTS | 500 | 各子プロセスが再生成される前に実行するべきリクエストの数。詳細は、[php.net](https://www.php.net/manual/en/install.fpm.configuration.php)を参照してください。 | +| PHP_FPM_PM_MAX_SPARE_SERVERS | 2 | アイドル状態のサーバープロセスの最大許容数を設定します。詳細は、[php.net](https://www.php.net/manual/en/install.fpm.configuration.php)を参照してください。 | +| PHP_FPM_PM_MIN_SPARE_SERVERS | 2 | アイドル状態のサーバープロセスの最小許容数を設定します。詳細は、[php.net](https://www.php.net/manual/en/install.fpm.configuration.php)を参照してください。 | +| PHP_FPM_PM_PROCESS_IDLE_TIMEOUT | 60s | アイドル状態のプロセスが終了されるまでの秒数。詳細は、[php.net](https://www.php.net /manual/ja/install.fpm.configuration.php)を参照してください。 | +| PHP_FPM_PM_START_SERVERS | 2 | 起動時に作成される子プロセスの数。詳細は、[php.net](https://www.php.net/manual/ja/install.fpm.configuration.php)を参照してください。 | +| PHP_MAX_EXECUTION_TIME | 900 | 各スクリプトの最大実行時間(秒)。詳細は、[php.net](https://www.php.net/max-execution-time)を参照してください。 | +| PHP_MAX_FILE_UPLOADS | 20 | 同時にアップロードできるファイルの最大数。詳細は、[php.net](https://www.php.net/manual/ja/ini.core.php#ini.max-file-uploads)を参照してください。 | +| PHP_MAX_INPUT_VARS | 2000 | 受け入れ可能な入力変数の数。詳細は、[php.net](https://www.php.net/manual/ja/info.configuration.php#ini.max-input-vars)を参照してください。 | +| PHP_MEMORY_LIMIT | 400M | スクリプトが消費できるメモリの最大量。詳細は、[php.net](https://www.php.net/memory-limit)を参照してください。 | | XDEBUG_ENABLE | (設定なし) | `xdebug` 拡張機能を有効にするには、`true`に設定します。 | -| BLACKFIRE_ENABLED | (設定されていません) | `blackfire` 拡張機能を有効にするには `true` に設定します。 | -| BLACKFIRE_SERVER_ID | (設定されていません) | Blackfire.io から提供されている Blackfire サーバー ID に設定します。`BLACKFIRE_ENABLED` を `true` に設定する必要があります。 | -| BLACKFIRE_SERVER_TOKEN | (設定されていません) | Blackfire.io から提供されている Blackfire サーバートークンに設定します。`BLACKFIRE_ENABLED` を `true` に設定する必要があります。 | -| BLACKFIRE_LOG_LEVEL | 3 | blackfire エージェントのログレベルを変更します。利用可能な値:`ログの冗長性レベル (4: デバッグ, 3: 情報, 2: 警告, 1: エラー)` [blackfire.ioを参照](https://blackfire.io/docs/up-and-running/configuration/agent)。 | +| BLACKFIRE_ENABLED | (設定なし) | `blackfire` 拡張機能を有効にするには `true` に設定します。 | +| BLACKFIRE_SERVER_ID | (設定なし) | Blackfire.ioが提供するBlackfireサーバーID。`BLACKFIRE_ENABLED`を`true`に設定する必要があります。 | +| BLACKFIRE_SERVER_TOKEN | (設定なし) | Blackfire.ioが提供するBlackfireサーバートークン。`BLACKFIRE_ENABLED`を`true`に設定する必要があります。 | +| BLACKFIRE_LOG_LEVEL | 3 | blackfireエージェントのログレベルを変更します。利用可能な値:`ログの冗長性レベル (4: デバッグ, 3: 情報, 2: 警告, 1: エラー)` 詳細は、[blackfire.io](https://blackfire.io/docs/up-and-running/configuration/agent)を参照して下さい。 | diff --git a/docs/ja/docker-images/postgres.md b/docs/ja/docker-images/postgres.md index 233b5a5a94..c8fd8a97f5 100644 --- a/docs/ja/docker-images/postgres.md +++ b/docs/ja/docker-images/postgres.md @@ -1,6 +1,6 @@ # PostgreSQL -[Lagoon PostgreSQL Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/postgres)。[公式PostgreSQL Alpineイメージ](https://hub.docker.com/_/postgres)を基にしています。 +[Lagoon PostgreSQL Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/postgres)。[公式PostgreSQL Alpineイメージ](https://hub.docker.com/_/postgres)をベースに作成されています。 ## サポートされているバージョン { #supported-versions } @@ -9,16 +9,17 @@ * 13 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/postgres/13.Dockerfile) (2025年11月までのセキュリティサポート) - `uselagoon/postgres-13` * 14 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/postgres/14.Dockerfile) (2026年11月までのセキュリティサポート) - `uselagoon/postgres-14` * 15 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/postgres/15.Dockerfile) (2027年11月までのセキュリティサポート) - `uselagoon/postgres-15` -* 16 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/postgres/16.Dockerfile) (11月までのセキュリティサポート) 2028) - `uselagoon/postgres-16` +* 16 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/postgres/16.Dockerfile) (2028年11月までのセキュリティサポート) - `uselagoon/postgres-16` !!! Tip "ヒント" - Lagoonリリースが公式に通知されたEOL日付の後に、通常、EOL PostgreSQLイメージの更新を停止します:[https://www.postgresql.org/support/versioning](https://www.postgresql.org/support/versioning/) + Lagoonは、公式にアナウンスされた終了日(EOL)の後にリリースされるバージョンで、EOLに達したPostgreSQLイメージの更新を停止します。詳細は[https://www.postgresql.org/support/versioning](https://www.postgresql.org/support/versioning/)を参照して下さい。 ## Lagoonの適応 { #lagoon-adaptions } Postgresコンテナのデフォルトの公開ポートはポート`5432`です。 -LagoonがPostgresコンテナを最適な方法で実行できるようにするためには、`lagoon.type: postgres`を使用してください。これにより、クラスタ内で利用可能な場合にDBaaSオペレータがクラウドデータベースをプロビジョニングできます。コンテナ内のPostgresを特にリクエストするには、`lagoon.type: postgres-single`を使用してください。永続的なストレージは常に、/var/lib/postgresql/dataでpostgresコンテナにプロビジョニングされます。 +LagoonがPostgresコンテナの実行方法を最適に選択できるようにするには、`lagoon.type: postgres`を使用します。これにより、DBaaSオペレーターは、クラスター内で利用可能な場合、クラウドデータベースをプロビジョニングできます。コンテナ内でPostgresを確実に実行したい場合は、`lagoon.type: postgres-single`を使用してください。Postgresコンテナに対しては、永続ストレージが常に`/var/lib/postgresql/data`にプロビジョニングされます。 + ## `docker-compose.yml` スニペット { #docker-composeyml-snippet } @@ -26,20 +27,20 @@ LagoonがPostgresコンテナを最適な方法で実行できるようにする postgres: image: uselagoon/postgres-14-drupal:latest labels: - # LagoonにこれがPostgresデータベースであることを伝える + # LagoonにPostgresのデータベースであることを伝える lagoon.type: postgres ports: - # ポート5432をランダムなローカルポートで公開する + # ポート5432をランダムなローカルポートで公開し、 # `docker-compose port postgres 5432`で見つけることができる - "5432" volumes: - # Postgresのデフォルトパスに名前付きボリュームをマウントする + # Postgres用のデフォルトパスに名前付きボリュームをマウントする - db:/var/lib/postgresql/data ``` ## ヒント＆コツ -SQLがある場合 コンテナの起動直後にデータベースを初期化するために実行する必要があるステートメントは、その `.sql` ファイルをコンテナの `docker-entrypoint-initdb.d` ディレクトリに配置できます。そのディレクトリに含まれる任意の `.sql` ファイルは、PostgreSQLコンテナを起動する一部として自動的に起動時に実行されます。 +コンテナ起動直後にデータベースを初期化するためのSQLステートメントがある場合、それらの`.sql`ファイルをコンテナの`docker-entrypoint-initdb.d`ディレクトリに配置することができます。このディレクトリにある `.sql` ファイルは、PostgreSQLコンテナの起動時に自動的に実行され、データベースの初期化処理の一部として動作します。 !!! Warning "警告" - これらのスクリプトは、コンテナが空のデータベースで開始された場合にのみ実行されます。 + これらのスクリプトは、空のデータベースでコンテナが起動された場合にのみ実行されます。既存のデータベースに対しては動作しません。 diff --git a/docs/ja/docker-images/python.md b/docs/ja/docker-images/python.md index 40ecad6b4c..1b7bab0ad2 100644 --- a/docs/ja/docker-images/python.md +++ b/docs/ja/docker-images/python.md @@ -1,53 +1,53 @@ # Python -[Lagoon `python` Docker image](https://github.com/uselagoon/lagoon-images/tree/main/images/python)。これは[公式のPython Alpineイメージ](https://hub.docker.com/_/python/)に基づいています。 +[Lagoon `python` Docker image](https://github.com/uselagoon/lagoon-images/tree/main/images/python)。これは[公式のPython Alpineイメージ](https://hub.docker.com/_/python/)をベースに作成されています。 ## サポートされているバージョン { #supported-versions } -* 2.7 \(互換性のためのみで、公式にはもうサポートされていません\) - `uselagoon/python-2.7` -* 3.7 \(互換性のためのみで、公式にはもうサポートされていません\) - `uselagoon/python-3.7` +* 2.7 \(互換性のためのみ利用可能、公式サポートは終了しています\) - `uselagoon/python-2.7` +* 3.7 \(互換性のためのみ利用可能、公式サポートは終了しています\) - `uselagoon/python-3.7` * 3.8 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/python/3.8.Dockerfile) (2024年10月までセキュリティサポート) - `uselagoon/python-3.8` * 3.9 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/python/3.9.Dockerfile) (2025年10月までセキュリティサポート) - `uselagoon/python-3.9` * 3.10 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/python/3.10.Dockerfile) (2026年10月までセキュリティサポート) - `uselagoon/python-3.10` * 3.11 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/python/3.11.Dockerfile) (2027年10月までセキュリティサポート) - `uselagoon/python-3.11` -* 3.12 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/python/3.12.Dockerfile) (セキュリティ 2028年10月までのサポート)- `uselagoon/python-3.12` +* 3.12 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/python/3.12.Dockerfile) (2028年10月までセキュリティサポート)- `uselagoon/python-3.12` !!! Tip "ヒント" - 私たちは通常、公式に通知されたEOL日付の後に来るLagoonリリースとともにEOL Pythonイメージの更新と公開を停止します:[https://devguide.python.org/versions/#versions](https://devguide.python.org/versions/#versions)。以前に公開されたバージョンは引き続き利用可能です。 + Lagoonは、公式にアナウンスされた終了日(EOL)の後にリリースされるバージョンで、EOLに達したPythonイメージの更新を停止します。詳細は[https://devguide.python.org/versions/#versions](https://devguide.python.org/versions/#versions)を参照して下さい。 ## Lagoonの適応 { #lagoon-adaptions } Pythonコンテナのデフォルトの公開ポートはポート`8800`です。 -永続的なストレージは、`lagoon.type: python-persistent`を使用してLagoonで設定可能です。詳細については[ドキュメント](../concepts-basics/docker-compose-yml.md#persistent-storage)をご覧ください。 +Lagoonでは、`lagoon.type: python-persistent`を使用して永続的なストレージを設定可能です。詳細については[ドキュメント](../concepts-basics/docker-compose-yml.md#persistent-storage)を参照ください。 -次のラベルを`docker-compose.yml`ファイルで使用して設定します: -`lagoon.persistent` = これを使用して、永続的なストレージとして使用するコンテナ内のパスを定義します - 例えば/app/files -`lagoon.persistent.size` = これを使用してLagoonにこのパスにどれだけのストレージを割り当てるかを伝えます。 +永続的なストレージを設定するには、`docker-compose.yml`ファイルで以下のラベルを使用します: +`lagoon.persistent` = コンテナ内の永続ストレージとして使用するパスを定義します - 例えば/app/files +`lagoon.persistent.size` = Lagoonに対して、このパスに割り当てるストレージ容量を指定します。 同じストレージを共有する複数のサービスがある場合は、これを使用します -`lagoon.persistent.name` =(オプション)これを使用してLagoonに別の名前付きサービスで定義されたストレージを使用するように伝えます。 +`lagoon.persistent.name` =(オプション)複数のサービスが同じストレージを共有する場合、別の名前付きサービスで定義されたストレージを使用するようにLagoonに指示します。 ## `docker-compose.yml` スニペット { #docker-composeyml-snippet } ```yaml title="docker-compose.yml" python: build: - # これはビルドを設定します ルートフォルダにあるDockerfile + # ルートフォルダにあるDockerfileを使用してビルドを行うように設定します。 context: . dockerfile: Dockerfile labels: - # Lagoonにこれがpythonサービスであり、/app/filesに500MBの永続的なストレージが設定されていることを伝えます + # Lagoonに対し、Pythonサービスであることと、/app/filesに500MBの永続ストレージを設定します。 lagoon.type: python-persistent lagoon.persistent: /app/files lagoon.persistent.size: 500Mi ports: - # ローカル開発のみ - # 8800ポートをランダムなローカルポートで公開します - # `docker-compose port python 8800`で見つけることができます + # ローカル開発のみ適用される設定です + # ポート8800をランダムなローカルポートにマッピングし、 + # `docker-compose port node 8800`でポートを確認することができます。 - "8800" volumes: - # ローカル開発のみ - # このサービスの定義されたパスで名前付きボリューム(ファイル)をマウントし、本番環境を再現します + # ローカル開発のみ適用される設定です + # filesという名前のボリュームを定義されたパスにをマウントします。これは、本番環境と同じ状態を再現するためにローカル開発環境で利用されます。 - files:/app/files ``` diff --git a/docs/ja/docker-images/rabbitmq.md b/docs/ja/docker-images/rabbitmq.md index 812d928bcb..d48721ea6b 100644 --- a/docs/ja/docker-images/rabbitmq.md +++ b/docs/ja/docker-images/rabbitmq.md @@ -1,28 +1,28 @@ # RabbitMQ -管理プラグインがインストールされた[Lagoon RabbitMQ Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/rabbitmq/Dockerfile)。公式の `rabbitmq:3-management` イメージに基づいています。[docker-hub](https://hub.docker.com/_/rabbitmq)でご確認いただけます。 +[Lagoon RabbitMQ Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/rabbitmq/Dockerfile)で、管理プラグインがインストールされています。[docker-hub](https://hub.docker.com/_/rabbitmq)にある公式の`rabbitmq:3-management`イメージをベースにしています。 -このDockerfileは、スタンドアロンのRabbitMQキューブローカーをセットアップするため、またデフォルトで高可用性キューサポート付きのクラスタをセットアップするためのベースイメージとして使用することを目的としています([ミラーリングキュー](https://www.rabbitmq.com/ha.html)参照)。 +このDockerfileは、スタンドアロンのRabbitMQキューブローカーをセットアップするためだけでなく、デフォルトで高可用性キューサポート([ミラーリングキュー](https://www.rabbitmq.com/ha.html))を備えたクラスタをセットアップするためのベースイメージとしても使用できます。 -デフォルトでは、RabbitMQブローカーは単一ノードとして起動します。クラスタを起動する場合は、`rabbitmq`イメージに加えて`rabbitmq_peer_discovery_k8s`プラグインを使用した[`rabbitmq-cluster`](https://github.com/uselagoon/lagoon-images/blob/main/images/rabbitmq-cluster/Dockerfile) Dockerイメージを使用する必要があります。 +デフォルトでは、RabbitMQブローカーはシングルノードで起動します。クラスタを起動する場合は、`rabbitmq`イメージに加えて`rabbitmq_peer_discovery_k8s`プラグインが組み込まれた[`rabbitmq-cluster`](https://github.com/uselagoon/lagoon-images/blob/main/images/rabbitmq-cluster/Dockerfile) Dockerイメージを使用する必要があります。 ## サポートされるバージョン -* 3.10 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/rabbitmq/Dockerfile) (2023年7月までセキュリティサポートあり) - `uselagoon/rabbitmq` +* 3.10 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/rabbitmq/Dockerfile) (2023年7月までセキュリティサポート) - `uselagoon/rabbitmq` ## Lagoonの適応 { #lagoon-adaptions } -このイメージはLagoonで使用するために準備されています。したがって、すでにいくつかの事項が完了しています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダの権限は、[`fix-permissions`](https://github.com/usel agoon/lagoon-images/blob/main/images/commons/fix-permissions)、ランダムなユーザーと一緒にこのイメージが動作します。 -* ファイル`/etc/rabbitmq/definitions.json`は、[`envplate`](https://github.com/kreuzwerker/envplate)を通じてパースされ、コンテナエントリーポイントになります。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 +* `/etc/rabbitmq/definitions.json`は、コンテナエントリーポイントを持つ[`envplate`](https://github.com/kreuzwerker/envplate)を通して処理されます。 -## デフォルトのRabbitMQスキーマ(definitions.json)が含まれています +## RabbitMQデフォルトスキーマ(definitions.json) -* ミラーリングキューのサポートを有効にするには、少なくとも一つの[`policy`](https://www.rabbitmq.com/parameters.html#policies)が存在しなければなりません。 -* `definitions.json`スキーマファイルでは、コンテナの実行に必要な最小限のエンティティが定義されています: `virtualhost`(`vhost`)、`username`、管理UIへの`password`、`permissions`、`policies`。 +* ミラーリングキューのサポートするには、少なくとも一つの[`policy`](https://www.rabbitmq.com/parameters.html#policies)が必要です。 +* `definitions.json`スキーマファイルには、コンテナの実行、`virtualhost`(`vhost`)、管理UIにアクセスするための`username`、`password`、`permissions`、`policies`を設定するための最小限のエンティティが定義されています。 -デフォルトでは、起動時に`lagoon-ha`というポリシーが作成されますが、キューの名前パターンと一致しないためアクティブではありません(デフォルトの[環境変数](rabbitmq.md#environment-variables)を参照)。 +デフォルトでは、起動時に`lagoon-ha`という名前のポリシーが作成されますが、デフォルトの[環境変数](rabbitmq.md#environment-variables)で設定されているキュー名のパターンに一致しないため、アクティブではありません。 ```javascript title="definitions.json" "policies":[ @@ -30,17 +30,17 @@ ] ``` -デフォルトでは、`ha-mode`は`exactly`に設定されており、これは キュー(ミラーズ)のミラーリングノードの正確な数。 ノードの数は `ha-params` で制御されます。 +デフォルトでは、`ha-mode`は`exactly`に設定されており、キュー(mirrors)のミラーリングノードの正確な数を制御します。ノードの数は `ha-params` で制御されます。 -詳細な情報やカスタム設定については、[公式の RabbitMQ ドキュメンテーション](https://www.rabbitmq.com/ha.html)を参照してください。 +詳細な情報やカスタム設定については、[公式の RabbitMQ ドキュメント](https://www.rabbitmq.com/ha.html)を参照してください。 ## 環境変数 { #environment-variables } -いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)を通じて設定可能です。 +いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)で設定可能です。 | 環境変数 | デフォルト | 説明 | | :------------------------- | :--------- | :---------------------------------------- | -| RABBITMQ_DEFAULT_USER | guest | 管理UIへのアクセス用のユーザ名。 | -| RABBITMQ_DEFAULT_PASS | guest | 管理UIへのアクセス用のパスワード。 | -| RABBITMQ_DEFAULT_VHOST | / | RabbitMQのメインの仮想ホスト。 | -| RABBITMQ_DEFAULT_HA_PATTERN| ^$ | ミラーリングキューにマッチする正規表現。 | +| RABBITMQ_DEFAULT_USER | guest | 管理UIへのアクセス用のユーザ名 | +| RABBITMQ_DEFAULT_PASS | guest | 管理UIへのアクセス用のパスワード | +| RABBITMQ_DEFAULT_VHOST | / | RabbitMQのメインの仮想ホスト | +| RABBITMQ_DEFAULT_HA_PATTERN| ^$ | ミラーリングされたキューを一致させるための正規表現 | diff --git a/docs/ja/docker-images/redis.md b/docs/ja/docker-images/redis.md index 00c692d1ad..8369aba3ce 100644 --- a/docs/ja/docker-images/redis.md +++ b/docs/ja/docker-images/redis.md @@ -1,104 +1,104 @@ # Redis -[Lagoon `Redis`イメージDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/redis) は、[公式 `redis:alpine`イメージ](https://hub.docker.com/_/redis/)を元にしています。 +[Lagoon `Redis`イメージDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/redis) は、[公式 `redis:alpine`イメージ](https://hub.docker.com/_/redis/)をベースに作成されています。 -このDockerfileは、デフォルトでスタンドアロンのRedis _エフェメラル_ サーバーをセットアップするために使用することを意図しています。 +このDockerfileは、デフォルトでスタンドアロンのRedis _ephemeral_ サーバーをセットアップするために使用することを想定しています。 ## サポートされているバージョン { #supported-versions } -* 5(互換性のためのみ利用可能、公式にはもはやサポートされていません) - `uselagoon/redis-5`または`uselagoon/redis-5-persistent` +* 5(互換性のためのみ利用可能、公式サポートは終了しています) - `uselagoon/redis-5`または`uselagoon/redis-5-persistent` * 6 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/redis/6.Dockerfile) - `uselagoon/redis-6`または`uselagoon/redis-6-persistent` * 7 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/redis/7.Dockerfile) - `uselagoon/redis-7`または`uselagoon/redis-7-persistent` ## 使用方法 -Redisイメージには2つの異なるバリエーションがあります:**エフェメラル** と **パーシステント**。 +Redisイメージには、**Ephemeral(一時的)**と**Persistent(永続的)**の2種類のタイプがあります。 -### エフェメラル +### Ephemeral(一時的) -エフェメラルイメージは、アプリケーションのインメモリキャッシュとして使用することを意図しており、コンテナの再起動を越えてデータを保持しません。 +Ephemeralイメージは、アプリケーションの一時的なキャッシュとして使用されることを想定しており、コンテナを再起動してもデータは保持されません。 -インメモリ(RAM)キャッシュとして使用する場合、大きなキャッシュを持っている場合に最初に調整したいかもしれないことは、`MAXMEMORY`変数を適応させることです。この変数は、どの程度の最大メモリ(RAM)を制御します。 Redisはキャッシュアイテムの保存に使用します。 +メモリ内(RAM)キャッシュとして使用する場合、大きなキャッシュを扱う場合は、最初に調整したいのが`MAXMEMORY`変数です。この変数は、Redisがキャッシュされたアイテムを保存するために使用するメモリ(RAM)の最大量を制御します。 -### 永続的 +### Persistent (永続的) -永続的なRedisイメージは、コンテナの再起動を越えてデータを永続化し、永続性が必要なキューまたはアプリケーションデータに使用できます。 +PersistentなRedisイメージは、コンテナを再起動してもデータを保持し、キューや永続化が必要なアプリケーションデータに使用できます。 -通常、メモリ内キャッシュのシナリオで永続的なRedisを使用することはお勧めしません。これは、Redisコンテナが再起動し、ディスクからデータをロードしているときに、アプリケーションに予期しない副作用をもたらす可能性があるからです。 +Redisコンテナが再起動してディスクからデータを読み込む間はアプリケーションに予期しない副作用が生じる可能性があるため、通常はメモリ内キャッシュのシナリオでPersistent Redisを使用するようにはお勧めしません。 ## Lagoonの適応 { #lagoon-adaptions } -このイメージはLagoonで使用するために準備されています。したがって、すでにいくつかのことが行われています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)を使用して自動的に適応されるため、このイメージはランダムなユーザーで動作します。 -* `/etc/redis/*`内のファイルは、コンテナエントリーポイント経由で[`envplate`](https://github.com/kreuzwerker/envplate)を使用してテンプレート化されます。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 +* `/etc/redis/*`内のファイルは、コンテナエントリーポイントを通して[`envplate`](https://github.com/kreuzwerker/envplate)を使用してテンプレート化されています。 -## 含まれる `redis.conf` 設定ファイル +## `redis.conf` 設定ファイル -このイメージには、Lagoonで動作するように最適化された _default_ Redis設定ファイルが含まれています。 +このイメージには、Lagoonで動作するように最適化された _デフォルト_ のRedis設定ファイルが含まれています。 ### 環境変数 { #environment-variables } -一部のオプションは[環境変数](../concepts-advanced/environment-variables.md)を介して設定可能です。 +一部のオプションは[環境変数](../concepts-advanced/environment-variables.md)で設定可能です。 | 環境変数 | デフォルト | 説明 | | :------------------- | :---------- | :----------------------------------------------------------------------------------------- | -| データベース | -1 | スタートアップ時に作成されるデータベースのデフォルト数。 | -| ログレベル | 通知 | ログのレベルを定義します。 | -| 最大メモリ使用量 | 100mb | メモリの最大使用量。 | -| 最大メモリポリシー | allkeys-lru | Redisが最大メモリ使用量に達したときにキーを追い出すためのポリシー。 | +| データベース | -1 | 起動時に作成されるデータベースのデフォルト数(-1は無制限) | +| ログレベル | 通知 | ログのレベルを定義します | +| 最大メモリ使用量 | 100mb | 最大メモリ容量 | +| 最大メモリポリシー | allkeys-lru | Redisが最大メモリ使用量に達したときにキーを追い出すためのポリシー | | REDIS_PASSWORD | 無効 | [認証機能](https://redis.io/topics/security#authentication-feature)を有効にします。 | ## カスタム設定 ベースイメージに基づいて、カスタム設定を含めることができます。 -Redis設定ファイルの完全なドキュメンテーションについては、[こちら](https://github.com/redis/redis/blob/7.2.5/redis.conf)をご覧ください。 +Redis設定ファイルの詳細なドキュメントについては、[こちら](https://github.com/redis/redis/blob/7.2.5/redis.conf)を参照ください。 -## Redis-persistent +## Redis 永続化 -以下に基づいています [Lagoonの `redis`イメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/redis/6.Dockerfile)、[Lagoonの `redis-persistent` Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/redis-persistent/6.Dockerfile)は、Redisサービスを`persistent`モード(つまり、キーがディスクに保存される永続化ボリュームで)で利用する場合に使われます。 +[Lagoonの `redis`イメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/redis/6.Dockerfile)をベースにした[Lagoonの `redis-persistent` Dockerイメージ](https://github.com/uselagoon/lagoon-images/blob/main/images/redis-persistent/6.Dockerfile)は、Redisサービスを`persistent`モードで使用する場合(つまり、キーがディスクに保存される永続化ボリュームを使用する場合)に使用されます。 -これは`redis`との違いは、`FLAVOR`環境変数だけで、それは使用中のredisのバージョンにより、[それぞれのRedis設定](https://github.com/uselagoon/lagoon-images/tree/main/images/redis/conf)を使用します。 +`redis`との違いは、`FLAVOR`環境変数のみです。これは、使用されるredisのバージョンに応じて、[それぞれのRedis設定](https://github.com/uselagoon/lagoon-images/tree/main/images/redis/conf)を使用します。 ## トラブルシューティング -LagoonのRedisイメージにはすべて`redis-cli`コマンドが事前にロードされており、これによりRedisサービスに情報を問い合わせたり、設定値を動的に設定したりできます。このユーティリティを使用するには、[ここ](../interacting/ssh.md)の指示に従って`pod`の値として`redis`を使用してRedisポッドにSSH接続し、接続したらターミナルから実行します。 +LagoonのRedisイメージにはすべて`redis-cli`コマンドが事前にロードされています。これを使用して、Redis サービスに情報を問い合わせたり、設定値を動的に設定することができます。このユーティリティを使用するには、[ここ](../interacting/ssh.md)の手順を使用して、`pod`値として`redis`を指定してRedisポッドにSSHで接続し、接続したらターミナルから実行するだけです。 ### 最大メモリポリシー -デフォルトでは、Lagoonの`redis`イメージは`allkeys-lru`ポリシーを使用するように設定されています。このポリシーでは、Redisに格納された**任意の**キーが、もし/ Redisサービスが、最近最も使用されていないキーに基づいて`maxmemory`制限に達した場合。 +デフォルトでは、Lagoon`redis`イメージは`allkeys-lru`ポリシーを使用するように設定されています。このポリシーは、Redisサービスが`maxmemory`制限に達した場合、最後に使用されたキーから順に、Redisに保存されている**任意の**キーを追い出すことを許可します。 -典型的なインストールでは、これが理想的な設定であり、DrupalがRedisでキャッシュされた各キーに`TTL`値を設定しない場合があります。 `maxmemory-policy`が`volatile-lru`のように設定されていて、Drupalがこれらの`TTL`タグを提供しない場合、これはRedisコンテナが埋まり、**いかなる**キーも追い出すことが完全にできなくなり、新しいキャッシュキーを全く受け付けなくなる結果となります。 +一般的なインストールでは、DrupalがRedisにキャッシュされた各キーに`TTL`値を設定しない場合があるため、これが理想的な設定です。`maxmemory-policy`が`volatile-lru`のようなものに設定されていて、Drupalがこれらの`TTL`タグを提供しない場合、Redisコンテナがいっぱいになり、**任意の**キーの追い出しが完全にできなくなり、新しいキャッシュキーの受け入れも完全に停止してしまいます。 -Redisのmaxmemoryポリシーについての詳細情報は、Redisの[公式ドキュメンテーション](https://redis.io/docs/manual/eviction/#eviction-policies)で確認できます。 +Redisのmaxmemoryポリシーについての詳細情報は、Redisの[公式ドキュメント](https://redis.io/docs/manual/eviction/#eviction-policies)を参照して下さい。 !!! Danger "注意して進めてください" - この設定を変更すると、Redisが完全にいっぱいになり、結果として停電を引き起こす可能性があります。 + この設定を変更すると、Redisが完全にいっぱいになり、結果として障害が発生する可能性があります。 ### Redisの`maxmemory`値の調整 -Redisに与えるメモリの最適量を見つけるのはかなり難しい作業です。Redisキャッシュのメモリサイズを調整しようとする前に、実際にはできるだけ長い時間、通常通りに稼働させることが賢明です。理想的な最小期間は、少なくとも1日間の典型的な使用です。 +Redisに割り当てる最適なメモリ量を見つけるのは、なかなか難しい作業です。Redisキャッシュのメモリサイズを調整する前に、通常通りの使用で、少なくとも1日間は通常通りに実行させるのが賢明です。 -これらのメモリ値を調整する際に考慮すべきいくつかの高レベルの事項があります: +これらのメモリ値を調整する際に、いくつかの高レベルなポイントがあります： -* 最初に確認するべきことは 現在Redisが使用しているメモリの割合。 - * この割合が`50％`未満の場合は、`maxmemory`の値を25％下げることを検討してみてください。 - * この割合が`50％`と`75％`の間であれば、問題なく稼働しています。 - * この値が`75％`を超える場合、他の変数を見て`maxmemory`を増やす必要があるかどうか確認する価値があります。 -* Redisのメモリ使用率が高いと判断した場合、次に見るべきはキーの追い出し数です。 - * 大量のキー追い出しとメモリ使用率が`95％`を超えると、Redisが`maxmemory`設定を高くする必要があることをかなりよく示しています。 - * キーの追い出し数が多くなく、通常の応答時間が妥当であれば、これは単にRedisがその割り当てられたメモリを期待通りに管理していることを示しています。 +* 最初に確認するべきことは 現在Redisが使用しているメモリの割合です。 + * この割合が`50％`未満の場合は、`maxmemory`の値を25％減らすことを検討してください。 + * この割合が`50％`から`75％`の間であれば、問題なく稼働しています。 + * この値が`75％`を超える場合、`maxmemory`を増やす必要があるかどうか、他の変数を確認する価値があります。 +* Redisのメモリ使用率が高いと判断した場合、次にキーの追い出し回数を確認して下さい。 + * キーの追い出し回数が多く、メモリ使用率が`95％`を超えている場合は、Redisの`maxmemory`設定を高くする必要があることを示しています。 + * キーの追い出し回数が多くないようで、応答時間が妥当な場合は、単に Redis が割り当てられたメモリを想定通りに管理していることを示しています。 -### 例のコマンド +### コマンド例 -以下のコマンドは、Redisサービスに関する情報を表示するために使用できます: +以下のコマンドを使用して、Redisサービスに関する情報を取得できます: * Redisサービスに関するすべての情報を表示:`redis-cli info` * サービスのメモリ情報を表示:`redis-cli info memory` * サービスのキースペース情報を表示:`redis-cli info keyspace` * サービスの統計情報を表示:`redis-cli info stats` -また、値を設定することも可能です Redisサービスを再起動せずに動的に設定することができます。動的に設定したこれらの値は、ポッドが再起動されると(デプロイメント、メンテナンス、あるいは単に一つのノードから別のノードへの移動の結果として起こり得る)永続化されません。 +Redisサービスの値を、Redisサービスを再起動せずに動的に設定することもできます。 ただし、これらの動的に設定された値は、ポッドが再起動した場合 (デプロイ、メンテナンス、または単にノード間でシャッフルされた場合に発生する可能性があります) には永続化されないことに注意してください。 -* `maxmemory`の設定値を動的に`500mb`に設定する: `config set maxmemory 500mb` -* `maxmemory-policy`の設定値を動的に`volatile-lru`に設定する: `config set maxmemory-policy volatile-lru` +* `maxmemory`設定値を動的に`500mb`に設定: `config set maxmemory 500mb` +* `maxmemory-policy`設定値を動的に`volatile-lru`に設定: `config set maxmemory-policy volatile-lru` diff --git a/docs/ja/docker-images/ruby.md b/docs/ja/docker-images/ruby.md index 169f5d2c5d..84c7adfb23 100644 --- a/docs/ja/docker-images/ruby.md +++ b/docs/ja/docker-images/ruby.md @@ -1,6 +1,7 @@ # Ruby -[Lagoon `ruby` Dockerイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/ruby)。[公式のPython Alpineイメージ](https://hub.docker.com/_/ruby/)に基づいています。 +[Lagoon `ruby` Dockerイメージ](https://github.com/uselagoon/lagoon-images/tree/main/images/ruby)。[公式のPython Alpineイメージ](https://hub.docker.com/_/ruby/)をベースに作成されています。 + ## サポートされているバージョン { #supported-versions } @@ -9,20 +10,20 @@ * 3.2 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/ruby/3.2.Dockerfile) (2026年3月までのセキュリティサポート) - `uselagoon/ruby-3.2` !!! Tip "ヒント" - Lagoonは、公式に通知されたEOL日付の後にリリースされるLagoonリリースとともに、通常EOL Rubyイメージの更新と公開を停止します:[https://www.ruby-lang.org/en/downloads/releases/](https://www.ruby-lang.org/en/downloads/releases/)。以前のバージョンは利用可能なままです。 + Lagoonは、公式にアナウンスされた終了日(EOL)の後にリリースされるバージョンで、EOLに達したRubyイメージの更新を停止します。詳細は[https://www.ruby-lang.org/en/downloads/releases/](https://www.ruby-lang.org/en/downloads/releases/)を参照して下さい。 ## Lagoonの適応 { #lagoon-adaptions } rubyコンテナのデフォルトの公開ポートはポート`3000`です。 -LagoonにはRubyサービスの「事前定義された」タイプはありません。それらは`lagoon.type: generic`とポートを`lagoonで設定する必要があります。 `.port: 3000` +LagoonにはRubyサービス専用の事前定義された型はありません。`lagoon.type: generic`を使用して構成し、lagoon.port: 3000 でポートを設定する必要があります。 ## `docker-compose.yml` スニペット { #docker-composeyml-snippet } ```yaml title="docker-compose.yml" ruby: build: - # これは、ルートフォルダのDockerfileからのビルドを設定します + # ルートフォルダにあるDockerfileを使用してビルドを行うように設定します。 context: . dockerfile: Dockerfile labels: @@ -30,8 +31,8 @@ ruby: lagoon.type: generic lagoon.port: 3000 ports: - # ローカル開発のみ - # これはポート3000をランダムなローカルポートで公開します - # `docker-compose port ruby 3000`で見つけることができます + # ローカル開発のみ適用される設定です + # ポート3000をランダムなローカルポートにマッピングし、 + # `docker-compose port node 3000`でポートを確認することができます。 - "3000" ``` diff --git a/docs/ja/docker-images/solr.md b/docs/ja/docker-images/solr.md index 2246c14d86..05d7db7928 100644 --- a/docs/ja/docker-images/solr.md +++ b/docs/ja/docker-images/solr.md @@ -1,24 +1,24 @@ # Solr -[Lagoon `Solr`イメージのDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/solr/7.Dockerfile)。公式の[`solr:-alpine`イメージ](https://hub.docker.com/_/solr)を基にしています。 +[Lagoon `Solr`イメージのDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/solr/7.Dockerfile)。公式の[`solr:-alpine`イメージ](https://hub.docker.com/_/solr)をベースに作成されています。 -このDockerfileは、初期コア`mycore`を持つスタンドアロンのSolrサーバーをセットアップするために使用することを意図しています。 +このDockerfileは、初期コア`mycore`を持つスタンドアロンのSolrサーバーをセットアップするために使用されます。 ## サポートされているバージョン { #supported-versions } -* 5.5 \(互換性のために利用可能、公式サポートは終了\) -* 6.6 \(互換性のために利用可能、公式サポートは終了\) -* 7.7 \(互換性のために利用可能、公式サポートは終了\) +* 5.5 \(互換性のためのみ利用可能、公式サポートは終了しています\) +* 6.6 \(互換性のためのみ利用可能、公式サポートは終了しています\) +* 7.7 \(互換性のためのみ利用可能、公式サポートは終了しています\) * 7 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/solr/7.Dockerfile) - `uselagoon/solr-7` * 8 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/solr/8.Dockerfile) - `uselagoon/solr-8` ## Lagoonの適応 { #lagoon-adaptions } -このイメージはLagoonで使用するために準備されています。したがって、すでにいくつかのことが行われています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダの権限は自動的に[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で調整されるため、このイメージはランダムなユーザーで動作します。 -* `Solr`ポートを修正し確認する`10-solr-port.sh`スクリプト。 -* `20-solr-datadir.sh` `Solr`の設定がLagoonに適合しているかを確認するスクリプトです。これによりディレクトリのパスが設定され、正しいロックタイプが設定されます。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 +* `10-solr-port.sh`スクリプトは、`Solr`ポートの修正と確認を行います。 +* `20-solr-datadir.sh`は、`Solr`の設定がLagoonに適合しているかを確認します。このスクリプトは、ディレクトリパスを設定し、正しいロックタイプを構成します。 ## 環境変数 { #environment-variables } @@ -26,6 +26,6 @@ | 環境変数 | デフォルト | 説明 | | :------------------------ | :-------- | :------------------------------------------------------------------------ | -| SOLR_JAVA_MEM | 512M | デフォルトのJava HEAPサイズ(例. `SOLR_JAVA_MEM="-Xms10g -Xmx10g"`)。 | -| SOLR_DATA_DIR | /var/solr | Solrのデータディレクトリのパス。注意してください、これを変更するとデータが失われる可能性があります！ | -| SOLR_COPY_DATA_DIR_SOURCE | (未設定) | Solrのエントリーポイントスクリプトが定義した`SOLR_DATA_DIR`にコピーするためのパス。これはSolrにコアを事前に準備するために使用できます。スクリプトは実際のSolrデータファイルを必要とします！また、目的地が既にSolrコアを持っていない場合にのみデータをコピーします。 | +| SOLR_JAVA_MEM | 512M | デフォルトのJava HEAPサイズ(例. `SOLR_JAVA_MEM="-Xms10g -Xmx10g"`) | +| SOLR_DATA_DIR | /var/solr | Solrデータディレクトリのパス。注意してください、これを変更するとデータが失われる可能性があります！ | +| SOLR_COPY_DATA_DIR_SOURCE | (設定なし) | 起動スクリプトが定義済みの`SOLR_DATA_DIR`にコピーするために使用するパスです。既存のコアを使って Solr を事前に設定しておくことができます。 スクリプトは実際の Solr データファイルの存在を前提としています。コピーは、宛先に Solr コアが存在しない場合のみ行われます。 | diff --git a/docs/ja/docker-images/varnish.md b/docs/ja/docker-images/varnish.md index 64bbcea5f6..06f1bba225 100644 --- a/docs/ja/docker-images/varnish.md +++ b/docs/ja/docker-images/varnish.md @@ -1,42 +1,43 @@ # Varnish -[Lagoonの `Varnish` Docker画像](https://github.com/uselagoon/lagoon-images/blob/main/images/varnish)です。 [公式 `Varnish`パッケージ](https://hub.docker.com/_/varnish)に基づいています。 +[Lagoonの `Varnish`イメージDockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/varnish)です。 [公式 `Varnish`パッケージ](https://hub.docker.com/_/varnish)をベースに作成されています。 ## サポートされているバージョン { #supported-versions } -* 5(互換性のためだけに利用可能、公式にはもうサポートされていません)- `uselagoon/varnish-5` +* 5(互換性のためのみ利用可能、公式サポートは終了しています)- `uselagoon/varnish-5` * 6.0 LTS [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/varnish/6.Dockerfile) - `uselagoon/varnish-6` * 7 [Dockerfile](https://github.com/uselagoon/lagoon-images/blob/main/images/varnish/7.Dockerfile) - `uselagoon/varnish-7` -## 含まれているバニッシュモジュール { #included-varnish-modules } +## Varnishモジュール { #included-varnish-modules } -* [`vbox-dynamic`](https://github.com/nigoroll/libvmod-dynamic) - DNSルックアップとSRVレコードからのサービスディスカバリからのダイナミックバックエンド。 -* [`vbox-bodyaccess`](https://github.com/aondio/libvmod-bodyaccess) - リクエストボディにアクセスできるようにするVarnish `vmod`。 +* [`vbox-dynamic`](https://github.com/nigoroll/libvmod-dynamic) - DNS ルックアップと SRV レコードからのサービス検出によるダイナミックバックエンド +* [`vbox-bodyaccess`](https://github.com/aondio/libvmod-bodyaccess) - リクエストボディにアクセスできる Varnish `vmod` ## Lagoonの適応 { #lagoon-adaptions } -このイメージはLagoonで使用するために準備されています。そのため、すでにいくつかの作業が行われています: +このイメージはLagoonで使用されることを想定して準備されています。そのため、すでにいくつかのことが行われています: -* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に調整されるため、このイメージはランダムなユーザーで動作します。 +* フォルダの権限は、[`fix-permissions`](https://github.com/uselagoon/lagoon-images/blob/main/images/commons/fix-permissions)で自動的に適応されるため、このイメージはランダムなユーザーで動作します。 -## 含まれている `default.vcl` 設定ファイル { #included-defaultvcl-configuration-file } +## `default.vcl` 設定ファイル { #included-defaultvcl-configuration-file } -このイメージには、Lagoonで動作するように最適化されたデフォルトの`vcl`設定ファイルが付属しています。いくつかのオプションは環境変数を介して設定可能です([環境変数](#environment-variables)を参照)。 +このイメージには、Lagoonで動作するように最適化されたデフォルトの`vcl`設定ファイルが含まれています。いくつかのオプションは環境変数で設定可能です([環境変数](#environment-variables)を参照して下さい)。 ## 環境変数 { #environment-variables } -いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)を介して設定可能です。 +いくつかのオプションは[環境変数](../concepts-advanced/environment-variables.md)で設定可能です。 | 環境変数 | デフォルト | 説明 | | :------------------------- | :-------------------- | :-------------------------------------------------------------------------------------- | -| VARNISH_BACKEND_HOST | NGINX | デフォルトのバックエンドホスト。 | -| VARNISH_BACKEND_PORT | 8080 | デフォルトのVarnishリスニングポート。 | -| VARNISH_SECRET | lagoon_default_secret | 管理に接続するために使用されるVarnishのシークレット。 | -| LIBVMOD_DYNAMIC_VERSION | 5.2 | `vmod-dynamic`モジュールのデフォルトバージョン。 | LIBVMOD_BODYACCESS_VERSION | 5.0 | `vmod-bodyaccess`モジュールのデフォルトバージョン。 | -| HTTP_RESP_HDR_LEN | 8k | 任意のHTTPバックエンドレスポンスヘッダの最大長さ。 | -| HTTP_RESP_SIZE | 32k | 取り扱うHTTPバックエンドレスポンスのバイト数の最大値。 | -| NUKE_LIMIT | 150 | オブジェクトボディのスペースを作るために削除しようとするオブジェクトの最大数。 | -| CACHE_TYPE | malloc | varnishキャッシュのタイプ。 | -| CACHE_SIZE | 100M | キャッシュサイズ。 | -| LISTEN | 8080 | デフォルトのバックエンドサーバーポート。 | -| MANAGEMENT_LISTEN | 6082 | デフォルトの管理リスニングポート。 あなたが提供する内容は何ですか？ +| VARNISH_BACKEND_HOST | NGINX | デフォルトのバックエンドホスト | +| VARNISH_BACKEND_PORT | 8080 | デフォルトのVarnishポート | +| VARNISH_SECRET | lagoon_default_secret | 管理に接続するために使用されるVarnishシークレット | +| LIBVMOD_DYNAMIC_VERSION | 5.2 | `vmod-dynamic`モジュールのデフォルトバージョン +| LIBVMOD_BODYACCESS_VERSION | 5.0 | `vmod-bodyaccess`モジュールのデフォルトバージョン | +| HTTP_RESP_HDR_LEN | 8k | 任意のHTTPバックエンドレスポンスヘッダの最大長 | +| HTTP_RESP_SIZE | 32k | 処理可能なHTTPバックエンドレスポンスの最大バイト数 | +| NUKE_LIMIT | 150 | オブジェクトボディのための空きを作るために削除を試みるオブジェクトの最大数 | +| CACHE_TYPE | malloc | varnishキャッシュのタイプ | +| CACHE_SIZE | 100M | キャッシュサイズ | +| LISTEN | 8080 | デフォルトのバックエンドサーバーポート | +| MANAGEMENT_LISTEN | 6082 | デフォルトの管理リスニングポート |