Oracle Cloud InfrastructureでJPedalをデプロイする
- WARファイルのダウンロードまたはビルド
- VCNのセットアップ
- JPedal WARファイルのアップロード
- Dockerのインストール
- idrsolutions/jpedalのプルと実行
- HTTPS統合 [オプション]
- 異なる言語のクライアントからJPedalを実行する
Oracle Cloud InfrastructureでJPedalをデプロイする最も簡単な方法の1つは、単一のコンピュートインスタンスを実行し、そこにDockerをインストールすることです。
開始する前に、WARファイルが必要です。これはダウンロードするか、自分でビルドすることができます。
このWARファイルは、JPedalサービスが動作するために必須です。
jpedal-microservice.war ファイルをダウンロードしてください。
トライアルユーザーは、トライアル登録 後、Dockerセクションでwarファイルのダウンロードを見つけることができます。
JPedal Microservice Exampleプロジェクトのコピーをビルドします。
手順はGitHubページ
で確認できます。
まず、Virtual Cloud Networks（VCN）に移動します。
VCNを作成します（不確かな場合はウィザードを使用してください）。
完了したら、VCNを開きます。
「Security Lists」を選択します。
VCNのデフォルトリストを開きます。
「Add Ingress Rules」をクリックし、以下の設定をコピーします。
「Add Ingress Rules」をクリックし、compute/Instancesに移動します。
「Create Instance」をクリックし、以下のネットワーク設定に従います。
続行するためにインスタンスへの接続に必要なSSHキーを追加し、作成をクリックして、SSH接続の好みの方法を開きます。（ここではbashを使用します。）
"ssh -i key opc@"と入力します。ここで、keyは秘密鍵のディレクトリで、その後にインスタンスのパブリックIPを続けます。例：ssh -i instance.key [email protected]
接続したら、以下のコマンドを入力し、各コマンドが完了するまで順番に待ちます。
別のターミナルで、scpを使用してWARファイルをアップロードする必要があります。
同じssh詳細を使用して、コマンドは次のようになります：
scp -i <key> <path/to/jpedal-microservice.war> opc@<instance public IP>:/home/opc
例：
scp -i instance.key jpedal-microservice.war [email protected]:/home/opc
これにより、opcホームディレクトリにアップロードされ、dockerで使用する準備が整います。
sudo yum install docker-engine
sudo docker pull idrsolutions/jpedal
次のメッセージが表示された場合は、dockerデーモンを起動するために別のコマンドを実行する必要があります：
sudo service docker start
次に、dockerイメージを起動します。
sudo docker run -p 80:80 --mount "source=/home/opc/jpedal_microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/jpedal
次に、WebブラウザでインスタンスのパブリックIPに続けて「:80」を入力して接続します。例：123.123.123.123:80。使用されているサービスの名前が表示されたページが表示されるはずです。この場合は「JPedal Microservice Example」です。
HTTPS暗号化を使用する場合は、VNSセキュリティリストを更新する必要があります。
VNSに戻り、以下の設定で新しいingressルールを作成します：
warファイルの更新に使用したのと同じキーを使用して、証明書、キー、ca_bundleを追加します。これらは次の名前である必要があります：
scp -i <key> <path/to/certificate.crt> opc@<instance public IP>:/home/ssl/certificate.crt
scp -i <key> <path/to/private.key> opc@<instance public IP>:/home/ssl/private.key
scp -i <key> <path/to/ca_bundle.crtr> opc@<instance public IP>:/home/ssl/ca_bundle.crt
次に、以下のコマンドを実行してサービスを起動します：
docker run -p 80:80 -p 443:443 --mount "source=/home/opc/jpedal_microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" --mount "source=/local/path/to/ssl/directory,target=/opt/ssl,type=bind,readonly" idrsolutions\jpedal
エラーが発生した場合は、代わりに以下のコマンドを実行する必要があるかもしれません。これを行う際は注意してください - 詳細はdockerドキュメント で確認できます。
docker run -p 80:80 -p 443:443 --mount "source=/home/opc/jpedal_microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" --volume "/path/to/ssl"/target:"/opt/ssl"/app:z,ro idrsolutions/jpedal
認証、複数ユーザー、またはAPIなしで変換されたファイルへのアクセスなどの追加機能を追加するには、dockerイメージページ で詳細を確認できます。
dockerサーバーが実行されているので、APIを使用するためのチュートリアルに従って変換を開始できます。