GlassFishでBuildVuをデプロイする
互換性の警告
Glassfish 6は、JavaEEの使用からJakartaEEの使用に移行しました。JavaEEのパッケージをサポートしなくなったため、Glassfish 5を使用する必要があります。
2021年1月現在、GlassFish 5はJava 10以降と互換性がありません。Java 10以降を使用する場合は、Java 9以下のSDKを使用するようにサーバーを設定する必要があります。
これを行うには、/glassfish/config/ に移動し、以下を変更します。
Windows:
asenv.bat - Add "set AS_JAVA=PATH\TO\JDK.jdk"
For example: "set AS_JAVA=C:\Program Files\Java\jdk1.8.0_172.jdk"
Mac:
asenv.conf - Add "AS_JAVA=/PATH/TO/JDK.jdk"
For example: "AS_JAVA=/Library/Java/JavaVirtualMachines/jdk1.8.0_172.jdk"
WARファイルのダウンロードまたはビルド
まずはお試しの前にWARファイルが必要です。WARファイルはダウンロードするか、ご自身でビルドしてください。このWARファイルはBuildVuサービスが動作するために必要です。
WARファイルをダウンロードする
トライアルご希望の方へ：
BuildVuのトライアルに登録してください。WARファイルでのトライアルのご希望をお知らせください。
既にライセンスを購入済みのお客さま：
WARファイルのダウンロードURLをお知らせいたしますので、お問い合わせください。
WARファイルをビルドする
BuildVu Microservice Exampleプロジェクトをビルドします。
手順はGitHubページにあります。
Webアプリケーションの構築
- GlassFishの最新バージョンをダウンロードしてインストールします。 Webプロファイルまたは完全なプラットフォームを使用できます。（テストされたバージョン：4.X、5.0）
- BuildVu Microservice Exampleプロジェクトのコピーを作成します。 手順はGitHubページで見つけることができます。
Webアプリケーションのデプロイ
GlassFishを起動し、ブラウザで管理コンソールに移動します。
- たとえば、
glassfish5/glassfish/bin/asadmin start-domainコマンドを実行すると、ポート4880の管理コンソールでポート8080でサーバーが起動します。詳細は、GlassFishに付属のREADME.txtを参照してください。
- たとえば、
ホームページで、左側のメニューバーから「アプリケーション」をクリックし、次に「展開」をクリックします。
以下に示すように、[デプロイ]ページが表示されます。
次の値を入力する必要があります。
残りのオプションは、デフォルト値のままにすることも、必要に応じて構成することもできます。- 以前に作成した.warファイルをアップロードするか、GlassFishにそのパスを提供します。
- タイプを「Webアプリケーション」に設定します。
- コンテキストルートを設定します。 空のままにすると、デフォルトのコンテキストルート（通常は.warファイルの名前）が使用されます。 たとえば、サーバーが
localhost:8080にあり、ウェブアプリのコンテキストルートをbuildvu-microserviceに設定している場合、localhost:8080/buildvu-microserviceにあります。 - 仮想サーバーの設定-サーバーが選択されていることを確認してください。選択されていない場合、Webアプリはデプロイに失敗します。
OKをクリックして、完了です！
ブラウザでそのURLに移動すると、Webアプリが正常にデプロイされたかどうかを確認できます。中央に「BuildVu Microservice Example」と書かれた空白の白いページが表示されます。
使用方法
REST APIを使用してBuildVu Microservice Exampleを利用できます（詳細はGitHubページを参照）。
利用する言語については、こちらを参照してください。
変換の状態を外部に保存する
例えば、サーバーに障害が発生した場合にプログラムの状態を保持したいというような場合に利用します。
これを行うには、Jetty上にデータソースを作成し、そのJNDI名をマイクロサービス設定に追加する必要があります。
データソースのセットアップ
データベースドライバのインストール
まず、データベースドライバjarをglassfishにインストールする必要があります。GlassfishにはMySql、Oracle、MicrosoftSqlServerのようなデータベースドライバがデフォルトでインストールされています。
新しいデータベースドライバーをインストールするには、asadminを実行してドメインを起動し、以下を実行します：
add-library "PATH/TO/DATABASE/DRIVER.JAR"
これにより、glassfishのドライバが自動的にセットアップされ、データソースのセットアップ時に使用できるようになります。
データソースのセットアップ
次に、管理パネルでデータソースを作成する必要があります。
管理パネルに移動します（デフォルトではlocalhost:4848からアクセスできます。左側のナビゲーション・メニューを使って、JDBC -> JDBC Connection Pools に移動します）。
新しいプールを作成し、任意の名前を付け、タイプを javax.sql.DataSource に設定し、データベースドライバ・ベンダーをデータベースドライバの名前 (例えば、sqlite、mysql、mariadb) に設定します。
次へをクリックします。
注：この例ではSQLiteを使用しているため、ドライバーは手動で入力する必要があります。
次の画面で、データソース・クラス名をデータベースドライバのデータソース・クラスに設定し（自動入力されていない場合は、ドライバのドキュメントに記載されています）、プール設定を好みに設定し、追加のプロパティにスクロールダウンして、これらを入力します。プロパティが自動的に追加されていない場合は、ドライバ jar のドキュメントで必要なプロパティを見つけることができます。
そして、終了をクリックします。
注: このサンプル画像はSQLiteの追加プロパティを示しています。
注: すべてのプロパティが必須ではなく、空白のままでもかまいません。この例では、Urlのみが必須です。どのようなフィールドに入力する必要があるかについては、データベースドライブのマニュアルを確認してください。
接続プールを作成したら、JDBC -> JDBC Resources に移動し、新しいリソースを作成する。
名前を任意に設定し（これは、config に記述する JNDI 名で、通常は jdbc/ で始まります。例：jdbc/myDatabase ）、プール名を先ほど作成したプール（この例では test）に設定し、[OK]をクリックします。
