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