JPedal Docker イメージの実行方法
- JPedal の起動
- WAR ファイルのダウンロードまたはビルド
- Docker のインストール
- Docker の実行
- [推奨] HTTPS の有効化
- [オプション] 認証情報の定義
- [オプション] ボリュームのマウント
- 異なる言語クライアントからの JPedal の実行
JPedal には、簡単に始められるように idrsolutions/jpedal という Docker イメージが用意されています。この Docker イメージを使用することで、シンプルな REST API を使用して JPedal による変換を実行できるコンテナを起動できます。
このイメージは、Docker がインストールされているクラウドプラットフォームやサーバーから使用できます。独自のサーバー/インフラストラクチャで Docker イメージを使用する手順については、以下を参照してください。
開始する前に、WAR ファイルが必要です。これはダウンロードするか、自分でビルドすることができます。
この WAR ファイルは、JPedal サービスが動作するために必須です。
jpedal-microservice.war ファイルをダウンロードしてください。
トライアルユーザーは、トライアル登録 後の Docker セクションで WAR ファイルのダウンロードリンクを見つけることができます。
JPedal Microservice Example プロジェクトのコピーをビルドしてください。
手順は GitHub ページ
に記載されています。
Docker をインストールして使用できる状態にする方法を説明するチュートリアルは多数あります。この Docker のインストール チュートリアルで必要なすべてをカバーしています。
docker run -p 80:80 --mount "source=/path/to/war/jpedal-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/jpedal
本番環境での使用では、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 run コマンドに以下を追加することで実行できます。
--mount "source=/path/to/documents,target=/root/.idr,type=bind"
これで Docker サーバーが実行されましたので、API を使用するチュートリアルに従って変換を開始できます。