変換されたコンテンツをリモートに保存する
このオプションを使用すると、最終的なzipファイルをクラウドベースのストレージにアップロードするためのリモートストレージオプションを指定できます。
この機能は、使用するクラウドに応じて複数のプロパティファイルによって制御されます。アップロード先のクラウドプラットフォームは1つのオプションで制御します。
- storageprovider - 使用するリモートストレージクラスの完全修飾クラス名
まず、idr-microservice-storage からモジュールをビルドする必要があります。ビルド後、jarファイルをjpedal-microservice/libディレクトリに配置し、jpedal-microserviceのwarファイルをビルドしてください。
アプリサーバーを実行しているサーバー上に、以下のJavaプロパティファイルを作成します（まだ存在しない場合）{user.home}/.idr/jpedal-microservice/jpedal-microservice.properties
このファイルに以下のキーと値のペアを追加（またはキーが既に存在する場合は更新）してください。
- storageprovider - idr-microservice-storage
の完全修飾クラス名である必要があります。
例：storageprovider=com.idrsolutions.microservice.storage.AWSStorage
プラットフォームを選択したら、マイクロサービスがプラットフォームにファイルを送信できるようにするための追加の値を提供する必要があります。
以下、各プラットフォームの変数を示します。
AWS
- storageprovider - com.idrsolutions.microservice.storage.AWSStorageに設定する必要があります
- storageprovider.aws.accesskey - AWS -> IAM -> アクセス管理 -> ユーザーで確認できます
セキュリティ認証情報タブでアクセスキーを作成する必要がある場合があります - storageprovider.aws.secretkey - AWS -> IAM -> アクセス管理 -> ユーザーで確認できます
セキュリティ認証情報タブでアクセスキーを作成する必要がある場合があります - storageprovider.aws.bucketname - AWS -> S3で確認できます
名前列の値が必要です。 - storageprovider.aws.region - AWS -> S3で確認できます
バケット名のAWSリージョン列の値が必要です。 - storageprovider.aws.basepath - [オプション] ファイルが保存されるバケット内のパス。
Digital Ocean
- storageprovider - com.idrsolutions.microservice.storage.DOStorageに設定する必要があります
- storageprovider.do.accesskey - Digital Ocean -> APIで確認できます。ページ下部の「Space access keys」で新しいキーを生成/取得できます。
- storageprovider.do.secretkey - Digital Ocean -> APIで確認できます。ページ下部の「Space access keys」で新しいシークレットを生成/取得できます。
- storageprovider.do.bucketname - Digital Ocean -> Spacesで確認できます。名前列の値が必要です。
- storageprovider.do.region - Digital Ocean -> Spacesで確認できます。値はSpacesのURLの2番目と3番目の’.‘の間にあります。
- storageprovider.do.basepath - [オプション] ファイルが保存されるバケット内のパス。
Azure
- storageprovider - com.idrsolutions.microservice.storage.AzureStorageに設定する必要があります
- storageprovider.azure.accountname - Azure -> ストレージアカウントで確認でき、名前列の値です。
- storageprovider.azure.accountkey - Azure -> ストレージアカウント -> セキュリティ + ネットワーク -> アクセスキーで確認できます。
- storageprovider.azure.containername - ストレージアカウント内のblobコンテナーの名前。
- storageprovider.azure.basepath - [オプション] ファイルが保存されるバケット内のパス。
GCP
- storageprovider - com.idrsolutions.microservice.storage.GCPStorageに設定する必要があります
- storageprovider.gcp.credentialspath - GCP -> IAM -> サービスアカウントで認証情報ファイルを生成する必要があります
使用するバケットへの書き込み権限を持つサービスアカウントが必要です。サービスアカウントに入り、キータブに移動します。
JSON形式の新しいキーを作成し、ファイルをディスクに保存します。次に、マイクロシステムを実行しているデバイスにファイルを追加する必要があります。このオプションの値としてファイルのパスを使用してください。
Dockerを使用している場合は、ファイルをマウントし、この値をDocker上のパスに設定する必要があります。マウントは以下のように行えます。--mount "source=/path/to/gcp/credentials.json,target=/root/.gcp/credentials.json,type=bind" - storageprovider.gcp.projectid - バケットを含むプロジェクトの名前。GCP -> プロジェクト情報で確認できます。
- storageprovider.gcp.bucketname - ファイルを保存するバケットの名前。GCP -> Cloud Storageで確認できます
- storageprovider.gcp.basepath - [オプション] ファイルが保存されるバケット内のパス。
Oracle
- storageprovider - com.idrsolutions.microservice.storage.OracleStorageに設定する必要があります
- storageprovider.oracle.ociconfigfilepath - Oracle Cloud Platform -> Identity & Security -> ユーザーで生成された設定ファイルへのパス。まだ持っていない場合は、書き込み権限を持つユーザーを作成し、このユーザーを開いてAPIキーセクションに移動します。「APIキーの追加」オプションをクリックし、ポップアップ表示される秘密キーと公開キーの両方をダウンロードして、秘密キーをociという名前のディレクトリに保存してから、追加をクリックします。構成ファイルプレビューで、プレビュー内容をコピーし、秘密キーのパスを更新して、ociディレクトリ内のconfigという名前のファイルに保存します。Dockerを使用している場合は、ociディレクトリをマウントし、この値をDocker上の設定ファイルへのパスに設定する必要があります。マウントは以下のように行えます。
--mount "source=/path/to/oci/,target=/root/.oci/,type=bind"注：Dockerを使用している場合、設定ファイル内の秘密キーのパスは、Docker上の秘密キーのパスと一致する必要があります。 - storageprovider.oracle.region - これは設定ファイルで確認できます。または、Oracleポータルの右上隅にあるリージョン名を取得し、このルックアップテーブル でIDを見つけます。
- storageprovider.oracle.profile - 使用する設定ファイル内のプロファイル。これらは設定ファイル内で確認できます。
- storageprovider.oracle.bucketname - Oracle Cloud Platform -> ストレージ -> バケットで確認できます。名前列の値がバケット名です。
- storageprovider.oracle.namespace - Oracle Cloud Platform -> ストレージ -> バケットで確認できます。使用するバケットをクリックし、バケット情報タブの下にある名前空間エントリを確認します。
- storageprovider.oracle.basepath - [オプション] ファイルが保存されるバケット内のパス。
値が提供されていない場合、または無効な値が提供された場合、この機能は使用されず、zipファイルはサーバーのローカルストレージに保持されます。
Dockerイメージに独自のプロパティファイルを提供するには、プロパティファイルをイメージにマウントする必要があります。これは、docker runコマンドに以下を追加することで実行できます。
--mount "source=/path/to/properties/directory/jpedal-microservice.properties,target=/root/.idr/jpedal-microservice/jpedal-microservice.properties,type=bind"