PayaraとPayara MicroでBuildVuをデプロイする

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

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

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

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

BuildVu 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アプリのコンテキストルートをbuildvu-microserviceに設定した場合、localhost:8080/buildvu-microserviceでアクセスできます。
   • Virtual Serverを設定します - サーバーが選択されていることを確認してください。選択していない場合、Webアプリのデプロイに失敗します。
5. OKをクリックすれば完了です！

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

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

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

REST APIを使用してBuildVu 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）に設定します。

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

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

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

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

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

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

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

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

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