Documentation

Liferay Dockerイメージの使用

Docker Hubは、Linux上のTomcatにバンドルされた Liferay DXPLiferay Portal Docker イメージをホストしています。 Liferay Docker Hubページには、さまざまなリリースのイメージの詳細とタグが表示されます。

これらのコンテナは、標準のDockerコンテナであり、そのまま起動および停止できます。 次の例では、 Docker CLI(docker を使用していますが、任意のDockerコンテナツールを使用できます。

コンテナを初めて起動する

コンテナはポート 8080でリッスンし、すべてのDockerコンテナと同様に開始します。

  1. ホストポート(例: 8080)をコンテナの 8080 ポートにマップするコンテナ を実行します。

    docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.29-ga29
    

    コンテナが実行され、次のTomcat起動完了メッセージを含むログメッセージが出力されます。

    INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [xx,xxx] milliseconds
    

    注釈

    メモリ、CPU、およびその他のDockerコンテナリソースは構成可能です。 上記の -m 8gコマンド引数は、コンテナのメモリ制限を8ギガバイトに設定します。 詳細については、 Dockerランタイムオプション を参照してください。

  2. メールアドレス(test@liferay.com)とパスワード(test)を使って、<http://localhost:8080>でLiferayにサインインします。 プロンプトが表示されたら、パスワードを変更します。

    こちらはLiferayのランディングページです。

Liferayを使用する準備が整いました。

注釈

docker container lsは、IDと名前を含む、実行中の各コンテナを一覧表示します。 docker container ls -aは、実行されていないコンテナを含む、すべてのコンテナを一覧表示します。

ログの表示

Liferayログメッセージとログファイルは、ライブで表示したり、ホストにコピーしたりできます。

Dockerログ コマンド

docker logs コマンドは、コンテナログメッセージを出力します。

コマンド

結果

docker logs [container]

現在のすべてのログメッセージを出力します

docker logs -f [container]

tail -f [file] のように、新しいログメッセージをストリーミングする

docker logs -t [container]

各ログメッセージにタイムスタンプを追加します

docker cp コマンド

以下のような docker cp コマンドを使用して、ホストマシンにログファイルをコピーできます。

docker cp [container]:/opt/liferay/logs/liferay.[timestamp].log .

コンテナの停止

コンテナを停止するには、2つの方法があります。

メソッド

長所

短所

docker exec [container] /opt/liferay/tomcat/bin/shutdown.sh

Liferay、Tomcat、およびその他のアプリがリソースを解放できるようにします。 コンテナエントリポイントは、 シャットダウン後のスクリプト を実行します。

i 引数を指定して実行しているターミナルセッションで Ctrl-C を実行します。

注意:これは SIGINT または SIGKILL シグナルをアタッチされたコンテナに送信します。

コンテナを停止する最速の方法。

Liferay、Tomcat、およびコンテナエントリポイントは、リソースを解放せずにすぐに停止します。 エントリポイントの シャットダウン後フェーズ はスキップされます。 本番環境ではこの方法を使用しないでください

コンテナの再起動

コンテナは、すべてのDockerコンテナと同様に再起動できます。

docker start [container]

警告

コンテナが再起動すると、そのエントリーポイントが再度実行されます Container Lifecycle and API を参照してください)。 エントリーポイントを介して実行しているスクリプトが安全に再実行できることを確認してください。

ちなみに

docker container ls -aを実行して、コンテナの名前またはIDを検索します。

これで、Liferayコンテナの開始、停止、監視の基本を理解できました。

次のステップ

コンテナのエントリーポイントが何をするのか知りたい、コンテナのAPIを知りたい場合は、 コンテナのライフサイクルとAPI を参照してください。 コンテナの使用を開始する場合は、次のいずれかの使用例を実行してください。