Tomcat を使用して JPedal をデプロイする

WAR ファイルをダウンロードまたはビルドする

始める前に、ダウンロードするか自分でビルドできる WAR ファイルが必要です。
この WAR ファイルは、JPedal サービスが動作するために必要です。

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

試用版:

1. まだサインアップしていない場合は、JPedal トライアル版にサインアップしてください。
2. サインアップ時に受信したメールを開きます。
3. 「Docker」セクションにあるダウンロード リンクをクリックします。

製品版:

1. お客様用ダウンロード ページにアクセスしてください。
2. 「Download Latest Customer WAR」をクリックします。
3. ユーザー名とパスワードを送信してください。

WARファイルをビルドする

JPedal マイクロサービス サンプル プロジェクトのコピーを構築します。手順はGitHub ページにあります。

Web アプリのデプロイ

1. Tomcat をダウンロードしてインストールします。(テストしたバージョン: 8.5.x、9.0.x、10.0.x)
2. ビルドされた .war ファイルを apache-tomcat-x.x.x/webapps/ ディレクトリ (Tomcat 10 の場合は apache-tomcat-x.x.x/webapps-javaee/)^※1 にコピーします。
3. Tomcat は、.war ファイルの名前をコンテキスト パスとして使用して、起動時にアプリケーションを自動的にデプロイします。
4. コマンドライン/ターミナルウィンドウを開き、apache-tomcat-x.x.x に移動し、コマンド bin/startup を実行すると、ポート 8080 でサーバーが起動します。
   • 詳細な手順については、Tomcat に付属の RUNNING.txt ファイルを確認してください。
5. Web アプリが正常にデプロイされたかどうかを確認するには、ブラウザーでその URL に移動します。(例 http://localhost:8080/jpedal-microservice) 中央に JPedal Microservice Example が書かれた空白の白いページが表示されるはずです。

※1：Tomcat 10 は Java EE 8 から Jakarta EE 9 に移行しました。Tomcat 10 は起動時に、.war ファイルの名前をコンテキスト パスとして使用して、webapps-javaee 内の war ファイルを Jakarta Web アプリケーションに自動的に変換し、デプロイします。

使用法

REST API を使用して JPedal マイクロサービス サンプルと対話できます (詳細については、GitHub ページを参照してください)。

注: 変換された出力の表示またはダウンロードは、最初の試行では機能しない場合があります。これは通常、Tomcat が Web アプリによって作成された新しいディレクトリをまだ登録していないことが原因です。 これを修正するには、Tomcat サーバーを再起動するだけです。

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

場合によっては、プログラムの状態を外部のデータベースに保存することが必要になります。たとえば、サーバー障害が発生した場合にプログラムの状態を保存したいときなどです。
これを行うには、Glassfish でデータソースを作成し、その JNDI 名をマイクロサービス構成に追加する必要があります。

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

1. まず、データベース ドライバーの jar を $CANTALINA_HOME/lib に配置して、Tomcat が使用できるようにします。
2. 次に、$CATALINA_HOME/conf/context.xml を編集し、(コンテキスト タグ内の) 一番下に追加します。