Liferay Dockerイメージの使用
Docker Hubは、Linux上のTomcatにバンドルされた Liferay DXP と Liferay Portal Docker イメージをホストしています。 Liferay Docker Hubページには、さまざまなリリースのイメージの詳細とタグが表示されます。
これらのコンテナは、標準のDockerコンテナであり、そのまま起動および停止できます。 以下の例では、 Docker CLI (docker
) を使用しているが、好きなDockerコンテナ・ツールを使用することができる。
コンテナを初めて起動する
コンテナはポート8080
をリッスンし、他のDockerコンテナと同様に起動する。
-
ホストのポート(例えば、
8080
)をコンテナの8080
ポートにマップするコンテナ を実行する。docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.120-ga120
コンテナが実行され、次のTomcat起動完了メッセージを含むログメッセージが出力されます。
INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [xx,xxx] milliseconds
noteメモリ、CPU、およびその他のDockerコンテナリソースは構成可能です。 上記の
-m 8g
コマンド引数は、コンテナのメモリ制限を8ギガバイトに設定します。 詳細は Dockerランタイム・オプション を参照。 -
test@liferay.com というメールアドレスと test というパスワードを使って、
<http://localhost:8080>
から Liferay にサインインしてください。 -
プロンプトが表示されたら、パスワードを変更し(learn など)、 Save をクリックします。
本番環境では、デフォルトの管理者アカウントを使うべきではありません。 その代わりに、 、あなたのビジネスに特化した管理者アカウント 。
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]
コンテナが再起動されると、そのエントリーポイントが再び実行されます( コンテナのライフサイクルと API を参照してください)。エントリーポイント経由で 実行しているスクリプト が安全に再実行できることを確認してください。
docker container ls -a
を実行して、コンテナの名前または ID を調べる。
これで、Liferayコンテナの開始、停止、監視の基本を理解できました。
次のステップ
コンテナのエントリーポイントが何をするのか知りたい、コンテナのAPIを知りたい場合は、 コンテナのライフサイクルとAPI を参照してください。 コンテナの使用を開始する場合は、次のいずれかの使用例を実行してください。
- コンテナの設定
- コンテナへのアプリやその他のアーティファクトのインストール
- DockerでDXPにパッチを当てる
- コンテナへのファイルの提供
- 新しいDockerイメージへのアップグレード
- Dockerイメージ・バージョン