Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

Amazon Web Services (AWS) に JPedal をデプロイする

目次

  1. WAR ファイルのダウンロードまたはビルド
    1. WAR ファイルのダウンロード
    2. WAR ファイルのビルド
  2. はじめに
  3. HTTPS の有効化
  4. まとめ
  5. 異なる言語のクライアントから JPedal を実行する

AWS で JPedal を実行する最も簡単な方法は、Elastic Container Service (ECS) クラスター上のコンテナで Docker イメージを実行することです。

WAR ファイルのダウンロードまたはビルド

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

WAR ファイルのダウンロード

jpedal-microservice.war ファイルをダウンロードしてください。

トライアルユーザーは、トライアル登録 後の Docker セクションで WAR ファイルのダウンロードを見つけることができます。

WAR ファイルのビルド

JPedal Microservice Example プロジェクトのコピーをビルドしてください。 手順は GitHub ページ で確認できます。

はじめに

https://console.aws.amazon.com にアクセスしてログインします。 「All Services」セクションを開き、EC2(Elastic Compute Cloud)をクリックします。AWS Management Console

インスタンスに SSH 接続するためのキーペアがあることを確認する必要があります。 「key pairs」をクリックします: EC2 console

「Create key pair」をクリックし、名前を付けてファイル形式として pem を選択します: create key pair

次にサービスタブに移動し、「Containers」の下にある Elastic Container Service(ECS)をクリックします: services panel

「Clusters」ページで「Create Cluster」をクリックします。これにより SSH 接続可能な独自の EC2(Elastic Compute Cloud)を読み込むことができます: clusters tab

「EC2 Linux + Networking」を選択します: select cluster template

クラスターに付けたい名前を入力し、コンテナインスタンスに使用したいインスタンスタイプを選択します(これは必要なリソース量によって異なります)。 先ほど作成したキーペアを選択し、下にスクロールして作成をクリックします: cluster configuration

読み込みが完了したら、「View Cluster」をクリックしてから「ECS Instances」タブに移動します。 ECS Instance ID をクリックします(表示されるまで少し時間がかかる場合があります): clusters tab

「Instance ID」をクリックします: Instance tab

「Security」タブに移動し、「Security groups」の ID をクリックします。security tab

「Edit inbound rules」をクリックします。inbound rules tab

「Add rule」をクリックして、下図のように入力してから「save rules」をクリックします: edit inbound rules

EC2 インスタンスに戻り、「Connect」をクリックしてから「SSH client」タブに移動し、パブリック DNS をコピーします: connect to instance

ターミナルを開き、次のコードをコピーして、自分の情報に置き換えます(デフォルトのユーザー名は ’ec2-user’ です。ただし AMI オーナーが変更していない場合):

scp -i <path/to/key.pem> path/to/war/jpedal-microservice.war ec2-user@<YourPublicDNS>:~

インスタンスに SSH 接続します:

 ssh -i <path/to/key.pem> ec2-user@<YourPublicDNS>

接続後、Docker イメージを実行します:

docker run -p 80:80 --mount "source=/home/ec2-user/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/jpedal

次に ECS に移動して「ECS instances」タブをクリックし、「Container Instance」の ID をクリックしてパブリック IP アドレスをコピーします Container Instance

HTTPS の有効化

HTTPS を有効にするには、ファイアウォールで HTTPS ポートを開く必要があります。次に、仮想マシンの /opt/ssl に有効な SSL 証明書とキーをマウントする必要があります。EC2 インスタンスに移動し、「Security」タブに移動して「Security groups」の ID をクリックします。security tab

このページで「Edit inbound rules」ボタンをクリックします。edit inbound rules

次にターミナルを使用して必要な SSL 証明書をアップロードします。まずインスタンスに接続する必要があります(上記で詳しく説明されています)。接続後、/opt/ssl ディレクトリを作成します。

mkdir /opt/ssl

次にこのディレクトリに SSL 証明書をアップロードします。

scp -i <path/to/key.pem> <path/to/certificate.crt> ec2-user@<YourPublicDNS>:/opt/ssl/certificate.crt
scp -i <path/to/key.pem> <path/to/private.key> ec2-user@<YourPublicDNS>:/opt/ssl/private.key
scp -i <path/to/key.pem> <path/to/ca_bundle.crt> ec2-user@<YourPublicDNS>:/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/ec2-user/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/jpedal

認証、複数ユーザー、API を使用せずに変換されたファイルへのアクセスなどの追加機能を追加するには、docker イメージページ で詳細を確認できます。

まとめ

クラスターが不要になった場合は、「Delete Cluster」ボタンを押して課金を停止してください: Delete Cluster

異なる言語のクライアントから JPedal を実行する

Docker サーバーが実行されたので、API を使用するためのチュートリアルに従って変換を開始できます。