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ファイルは、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. 以下のようなDeployページが表示されます。
   以下の値を入力してください。
   その他のオプションはデフォルト値のままにするか、お好みに応じて設定できます。
   • 先ほどビルドした.warファイルをアップロードするか、そのパスをPayaraに提供します。
   • Typeを「Web Application」に設定します。
   • Context Rootを設定します。空のままにすると、デフォルトのコンテキストルート（通常は.warファイルの名前）が使用されます。例えば、サーバーが localhost:8080 にあり、Webアプリのコンテキストルートを jpedal-microservice に設定した場合、localhost:8080/jpedal-microservice でアクセスできます。
   • Virtual Serverを設定します - サーバーが選択されていることを確認してください。そうでないと、Webアプリのデプロイが失敗します。
5. OKをクリックすれば完了です！

Payara Microは、素早くシンプルなデプロイ方法を提供します。次の1行で、マイクロサーバーをポート8080で起動し、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 に移動します。

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

次に「next」をクリックします

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

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

次に「finish」をクリックします

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

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

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

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

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