BuildVu Dockerイメージでの実行方法
BuildVuを公開する
BuildVuにはidrsolutions/buildvuというDockerイメージがあり、簡単に開始できるようになっています。このDockerイメージを使ってBuildVuコンテナを起動し、シンプルなREST APIを使って変換を実行できます。
このイメージは、Dockerがインストールされたクラウドプラットフォームや サーバから使用することができます。Dockerイメージを独自のサーバ/インフラストラクチャで使用する手順については、以下を参照してください。
WARファイルをダウンロードまたはビルドする
開始する前に、WARファイルが必要ですので、ダウンロードするかご自身でビルドしてください。
このWARファイルはBuildVuサービスが動作するために必要です。
WARファイルのダウンロードまたはビルド
まずはお試しの前にWARファイルが必要です。WARファイルはダウンロードするか、ご自身でビルドしてください。このWARファイルはBuildVuサービスが動作するために必要です。
WARファイルをダウンロードする
トライアルご希望の方へ：
BuildVuのトライアルに登録してください。WARファイルでのトライアルのご希望をお知らせください。
既にライセンスを購入済みのお客さま：
WARファイルのダウンロードURLをお知らせいたしますので、お問い合わせください。
WARファイルをビルドする
BuildVu Microservice Exampleプロジェクトをビルドします。
手順はGitHubページにあります。
Dockerのインストール
多くのチュートリアルでは、Dockerをすぐに使えるようにインストールする方法を詳しく説明しています。こちらのチュートリアルは、Dockerをインストールするために必要なすべてをカバーしています。
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の有効化
本番環境で使用する場合は、HTTPS 暗号化を有効にすることを強く推奨します。コンテナは、/opt/SSL/ディレクトリにSSL証明書、秘密鍵、および証明書チェーンが見つかれば、HTTPSに切り替えるようにあらかじめ設定されています。必要なのは、certificates. 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></password></username>
[詳細] 複数のユーザーを追加する
複数のユーザが必要な場合は、独自の tomcat-users.xml ファイルを用意し、/usr/local/tomcat/conf/tomcat-users.xml にマウントします。
[オプション] ボリュームのマウント
APIを使わずにホストマシンから変換後のファイルにアクセスする必要がある場合は、出力先にドライブをマウントする必要があります。
これは run docker コマンドに以下を追加することで 行えます。
--mount "<a href="https://github.com/idrsolutions/idrviewer/tree/master/src/templates/complete/" target="_blank" title="The IDRViewer is a pure HTML/JavaScript/CSS viewer designed to display PDF and Office documents in the browser. It works alongside BuildVu which converts PDF documents to HTML5 or SVG pages. - idrviewer/src/templates/complete at master · idrsolutions/idrviewer" hreflang="en">source</a>=/<a href="https://pub.dev/packages/path" target="_blank" title="A string-based path manipulation library. All of the path operations you know and love, with solid support for Windows, POSIX (Linux and Mac OS X), and the web." hreflang="en-us">path</a>/to/documents,target=/root/.idr,type=bind"
異なる言語のクライアントからBuildVuを実行する
Dockerサーバーを起動した後は、APIを使用するためのチュートリアルに従って変換を開始することができます。