Payara Micro 5によるUber JARの作成

しかし、アプリケーション・インスタンスのHTTPポートやクラスタの構成を実行時に設定したい場合はどうすればよいでしょうか。問題はありません。アプリケーションのJARを実行する際に、これらのプロパティを引数として渡すことができます。

java -jar test-app.jar --port 10080 --noCluster

また、--deployオプションを複数回使用することで、より多くのアプリケーションをパッケージ化することができるため、このUber JARにバンドルされるアプリケーションは1つに限定されません。

そして、このJARでパッケージ化されたアプリケーションを起動すると、サーバーはいくつのアプリケーションがデプロイされたかを知らせてくれます。

これにより、アプリケーションの自己完結型環境を作成し、簡単にデプロイすることができます。Payara Microはサイズが小さいので、出来上がったJARをパッケージ化して移動することは、費用対効果が高く、時間も節約できます。

Mavenによる方法

通常、自己完結型のアプリケーションを作成する場合、最も一般的なシナリオの1つは、Mavenを使用して、shadeプラグインを使用してUber JARを作成することです。Payara Micro Mavenプラグインを使用すると、この作業は非常に簡単になり、Mavenの設定で必要なすべてのコマンドライン・オプションを指定することができます。以下の例では、Maven ライフサイクルの package フェーズで Uber JAR ファイルを生成します。

このプラグイン宣言により、Payara Micro Uber JAR作成を実行するbundle ゴールの実行を設定します。複数のコマンドライン・オプションやコンタクト・ルートなどの設定パラメータを指定可能です。すべての設定パラメータは、プラグインのドキュメントに記載されています。

Uber JARのDocker上での使用

開発者がPayara Micro Uber JARをベースに Docker コンテナを作成したい場合にはどうすれば良いのでしょうか。このシナリオには複数の選択肢がありますが、最も簡単なものは、JavaベースのDockerイメージを使ってUber JARを取得して実行することです。例えば、以下のようなDockerfileを構成します。

FROM azul/zulu-openjdk-alpine:8

ENV APP_LOCATION ./test-app.jar
ENV APP_NAME application.jar

ADD $APP_LOCATION $APP_NAME
RUN chmod +x $APP_NAME

EXPOSE 8080

ENTRYPOINT java -jar $APP_NAME

And build a new image:

docker build -t payara-uber-jar .

この例では、azul:zulu-openjdk-alpine:8をベース・イメージとして使用していることに注目してください。これは、Alpine Linuxオペレーティング・システムをベースにしたZulu Java 8イメージで、非常に小さなサイズのディストリビューションです (これは、公式のPayara Micro Dockerイメージで使用しているベース・イメージと同じものです)。このコンテナをできるだけ軽量にしたいために使用しています。ここでは、DockerfileのADD命令を使って、Uber JARを外部ソース (ここではDockerfileと同じディレクトリにあるuberjar) からダウンロードし、ダウンロードしたUber JARでテストアプリケーションを実行するように、このコンテナのエンドポイントを設定しています。

このコンテナを起動するには、以下のコマンドを実行するだけです。

docker run -d -p 8080:8080 --name uber-jar payara-uber-jar

ただし、Uber JARをDockerイメージで使用することは効率的ではなく、バッド・プラクティスであることに注意してください。コードが変更されるたびに、Uber JARをビルドし、新しいDockerイメージを作成する必要があります。ここでは、アプリケーションの変更だけでなく、変更されていないPayara Microのコードを含むより大きなJARファイルがピックアップされます。

より良い方法は、Payara Microインスタンスを起動して、インストールが必要なアプリケーションを指定することです。詳細については、Payara Micro Docker Image documentationのドキュメントを参照してください。

結論

Payara Microは、アプリケーション開発者に新たな可能性をもたらします。マイクロサービスやDevOpsなどの複雑なコンセプトの出現により、サーバーとアプリケーションを同時に実行できる自己完結型のJARを作成する能力は、多くの開発者が必要としています。この方法を用いると、Payara Serverは多くの継続的インテグレーションのワークフローと簡単に統合できるため、Java開発者は安心して取り組むことができます。