DigitalOcean に JPedal をデプロイする
- WAR ファイルのダウンロードまたはビルド
- Droplet のプロビジョニング
- Droplet への WAR ファイルの転送
- JPedal Droplet の実行
- HTTPS の有効化
- デーモンモードの有効化
- 異なる言語のクライアントから JPedal を実行する
DigitalOcean 上で JPedal を実行するには、Docker がインストールされた Droplet を起動し、いくつかのファイアウォールポートを公開して、イメージを実行するだけです。
開始する前に、WAR ファイルが必要です。これはダウンロードまたは自分でビルドすることができます。
この WAR ファイルは JPedal サービスが動作するために必須です。
jpedal-microservice.war ファイルをダウンロードしてください。
トライアルユーザーは、トライアル登録 後の Docker セクションで WAR ファイルのダウンロードを見つけることができます。
JPedal Microservice Example プロジェクトのコピーをビルドしてください。
手順は GitHub ページ
で確認できます。
DigitalOcean にログインし、「Create」をクリックして「Droplets」を選択します：
「Marketplace」をクリックし、「Docker on 18.04」アプリイメージを選択します：
下にスクロールして、Droplet プランを選択します：
お近くのリージョンを選択します：
既存の SSH キーを選択するか、新しいものを作成し、Droplet に名前を付けて「Create Droplet」をクリックします。
Droplet が準備される間、プログレスバーが表示されます：
完了したら、IP アドレスをクリックしてコピーします。HTTPS を使用する場合は、この IP アドレスをドメイン名にマッピングする DNS A レコードを作成する必要があります。
ターミナルを開き、IP アドレスまたはドメイン名を使用して新しい Droplet に SSH 接続します：
ssh root@<IP or domain>
ファイアウォールで HTTP ポートを開きます：
ufw allow http
WAR ファイルをマウントできるようにするには、Droplet のディレクトリにあることを確認する必要があるため、転送する必要があります。
FileZilla をダウンロードしてインストールします。インストール手順に従うと、アプリケーションが自動的にこの画面で開きます：
Edit メニューの設定に移動し、接続の下にある SFTP をクリックします。
「add key file」ボタンをクリックすると、Droplet の SSH キーを求められます。これはローカルマシンで見つけることができます。サポートされている形式にファイルを変換するように求められた場合は、yes をクリックします。
File メニューの Site Manager に移動し、新しいサイトをクリックして、Droplet 名を入力し、以下のように選択します：
情報を入力したら、connect をクリックすると、リモートサイト側に Droplet が表示されるはずです。これで WAR を転送できます。WAR に移動し、右クリックして upload を選択してください。
これで Droplet 内に表示されるはずです。
docker run -p 80:80 --mount "source=/root/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/jpedal
ブラウザで IP アドレス/ドメインを開きます。ユーザー名とパスワードを設定している場合は、入力を求められます。
HTTPS を有効にするには、ファイアウォールで HTTPS ポートを開き、有効な SSL 証明書とキーをコンテナの /opt/ssl にマウントする必要があります。
HTTPS ポートを開きます：
ufw allow https
ホストマシンに SSL ディレクトリを作成します：
mkdir /opt/ssl
そのフォルダに certificate.crt と private.key が存在することを確認し、JPedal コンテナを実行します。ポート 443 も転送され、/opt/ssl フォルダがマウントされていることを確認してください：
docker run -p 80:80 -p 443:443 --mount "source=/root/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" --mount "source=/opt/ssl,target=/opt/ssl,type=bind,readonly" idrsolutions/jpedal
起動するまで数分待ってから、https://<IP or domain> をチェックして動作することを確認してください。
認証、複数ユーザー、または API なしで変換されたファイルへのアクセスなどの追加機能を追加するには、Docker イメージページ で詳細を確認できます。
SSH セッションが終了してもコンテナが実行し続けるようにするには、デーモンモードで実行する必要があります。docker コマンドの後に -d フラグを追加するだけです：
docker run -d -p 80:80 -p 443:443 --mount "source=/root/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" --mount "source=/opt/ssl,target=/opt/ssl,type=bind,readonly" idrsolutions/jpedal
Droplet の使用が終わったら、料金が発生しないように破棄できます：
Docker サーバーが実行されたので、API を使用するチュートリアルに従って変換を開始できます。