Lagoonの基本的な使い方 - 概要#

このセクションでは、Lagoonの基本的な特徴と機能について説明します。これらに慣れている方は、Lagoonの高度な使い方に進んでください。

ヘルプが必要な場合は、Lagoonの管理者に連絡するか、私たちのDiscordでコミュニティのメンバーとメンテナに問い合わせてください。

必要条件#

Docker#

Lagoonプロジェクトを実行するには、システムがDockerを実行するための要件を満たしている必要があります。ワークステーションに最新バージョンのDockerをインストールすることをおすすめします。Dockerはこちらからダウンロードできます。また、Dockerには最低でも4CPUsと4GB RAMを割り当てることをおすすめします。

ローカル開発環境#

pygmy、Lando、DDEVから選ぶことができます - 選択はあなた次第です！

Lagoonとローカル開発環境についてもっと学びましょう。

ステップバイステップのガイド#

Lagoon設定ファイルの概要#

`.lagoon.yml`#

これはLagoonが何をデプロイするべきか、また多くの他の事柄を理解するために使用する主要なファイルです。.lagoon.ymlのドキュメンテーションを参照してください。

`docker-compose.yml`#

このファイルはDocker Composeによってローカル開発環境を開始するために使用されます。Lagoonもこれを使用して、どのサービスがデプロイされるべきか、どのタイプで、どのようにビルドするかを理解します。これはlabelsを通じて行われます。docker-compose.ymlのドキュメンテーションを参照してください。

Dockerfiles#

一部のDockerイメージとコンテナは、提供されたイメージから追加のカスタマイズが必要です。これには通常、2つの理由があります:

アプリケーションコード: NGINX、PHP、Node.jsなどのコンテナは、そのイメージ内に実際のプログラミングコードが必要です。これはDockerビルドステップ中に行われ、Dockerfileで設定されます。LagoonはDockerを完全にサポートしているためDockerfileのカスタマイズによって出来上がるイメージを完全に制御できます。
イメージのカスタマイズ: Lagoonでは、ベースイメージをあなたのニーズに合わせてカスタマイズすることも可能です。これには、追加の環境変数を挿入したり、サービスの設定を変更したり、さらに追加のツールをインストールすることも含まれます。Dockerイメージに追加のツールをインストールする際には注意が必要です。なぜなら、将来的に任意の適応を維持する必要があるからです！

Lagoonによるサポートサービスとベースイメージ#

タイプ	バージョン	Dockerfile
MariaDB	10.4, 10.5, 10.6, 10.11	mariadb/Dockerfile
PostgreSQL	11, 12, 13, 14, 15	postgres/Dockerfile
MongoDB	4	mongo/Dockerfile
NGINX	openresty/1.25	nginx/Dockerfile
Node.js	18, 20, 22	node/Dockerfile
PHP FPM	8.1, 8.2, 8.3	php/fpm/Dockerfile
PHP CLI	8.1, 8.2, 8.3	php/cli/Dockerfile
Python	3.8, 3.9, 3.10, 3.11, 3.12	python/Dockerfile
Redis	6, 7	redis/Dockerfile
Solr	8, 9	solr/Dockerfile
Varnish	6, 7	varnish/Dockerfile
Opensearch	2	opensearch/Dockerfiles
RabbitMQ	3.10	rabbitmq/Dockerfile
Ruby	3.1, 3.2, 3.3	ruby/Dockerfile

すべてのイメージはhttps://hub.docker.com/u/uselagoonにプッシュされます。特性とセキュリティの観点から常に最新のタグ(例:uselagoon/nginx:latest)を使用することをおすすめします。

特定のLagoonバージョンのイメージ、例えばuselagoon/nginx:20.10.0やuselagoon/node-10:20.10.0を使用する場合、新しいLagoonバージョンがリリースされたらすぐにイメージのバージョンを各自の責任でアップグレードしてください！