PayaraおよびPayara MicroでJPedalをデプロイする

1. WARファイルのダウンロードまたはビルド
   1. WARファイルのダウンロード
   2. WARファイルのビルド
2. Webアプリのデプロイ
   1. Payara
   2. Payara Micro
3. 使用方法
4. 変換状態の外部保存
   1. データソースのセットアップ
      1. データベースドライバのインストール
      2. データソースのセットアップ
      3. マイクロサービスの設定

開始する前に、WARファイルが必要です。WARファイルはダウンロードするか、自分でビルドすることができます。
このWARファイルは、JPedalサービスが動作するために必須です。

jpedal-microservice.war ファイルをダウンロードしてください。

トライアルユーザーは、トライアル登録 後、Dockerセクションでwarファイルのダウンロードを見つけることができます。

JPedal Microservice Exampleプロジェクトのコピーをビルドしてください。
手順はGitHubページ で確認できます。

1. 最新バージョンのPayaraまたはPayara Microをダウンロードしてインストールします
2. Payaraサーバーを起動し、ブラウザで管理コンソールに移動します
   • 例えば、コマンド
     ./bin/asadmin start-domain を実行すると、サーバーがポート8080で起動し、管理コンソールはポート4848で利用できます - 詳細な手順については、Payaraに同梱されているREADME.txtを確認してください。
3. ホームページで、左側のメニューバーから「Applications」をクリックし、次に「Deploy」をクリックします。
   
4. 以下のようなデプロイページが表示されます。
   以下の値を入力してください。
   その他のオプションはデフォルト値のままにするか、必要に応じて設定してください。
   • 先ほどビルドした.warファイルをアップロードするか、Payaraにそのファイルへのパスを指定します。
   • Typeを「Web Application」に設定します。
   • Context Rootを設定します。空のままにすると、デフォルトのコンテキストルート（通常は.warファイルの名前）が使用されます。例えば、サーバーがlocalhost:8080にあり、Webアプリのコンテキストルートをjpedal-microserviceに設定した場合、localhost:8080/jpedal-microserviceでアクセスできます。
   • Virtual Serverを設定します - サーバーが選択されていることを確認してください。そうでない場合、Webアプリのデプロイは失敗します。
5. OKをクリックして完了です！

Payara Microは、迅速でシンプルなデプロイ方法を提供します。マイクロサーバーをポート8080で起動し、1行でWebアプリをデプロイできます：

 java -jar payara-micro.jar --deploy /path/to/jpedal-microservice.war

この方法では、warファイル名がデフォルトのコンテキストパスとして使用されます。例えば、上記のコマンドを使用すると、コンバーターはlocalhost:8080/jpedal-microserviceでアクセスできます。ブラウザからサーバーが動作しているかを確認するには、localhost:8080/jpedal-microservice/jpedalにアクセスしてください。

REST APIを使用してJPedal Microservice Exampleと対話できます（詳細はGitHubページ を参照してください）。

場合によっては、プログラムの状態をデータベースなどに外部保存したい場合があります。例えば、サーバー障害が発生した際にプログラムの状態を保持したい場合などです。

これを行うには、Payara上でデータソースを作成し、そのJNDI名をマイクロサービスの設定に追加 する必要があります。

このプロセスはPayara Microには適用されませんのでご注意ください

まず、データベースドライバjarをPayaraにインストールする必要があります。PayaraにはMySql、Oracle、MicrosoftSqlServerなどのデータベースドライバがデフォルトでインストールされているため、使用するケースによってはこのステップは不要かもしれません。

新しいデータベースドライバをインストールするには、asadminを実行し、ドメインを起動して、以下を実行します：

add-library "PATH/TO/DATABASE/DRIVER.JAR"

これにより、Payaraにドライバが自動的にセットアップされ、データソースのセットアップ時に使用できるようになります。

次に、管理パネルでデータソースを作成する必要があります

管理パネルに移動し（デフォルトではlocalhost:4848でアクセス可能）、左側のナビゲーションメニューを使用してJDBC -> JDBC Connection Poolsに移動します

新しいプールを作成し、任意の名前を付け、タイプをjavax.sql.DataSourceに設定し、Database Driver Vendorをデータベースドライバの名前（例：sqlite、mysql、mariadb）に設定します。

次へをクリックします

注：この例の画像ではSQLiteを使用しており、手動で入力する必要があります。ドライバは上部の入力欄のドロップダウンボックスで選択できる場合もあります。

次の画面で、データソースのClassnameをデータベースドライバのデータソースクラスに設定します（ドライバのドキュメントに記載されています。自動入力されていない場合は確認してください）。プール設定を好みに応じて設定し、下にスクロールして追加プロパティを入力します。プロパティが自動的に追加されていない場合は、ドライバjarのドキュメントで必要なプロパティを確認できます。

完了をクリックします

注：この例の画像はSQLiteの追加プロパティを示しています。他のデータベースドライバは異なるプロパティを持ちます

注：すべてのプロパティが必須というわけではなく、空白のままにできます。この例ではUrlのみが必須です。入力する必要があるフィールドについては、データベースドライバのドキュメントを確認してください。

接続プールを作成した後、JDBC -> JDBC Resourcesに移動し、新しいリソースを作成します。

名前を好みに設定し（これが設定に入力する JNDI名で、通常はjdbc/で始まります。例：jdbc/myDatabase）、プール名を先ほど作成したプールに設定し（この例の場合はtest）、OKをクリックします。

最後に、前のステップで設定したリソース名をマイクロサービスの設定に追加 します。