TomcatでBuildVuをデプロイする
開始する前に、ダウンロードするか自分でビルドするかのいずれかでWARファイルを入手する必要があります。
このWARファイルはBuildVuサービスが動作するために必須です。
buildvu-microservice.war ファイルをダウンロードしてください。
トライアルユーザーは、トライアル登録 後のDockerセクションでwarファイルのダウンロードを見つけることができます。
BuildVu Microservice Exampleプロジェクトのコピーをビルドします。
手順はGitHubページ
で確認できます。
- Tomcat をダウンロードしてインストールします。(テスト済みバージョン:8.5.x、9.0.x、10.0.x)
- ビルドした.warファイルを
apache-tomcat-x.x.x/webapps/ディレクトリ(Tomcat 101の場合はapache-tomcat-x.x.x/webapps-javaee/)にコピーします。 - Tomcatは起動時にアプリケーションを自動的にデプロイし、.warファイルの名前をコンテキストパスとして使用します。
- コマンドライン/ターミナルウィンドウを開き、apache-tomcat-x.x.xに移動して
bin/startupコマンドを実行すると、サーバーがポート8080で起動します。- 詳細な手順については、Tomcatに付属の
RUNNING.txtファイルを確認してください。
- 詳細な手順については、Tomcatに付属の
- Webアプリが正常にデプロイされたかどうかは、ブラウザでそのURLに移動して確認できます(例:
http://localhost:8080/buildvu-microservice)。表示されるページは、中央にBuildVu Microservice Exampleと書かれた空白の白いページになります。
1 Tomcat 10はJava EE 8からJakarta EE 9に移行しました。起動時にTomcat 10はwebapps-javaee内のwarファイルを自動的にJakarta Webアプリケーションに変換してデプロイし、.warファイルの名前をコンテキストパスとして使用します。
REST APIを使用してBuildVu Microservice Exampleと対話できます(詳細についてはGitHubページ を参照してください)。
特定の言語については、チュートリアル を参照してください。
注意:変換された出力の表示/ダウンロードは最初の試行では機能しない場合があります - これは通常、TomcatがWebアプリによって作成された新しいディレクトリをまだ登録していないためです。これを修正するには、単にTomcatサーバーを再起動してください。
場合によっては、プログラムの状態をデータベースに外部保存したい場合があります。例えば、サーバー障害が発生した場合にプログラムの状態を保持したい場合などです。
これを行うには、Tomcat上にデータソースを作成し、そのJNDI名をマイクロサービスの設定に追加する 必要があります。
- まず、データベースドライバのjarを
$CATALINA_HOME/libに配置して、Tomcatが使用できるようにします。 - 次に
$CATALINA_HOME/conf/context.xmlを編集し、最後に(ただしcontextタグ内に)追加します:
<Resource name="JNDI_NAME" auth="Container" type="javax.sql.DataSource"
url="JDBC_URL"
driverClassName="DRIVER_CLASS"/>
JNDI_NAMEは設定に記述する JNDI名です。通常はjdbc/で始まります。例:jdbc/myDatabase。
JDBC_URLはデータベースにアクセスするために使用されるURLです。データベースドライバjarのドキュメントで、これがどのような形式である必要があるかを確認できます。SQLite の場合、これはjdbc:sqlite:/PATH/ON/DISK.dbになります。
DRIVER_CLASSは、データベースドライバjar内のメインドライバクラスの完全修飾クラス名です。これもデータベースドライバjarのドキュメントで確認できます。SQLite の場合、これはorg.sqlite.JDBCになります。
このresource要素には、ドライバを設定するために使用される追加の属性を含めることもできます。これらには、ユーザー名やパスワードなどのパラメータを含めることができます。これらはドライバに依存するため、利用可能なオプションについてはデータベースドライバのドキュメントを参照してください。
