JPedal を Microsoft Azure プラットフォームにデプロイする
WAR ファイルをダウンロードまたはビルドする
始める前に、ダウンロードするか自分でビルドできる WAR ファイルが必要です。
この WAR ファイルは、JPedal サービスが動作するために必要です。
WARファイルをダウンロードする
試用版:
- まだサインアップしていない場合は、JPedal トライアル版にサインアップしてください。
- サインアップ時に受信したメールを開きます。
- 「Docker」セクションにあるダウンロード リンクをクリックします。
製品版:
- お客様用ダウンロード ページにアクセスしてください。
- 「Download Latest Customer WAR」をクリックします。
- ユーザー名とパスワードを送信してください。
WARファイルをビルドする
JPedal マイクロサービス サンプル プロジェクトのコピーを構築します。手順はGitHub ページにあります。
Microsoft Azureのセットアップ
AZURE にログインし、左上隅にあるボタン (ハンバーガーメニュー) を選択します。これにより、以下のリストが表示されます。
このリストで、お気に入りセクション (新しいアカウントにデフォルトで表示されます) から「Virtual Machines」を選択するか、それ以外の場合は「All Services」を選択します。すべてのサービスのリストが表示されるので、左側の「Compute」カテゴリを選択し、ページ中央の「Virtual Machines」オプションを選択します。
この新しいページでは、新しい仮想マシンを作成できます。ページのタイトルのすぐ下に表示される「Add」ボタンをクリックし、続いて「Virtual machine」オプションをクリックします。
次の 7 ページでは、仮想マシンを構成できます。設定する必要がある設定はすべて「Basics」ページにありますが、利用可能な他のオプションについてもよく理解しておくとよいでしょう。
JPedal Dockerコンテナを利用するには以下の設定が必要です。
- Resource Group
まだ作成していない場合は、[Create New] ボタンを使用して新しいグループを作成します (これはポップアップで処理され、名前のみが必要です)。 - Virtual machine name
これは任意の名前にすることができ、複数ある場合にこのマシンを識別するのに役立ちます。 - Image
Docker が利用可能なイメージを指定する必要があります (または、自分で Docker をセットアップする)。「Browse all」リンクをクリックして、最新バージョンの「Docker Advanced Engine on Ubuntu XX.XX LTS」を選択することをお勧めします。 - Size
使用する仮想マシンを選択する必要があります。「Select size」リンクをクリックすると見つかる「Standard_B2ms」以上を使用することをお勧めします。 - Select inbound ports
ここでは、アクセスを許可する 3 つのポート (SSH、HTTP、HTTPS) を指定できます。少なくとも SSH と HTTP の設定が必要です。
必須ではありませんが、ユーザー名をデフォルト値から変更することをお勧めします。
完了したら、「next」ボタンを使用して最終ページに移動します。このページには、確認するために設定した設定が表示され、SSH 用のキー ファイルを仮想マシンにダウンロードできるようになります。このファイルをダウンロードし、create ボタンをクリックして仮想マシンを作成します。
作成したら (数分かかる場合があります)、[Virtual machines] ページに移動して、作成した仮想マシンを選択します。このページでは、以下に示すようにパブリック IP アドレスを確認できます。
JPedal-Microservice WAR ファイルをアップロードする
ターミナルで、scp コマンドを使用して WAR ファイルをアップロードする必要があります。
実行するコマンドには、以前に入力または作成した 3 つの値が必要です。
- ダウンロードしたキー ファイルのファイル名/パス。
- 仮想マシンの USERNAME (デフォルト値は azureuser)。
- 仮想マシンのアドレス。
次のようになります:
scp -i <KEY FILE> <path/to/jpedal-microservice.war> <USERNAME>@<ADDRESS>:~/jpedal-microservice.war
これで war ファイルが利用可能になり、docker イメージを開始できるようになります。
JPedal Docker イメージを実行する
マイクロサービスを開始するには、仮想マシンに SSH 接続する必要があります。Azure では、仮想マシン ページに手順が記載されています。
仮想マシンのページに移動し、右端の「…」ボタンをクリックして、connect オプションをクリックします。この新しいページの手順に従って、SSH 経由で仮想マシンに接続します。
接続したら、次のコマンドでコンテナを起動します。アップロード手順で使用したユーザー名が必要になります (デフォルト値は azureuser)。
docker run -p 80:80 --mount "source=/home/<USERNAME>/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/jpedal
このコマンドを機能させるにはスーパー ユーザーである必要があることに注意してください
HTTPS暗号化
HTTPS を有効にするには、ファイアウォールで HTTPS ポートを開く必要があります。次に、有効な SSL 証明書とキーが仮想マシンの /opt/ssl にマウントされている必要があります。すでに仮想マシンがセットアップされている場合は、次のようにこのルールを追加します。
[Virtual machine] ページに移動し、ネットワーク設定ページを選択します。このページで「Add inbound port rule」ボタンをクリックします。
新しいフレームで、仮想マシンへのアクセスを許可するポートを指定します。HTTPS の場合、「Destination port ranges」を 443 に設定する必要があります。その他の値はすべて、表示されているデフォルトのままでかまいません。
次に、端末を使用して必要な SSL 証明書をアップロードします。まず、仮想マシンに接続します (詳細については「JPedal Docker イメージの実行」セクションを参照)。接続したら、ディレクトリ /opt/ssl を作成します。
mkdir /opt/ssl
次に、SSL 証明書をこのディレクトリにアップロードします。
これを行うコマンドには、以前に入力または作成した 3 つの値が必要です。
- ダウンロードしたキー ファイルのファイル名/パス。
- 仮想マシンの USERNAME (デフォルト値は azureuser)。
- 仮想マシンのアドレス。
次のようになります:
scp -i <KEY FILE> <path/to/certificate.crt> <USERNAME>@<ADDRESS>:/opt/ssl/certificate.crt
scp -i <KEY FILE> <path/to/private.key> <USERNAME>@<ADDRESS>:/opt/ssl/private.key
scp -i <KEY FILE> <path/to/ca_bundle.crt> <USERNAME>@<ADDRESS>:/opt/ssl/ca_bundle.crt
これで、仮想マシンで HTTPS 接続が許可されるようになり、指定したポートで Docker を起動する必要があります。
docker run -p 80:80 -p 443:443 --mount "source=/local/path/to/ssl/directory,target=/opt/ssl,type=bind,readonly" --mount "source=/home/<USERNAME>/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/jpedal
認証、複数ユーザー、または API を使用せずに変換されたファイルへのアクセスなどの追加機能を追加するには、Docker イメージ ページで詳細を確認できます。
仮想マシンが不要になったら
JPedal を試用している場合、またはしばらくの間仮想マシンが必要ない場合は、JPedal の使用を禁止したり、完全に削除したりすることができます。これは簡単です。仮想マシンのページに移動すると、概要ページに次のオプションが表示されます。
仮想マシンを停止すると、サービスは削除されずに停止されます。
仮想マシンが再び必要ない場合は、仮想マシンを削除して停止し、プラットフォームから削除することもできます。
異なる言語クライアントから JPedal を実行する
Docker サーバーが実行されているので、API を使用して変換を開始するためのチュートリアルに従うことができます。