oo

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.112-ga112
    

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

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

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

  2. test@liferay.com というメールアドレスと test というパスワードを使って、<http://localhost:8080> から Liferay にサインインしてください。

  3. プロンプトが表示されたら、パスワードを変更し(learn など)、 Save をクリックします。

    Change your password upon first login.

warning

本番環境では、デフォルトの管理者アカウントを使うべきではありません。 その代わりに、 、あなたのビジネスに特化した管理者アカウント

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

note

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]
warning

コンテナが再起動されると、そのエントリーポイントが再び実行されます( コンテナのライフサイクルと API を参照してください)。エントリーポイント経由で 実行しているスクリプト が安全に再実行できることを確認してください。

tip

docker container ls -a を実行して、コンテナの名前または ID を調べる。

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

次のステップ

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

Deployment Approach: