Payara and Payara MicroでBuildVuをデプロイする
WARファイルのダウンロードまたはビルド
まずはお試しの前にWARファイルが必要です。WARファイルはダウンロードするか、ご自身でビルドしてください。このWARファイルはBuildVuサービスが動作するために必要です。
WARファイルをダウンロードする
トライアルご希望の方へ：
BuildVuのトライアルに登録してください。WARファイルでのトライアルのご希望をお知らせください。
既にライセンスを購入済みのお客さま：
WARファイルのダウンロードURLをお知らせいたしますので、お問い合わせください。
WARファイルをビルドする
BuildVu Microservice Exampleプロジェクトをビルドします。
手順はGitHubページにあります。
Webアプリをデプロイする
Payara
- 最新バージョンのPayaraまたはPayara Microをダウンロードしてインストールします
- Payaraサーバーを起動し、ブラウザで管理コンソールに移動します。
例として、次のコマンドを実行します。./bin/asadmin start-domainはポート8080でサーバーを起動し、管理コンソールをポート4848で起動します。- Payaraに付属のREADME.txtに詳しい説明があるので、そちらを参照してください。 - ホームページで、左側のメニューバーから「アプリケーション」をクリックし、「デプロイ」をクリックする。
- 下図のようなDeployページが表示されるはずです。
残りのオプションはデフォルト値のままでも、必要に応じて設定することもできます。- 先ほどビルドした .war ファイルをアップロードするか、そのパスを GlassFish に渡します。
- タイプを「Web Application」に設定します。
- Context Rootを設定します。空のままだと、デフォルトのコンテキストルート（通常は.warファイルの名前）が使用されます。例えば、サーバーが
localhost:8080にあり、Web アプリのコンテキストルートをbuildvu-microserviceに設定した場合、localhost:8080/buildvu-microserviceとなります。 - 仮想サーバーの設定 – サーバーが選択されていることを確認してください。
- OKをクリックして完了です！
残りのオプションはデフォルト値のままでも、必要に応じて設定することもできます。Payara Micro
Payara Microは、迅速かつシンプルなデプロイ方法を提供します。ポート8080でマイクロサーバーを起動し、1行でウェブアプリをデプロイできます：
java -jar payara-micro.jar --deploy /path/to/buildvu-microservice.war
この方法では、デフォルトのコンテキストパスとして war ファイル名を使用します。例えば、上記のコマンドを使うと、コンバータは localhost:8080/buildvu-microservice に接続します。ブラウザからサーバが動作しているかどうかを確認するには localhost:8080/buildvu-microservice/buildvu にアクセスしてください。
使用方法
BuildVu Microservice Exampleでは、REST APIを使用してやりとりすることができます（詳細はGitHubページをご覧ください）。
変換の状態を外部に保存する
例えば、サーバーに障害が発生した場合にプログラムの状態を保持したいというような場合に利用します。
これを行うには、Payara上にデータソースを作成し、そのJNDI名をマイクロサービス設定に追加する必要があります。
データソースのセットアップ
注：このプロセスはPayara Microには適用されませんのでご注意ください。
データベースドライバのインストール
まず、Payaraにデータベースドライバーjarをインストールする必要があります。Payaraには、MySql、Oracle、MicrosoftSqlServerなど、いくつかのデータベース・ドライバがデフォルトでインストールされています。
新しいデータベース・ドライバをインストールするには、asadmin を実行してドメインを起動し、以下を実行します：
add-library "PATH/TO/DATABASE/DRIVER.JAR"
これにより、Payaraのドライバが自動的にセットアップされ、データソースのセットアップ時に使用できるようになります。
データソースのセットアップ
次に、管理パネルでデータソースを作成します。
管理パネルに移動する（デフォルトではlocalhost:4848に接続され、左側のナビゲーションメニューから JDBC -> JDBC Connection Pools に移動します）。
新しいプールを作成し、任意の名前を付け、タイプを javax.sql.DataSource に設定し、データベース・ドライバ・ベンダーをデータベース・ドライバの名前 (例えば、sqlite、mysql、mariadb) に設定します。
次へをクリックします。
注：この例ではSQLiteを使用しているため、ドライバーは手動で入力する必要があります。
次の画面で、datasource Classnameをデータベース・ドライバのデータ・ ソースクラスに設定し(自動入力されていなければ、ドライバのドキュメントにあります)、pool settingsを好みに設定します。プロパティが自動的に追加されていない場合は、ドライバ jar のドキュメントで必要なプロパティを見つけることができます。
その後、終了をクリックします。
注: このサンプル画像はSQLiteの追加プロパティを表示しています。
注：すべてのプロパティが必須ではなく、空白のままでもかまいません。入力が必要なフィールドについては、データベース・ドライブのドキュメントを確認してください。
接続プールを作成したら、JDBC -> JDBC Resources に移動し、新しいリソースを作成します。
名前を任意に設定し（これは、config に記述する JNDI 名で、通常は jdbc/ で始まります。例：jdbc/myDatabase ）、プール名を先ほど作成したプール（この例では test）に設定し、[OK]をクリックします。
マイクロサービスを設定する
最後に、前のステップで設定したリソース名をマイクロサービス設定に追加します。