fbpx
< 戻る
印刷

Payara および Payara Micro を使用して JPedal をデプロイする

作成日2024年1月22日
最終更新日2024年1月22日

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

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

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

試用版:

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

製品版:

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

WARファイルをビルドする

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

Web アプリのデプロイ

Payara

  1. Payara または Payara Micro の最新バージョンをダウンロードしてインストールします
  2. Payara サーバーを起動し、ブラウザで管理コンソールに移動します。
    • たとえば、次のコマンド
      ./bin/asadmin start-domain はポート 8080 でサーバーを起動し、管理コンソールはポート 4848 で起動します。詳細な手順については、Payara に付属の README.txt を確認してください。
  3. ホームページで、左側のメニューバーから「Applications」をクリックし、「Deploy」をクリックします。
  4. 以下に示すように、Deploy ページが表示されるはずです。次の値を入力する必要があります。
    残りのオプションはデフォルト値のままにすることも、必要に応じて構成することもできます。
    • 前に作成した .war ファイルをアップロードするか、Payara にそのファイルへのパスを指定します。
    • Type を「Web Application」に設定します。
    • Context Root を設定します。 空のままにすると、デフォルトのコンテキスト ルート (通常は .war ファイルの名前) が使用されます。たとえば、サーバーが localhost:8080 にあり、Web アプリのコンテキスト ルートを jpedal-microservice に設定している場合、localhost:8080/jpedal-microservice で見つけることができます。
    • Virtual Server を設定する – サーバーが選択されていることを確認してください。選択されていない場合、Web アプリの展開は失敗します。
  5. 「OK」をクリックすれば完了です。

Payara Micro

Payara Micro は、迅速かつ簡単な導入方法を提供します。 次の 1 行で、ポート 8080 でマイクロサーバーを起動し、Web アプリをデプロイできます。

				
					java -jar payara-micro.jar --deploy /path/to/jpedal-microservice.war

このメソッドは、war ファイル名をデフォルトのコンテキスト パスとして使用します。 たとえば、上記のコマンドを使用すると、localhost:8080/jpedal-microservice にあるコンバータにアクセスできます。 サーバーが動作しているかどうかをブラウザから確認するには、localhost:8080/jpedal-microservice/jpedal に移動します。

使用法

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

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

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

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

まず、データベース ドライバー jar を Payara にインストールする必要があります。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) を設定します。

次に「next」をクリックします。

次の画面で、データソース クラス名をデータベース ドライバーのデータソース クラスに設定し (自動入力されていない場合は、ドライバーのドキュメントに記載されています)、好みに合わせてプール設定を設定し、下にスクロールして追加の設定を行います。プロパティを選択し、これらを入力します。プロパティが自動的に追加されていない場合は、ドライバー jar のドキュメントで必要なプロパティを見つけることができます。

次に「finish」をクリックします。

接続プールを作成した後、「JDBC」→「JDBC Resources」に移動して、新しいリソースを作成します。名前を好みに設定し (これは構成に入れる JNDI Nameで、通常は jdbc/ で始まります。例: jdbc/myDatabase)、プール名を前に作成したプールに設定します (この例の場合は test です)。 をクリックし、「OK」をクリックします。
最後に、前の手順で設定したリソース名を microservice config に追加します。

    MENU
    PAGE TOP