Configuring a Liferay Docker Container
コンテナの作成とデプロイは、最新の開発者ワークフローの重要な部分です。 Liferay Workspaceでは、Dockerコンテナを開発用に使用することも、完全な作業構成を作成するために使用することも簡単にできます。
コンテナの作成は、次の3つの主要なステップで行われます。
- コンテナに必要なDockerイメージを選択します。
- そのコンテナをワークスペースにダウンロードします。
- 設定とアプリケーションを使用してコンテナを構成します。
以下の手順を実行する前に、Dockerをインストールして実行する必要があります。
Liferay Dockerイメージの選択
ほとんどの場合、Liferay Docker イメージのバージョンを指定する必要はありません。これは、バージョンが Workspace バージョンから継承されるためです。 ただし、ワークスペースとは異なるイメージ バージョンをインストールする必要がある場合は、バージョンを明示的に設定できます。 これを行わない場合は、次のセクションに進んでください。
Liferay の Docker イメージは Docker Hubにあります。 それらは2つのカテゴリーに分類されます。
-
上記のリンクを使用して、必要なLiferayコンテナのバージョンを見つけます。
-
コンテナの完全なタグ名を一覧表示する
docker pullコマンドに注目してください。 タグ名は次のようになります:liferay/dxp:2025.q1.2-ltsまたは次のようになります:liferay/portal:7.4.3.132-ga132。 -
Liferay Workspaceで
gradle.propertiesを開きます。 -
プロパティ
liferay.workspace.docker.image.liferayを使用してDockerタグを指定します。 次にいくつかの例を示します。liferay.workspace.docker.image.liferay=liferay/dxp:2025.q1.2-ltsliferay.workspace.docker.image.liferay=liferay/portal:7.4.3.132-ga132 -
ファイルを保存します。 これで、Dockerイメージを作成する準備が整いました。
Liferay Dockerイメージを作成する
ワークスペースのルートフォルダから次のコマンドを実行します。
./gradlew createDockerContainer
ワークスペースの名前に-liferayが追加されたDockerイメージが作成されます。 たとえば、ワークスペースフォルダがmy-projectの場合、Dockerコンテナはmy-project-liferayと呼ばれます。 他のDockerイメージと同じようにコンテナを開始/停止できますが、最初にコンテナを構成することをお勧めします。
上記の命名規則が気に入らない場合は、コンテナに任意の名前を付けることができます。
-
ワークスペースのルートにある
settings.gradleを開きます。 -
apply plugin: "com.liferay.workspace"行の下に、次のコードスニペットを追加します。gradle.liferayWorkspace { dockerContainerId = '[your name for the container ID]' dockerImageId = '[your name for the image ID]' }たとえば、イメージ ID に
standard-buildという名前を付け、コンテナー ID にdev-envという名前を付ける場合は、次のように指定します。gradle.liferayWorkspace { dockerContainerId = 'dev-env' dockerImageId = 'standard-build' } -
ファイルを保存して閉じ、コンテナをビルドします。
./gradlew createDockerContainer
これで、コンテナは指定した命名規則に従うようになります。
Dockerイメージの構成
コンテナを設定するための通常の Docker ツール以外に、Gradle タスクからコンテナをビルドすると、 Liferay Homeを指すフォルダーが設定されるため、必要な Liferay 設定を作成できます。 このフォルダは configs/dockerにあります。
たとえば、コンテナのGogoシェルへのtelnetアクセスを有効にすることができます。 その方法は以下の通りです。
-
configs/dockerフォルダにportal-ext.propertiesファイルを作成し、次のプロパティを追加します。module.framework.properties.osgi.console=0.0.0.0:11311 -
ファイルを保存します。
-
コンテナを起動します。
portal-ext.propertiesファイルに含まれるプロパティは実行中のインスタンスに適用され、次のコマンドを使用して Gogo シェルに telnet できるようになります。
telnet localhost 11311
Docker 構成は、複数の環境を処理できる、より大きな ワークスペース構成 の一部です。 これを使用している場合、configs/commonに格納されている構成は、configs/dockerフォルダに配置されている構成とマージされます。