BuildVu Dockerイメージの実行方法
- BuildVuの起動
- WARファイルのダウンロードまたはビルド
- Dockerのインストール
- Dockerの実行
- [推奨] HTTPSの有効化
- [オプション] 認証情報の設定
- [オプション] ボリュームのマウント
- 各言語クライアントからのBuildVuの実行
Webサービスとしてではなく、ローカルでのみBuildVuを実行したい場合は、Run BuildVu with Docker を参照してください。こちらは標準のJavaイメージ内でBuildVu JARを実行する方法です。
BuildVuでは、簡単に始められるよう idrsolutions/buildvu というDockerイメージを提供しています。このDockerイメージを使用することで、シンプルなREST APIを通じてBuildVuによる変換処理を行うコンテナを起動できます。
このイメージは、Dockerがインストールされているクラウドプラットフォームやサーバーから利用できます。自分のサーバー・インフラ上でDockerイメージを使用する手順については、以下を参照してください。
始める前に、WARファイルが必要です。WARファイルはダウンロードするか、自分でビルドすることができます。
このWARファイルはBuildVuサービスの動作に必須です。
buildvu-microservice.war ファイルをダウンロードしてください。
トライアルユーザーは、トライアル登録 後にDockerセクションでWARファイルのダウンロードリンクを確認できます。
BuildVu Microservice Exampleプロジェクトをビルドしてください。
手順は GitHubページ
に記載されています。
Dockerのインストール方法については多くのチュートリアルがあります。Install Docker のチュートリアルで必要な手順をすべて確認できます。
docker run -p 80:80 --mount "source=/path/to/war/buildvu-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/buildvu
本番環境での使用には、HTTPSによる暗号化を強く推奨します。コンテナは、/opt/ssl/ ディレクトリにSSL証明書、秘密鍵、および証明書チェーンが存在する場合に自動的にHTTPSへ切り替わるよう事前設定されています。certificate.crt、private.key、ca_bundle.crt という名前のファイルを含むディレクトリをマウントするだけで有効になります。上記のコマンドに以下を追加してください。
-p 443:443 --mount "source=/local/path/to/ssl/directory,target=/opt/ssl,type=bind,readonly"
サービスにユーザー名とパスワードを設定したい場合は、以下の環境変数を追加で指定してください。
--env ACCESS_USERNAME=<username> --env ACCESS_PASSWORD=<password>
複数のユーザーが必要な場合は、独自の tomcat-users.xml ファイルを用意し、/usr/local/tomcat/conf/tomcat-users.xml にマウントしてください。
APIを使わずにホストマシンから変換済みファイルにアクセスする必要がある場合は、出力先にドライブをマウントする必要があります。
以下をDockerの実行コマンドに追加することで設定できます。
--mount "source=/path/to/documents,target=/root/.idr,type=bind"
Dockerサーバーが起動したら、APIを使用して変換処理を開始するためのチュートリアルを参照してください。