fbpx
印刷

JettyでBuildVuをデプロイする

WARファイルのダウンロードまたはビルド

まずはお試しの前にWARファイルが必要です。WARファイルはダウンロードするか、ご自身でビルドしてください。このWARファイルはBuildVuサービスが動作するために必要です。

WARファイルをダウンロードする

トライアルご希望の方へ:

BuildVuのトライアルに登録してください。WARファイルでのトライアルのご希望をお知らせください。

既にライセンスを購入済みのお客さま:

WARファイルのダウンロードURLをお知らせいたしますので、お問い合わせください。

WARファイルをビルドする

BuildVu Microservice Exampleプロジェクトをビルドします。
手順はGitHubページにあります。

Webアプリケーションのデプロイ

  1. 最新版の Jetty10 をダウンロードし、インストールします(Jetty11以上はJakartaを使用するようになったため、サポートされていませんのでご注意ください)
  2. Jettyのホームディレクトリのために、JETTY_HOMEという環境変数を新規に作成します。
  3. jettyのベースコンテンツを格納するためのディレクトリを作成し、そのディレクトリに入ります。
  4. 以下のコマンドで必要なモジュールをセットアップします。
    java -jar JETTY_HOME/start.jar --add-module=server,http,deploy,jsp
  5. warファイルをjettyのベースディレクトリに作成したwebappsフォルダに移動します。
    warファイルの名前は、Webアプリのベースとなる名前になります。例えば、ウェブサーバーが localhost:8080 でホストされている場合、 buildvu-microservice.war localhost:8080/buildvu-microservice にデプロイされることになります。
  6. Jetty サーバを起動し、ブラウザで管理コンソールに移動します。
    java -jar start.jarlocalhost:8080 のサーバーを起動します。

Webアプリが正常にデプロイされたかどうかは、ブラウザでURLにアクセスすると、中央にBuildVu Microservice Exampleと書かれた真っ白なページが表示されるはずです。

使用方法

BuildVu Microservice Exampleでは、REST APIを使用してやりとりすることができます(詳細はGitHubページをご覧ください)。

利用する言語については、こちらの「BuildVuを他の言語から実行する」を参照してください。

変換の状態を外部に保存する

例えば、サーバーに障害が発生した場合にプログラムの状態を保持したいというような場合に利用します。

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

データソースのセットアップ

データベースドライバのインストール

これにより、Jetty を実行する際にコマンドライン引数として指定します。

データソースのセットアップ

まず、データベースドライバjarを $JETTY_HOME/lib/ext にインストールし、データソースとして利用できるようにします。

ドライバをロードしてサーブレットで利用できるようにするには、extとplusのモジュールを使ってjettyサーバを起動する必要があります。

  • plusは、JNDIが動作するためのロジック(マイクロサービスがデータソースを見つけるための機能)を含んでいるため必要です。
  • extは$JETTY_HOME/lib/extにあるすべてのjarをクラスパスにロードし、jettyがデータベースドライバを見つけられるようにします。

以下を追加することで有効になります:

				
					--add-module=plus,ext
				
			

これで、Jetty を実行する際にコマンドライン引数として指定します。

データソースのセットアップ

$JETTY_HOME/etc/jetty.xml を開き、ファイルの一番下まで行き(ここはまだConfigureタグの中です)、以下を追加します:

				
					<New id="ID" class="org.eclipse.jetty.plus.jndi.Resource">
  <Arg><Ref refid="wac"/></Arg>
  <Arg>JNDI_NAME</Arg>
  <Arg>
    <New class="DATASOURCE_CLASS">
      <Set name="url">JDBC_URL</Set>
    </New>
  </Arg>
</New>
				
			

JNDI_NAME は、設定に記述する JNDI 名です。これは通常、jdbc/ で始まり、例えば、jdbc/myDatabase のようになります。

JDBC_URL は、データベースへのアクセスに使用する URL です。SQLiteの場合、jdbc:sqlite:/PATH/ON/DISK.dbのようになります。

DRIVER_CLASS はデータベースドライバ jar のメイン・ドライバクラスの完全修飾クラス名です。これは、データベースドライバのjarのドキュメントにも記載されているはずです。
SQLiteの場合は、jdbc:sqlite:/PATH/ON/DISK.dbとなります。

この <New class="DATASOURCE_CLASS"> 要素には、ドライバを設定するための <Set> 要素も含めることができます。これらはドライバに依存するので、どのようなオプションがあるかは データベースドライバのドキュメントを参照してください。

マイクロサービスを設定する

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

    MENU
    PAGE TOP