Microsoft Azure Platform に JPedal をデプロイする
- WAR ファイルをダウンロードまたはビルドする
- Microsoft Azure をセットアップする
- JPedal-Microservice WAR ファイルをアップロードする
- JPedal Docker イメージを実行する
- HTTPS 暗号化
- 仮想マシンが不要になった場合
- 異なる言語のクライアントから JPedal を実行する
始める前に、WAR ファイルが必要です。これはダウンロードするか、自分でビルドすることができます。
この WAR ファイルは JPedal サービスが動作するために必須です。
jpedal-microservice.war ファイルをダウンロードしてください。
トライアルユーザーは、トライアル登録 後の Docker セクションで WAR ファイルのダウンロードを見つけることができます。
JPedal Microservice Example プロジェクトのコピーをビルドしてください。
手順は GitHub ページ
で確認できます。
AZURE にログインし、左上隅のボタン（3本の横線が積み重なったような形）を選択します。これにより以下のリストが表示されます。
このリストで、お気に入りセクションから「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 アドレスを確認できます。
ターミナルで scp コマンドを使用して WAR ファイルをアップロードする必要があります。
このコマンドには、以前に入力/作成した3つの値が必要です。
- ダウンロードした KEY FILE のファイル名/パス。
- 仮想マシンの USERNAME（デフォルト値は azureuser）。
- 仮想マシンの ADDRESS。
コマンドは以下のようになります：
scp -i <KEY FILE> <path/to/jpedal-microservice.war> <USERNAME>@<ADDRESS>:~/jpedal-microservice.war
これで war ファイルが利用可能になったので、docker イメージを起動できます。
マイクロサービスを起動するには、仮想マシンに SSH 接続する必要があります。Azure は仮想マシンページで手順を提供することで、これを簡単にしています。
仮想マシンページに移動し、右端の「…」ボタンをクリックして、connect オプションをクリックします。この新しいページの手順に従って、SSH 経由で仮想マシンに接続します。
接続したら、以下のコマンドでコンテナを起動します。Upload ステップで使用したユーザー名が必要です（デフォルト値は 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 ポートを開き、仮想マシンの /opt/ssl に有効な SSL 証明書とキーをマウントする必要があります。仮想マシンが既にセットアップされている場合は、以下のようにこのルールを追加します。
Virtual machine ページに移動し、ネットワーク設定ページを選択します。このページで「Add inbound port rule」ボタンをクリックします。
新しいフレームで、仮想マシンへのアクセスを許可するポートを指定します。HTTPS の場合、「Destination port ranges」を 443 に設定する必要があります。他の値は表示されているデフォルトのままで構いません。
次にターミナルを使用して必要な SSL 証明書をアップロードします。まず、仮想マシンに接続します（「JPedal Docker イメージを実行する」セクションで詳述）。接続したら、/opt/ssl ディレクトリを作成します。
mkdir /opt/ssl
次にこのディレクトリに SSL 証明書をアップロードします。
このコマンドには、以前に入力/作成した3つの値が必要です。
- ダウンロードした KEY FILE のファイル名/パス。
- 仮想マシンの USERNAME（デフォルト値は azureuser）。
- 仮想マシンの ADDRESS。
コマンドは以下のようになります：
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 を試用している場合や、しばらく仮想マシンが必要ない場合は、使用を停止したり、完全に削除したりすることができます。これは簡単に行えます。仮想マシンページに移動すると、overview ページに以下のオプションが表示されます。
仮想マシンを停止すると、削除せずにサービスを停止できます。
仮想マシンが再び必要ない場合は、削除することもできます。これにより停止され、プラットフォームから削除されます。
docker サーバーが実行されているので、API を使用するチュートリアルに従って変換を開始できます。