Liferay Workspace
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

Configuring a Liferay Docker Container

コンテナの作成とデプロイは、最新の開発者ワークフローの重要な部分です。 Liferay Workspaceでは、Dockerコンテナを開発用に使用することも、完全な作業構成を作成するために使用することも簡単にできます。

コンテナの作成は、次の3つの主要なステップで行われます。

  1. コンテナに必要なDockerイメージを選択します。
  2. そのコンテナをワークスペースにダウンロードします。
  3. 設定とアプリケーションを使用してコンテナを構成します。

以下の手順を実行する前に、Dockerをインストールして実行する必要があります。

Liferay Dockerイメージの選択

ほとんどの場合、Liferay Docker イメージのバージョンを指定する必要はありません。これは、バージョンが Workspace バージョンから継承されるためです。 ただし、ワークスペースとは異なるイメージ バージョンをインストールする必要がある場合は、バージョンを明示的に設定できます。 これを行わない場合は、次のセクションに進んでください。

Liferay の Docker イメージは Docker Hubにあります。 それらは2つのカテゴリーに分類されます。

  1. 上記のリンクを使用して、必要なLiferayコンテナのバージョンを見つけます。

  2. コンテナの完全なタグ名を一覧表示するdocker pullコマンドに注目してください。 タグ名は次のようになります: liferay/dxp:2025.q1.2-lts または次のようになります: liferay/portal:7.4.3.132-ga132

  3. Liferay Workspaceでgradle.propertiesを開きます。

  4. プロパティliferay.workspace.docker.image.liferayを使用してDockerタグを指定します。 次にいくつかの例を示します。

    liferay.workspace.docker.image.liferay=liferay/dxp:2025.q1.2-lts
    
    liferay.workspace.docker.image.liferay=liferay/portal:7.4.3.132-ga132
    
  5. ファイルを保存します。 これで、Dockerイメージを作成する準備が整いました。

Liferay Dockerイメージを作成する

ワークスペースのルートフォルダから次のコマンドを実行します。

./gradlew createDockerContainer

ワークスペースの名前に-liferayが追加されたDockerイメージが作成されます。 たとえば、ワークスペースフォルダがmy-projectの場合、Dockerコンテナはmy-project-liferayと呼ばれます。 他のDockerイメージと同じようにコンテナを開始/停止できますが、最初にコンテナを構成することをお勧めします。

上記の命名規則が気に入らない場合は、コンテナに任意の名前を付けることができます。

  1. ワークスペースのルートにある settings.gradle を開きます。

  2. 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'
    }
    
  3. ファイルを保存して閉じ、コンテナをビルドします。

    ./gradlew createDockerContainer
    

これで、コンテナは指定した命名規則に従うようになります。

Dockerイメージの構成

コンテナを設定するための通常の Docker ツール以外に、Gradle タスクからコンテナをビルドすると、 Liferay Homeを指すフォルダーが設定されるため、必要な Liferay 設定を作成できます。 このフォルダは configs/dockerにあります。

たとえば、コンテナのGogoシェルへのtelnetアクセスを有効にすることができます。 その方法は以下の通りです。

  1. configs/dockerフォルダにportal-ext.propertiesファイルを作成し、次のプロパティを追加します。

    module.framework.properties.osgi.console=0.0.0.0:11311
    
  2. ファイルを保存します。

  3. コンテナを起動します。 portal-ext.properties ファイルに含まれるプロパティは実行中のインスタンスに適用され、次のコマンドを使用して Gogo シェルに telnet できるようになります。

telnet localhost 11311

Docker 構成は、複数の環境を処理できる、より大きな ワークスペース構成 の一部です。 これを使用している場合、configs/commonに格納されている構成は、configs/dockerフォルダに配置されている構成とマージされます。