変換されたコンテンツをリモートで保存する
この機能について
このオプションを使用すると、最終的な 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
プラットフォームを選択したら、マイクロサービスがプラットフォームにファイルを送信できるようにするために追加の値を指定する必要があります。
以下に各プラットフォームの変数を示します。
- storageprovider – com.idrsolutions.microservice.storage.AWSStorage に設定する必要があります。
- storageprovider.aws.accesskey – AWS -> IAM -> アクセス管理 -> ユーザーにあります。セキュリティ認証情報タブでアクセス キーを作成する必要がある場合があります。
- storageprovider.aws.secretkey – AWS -> IAM -> アクセス管理 -> ユーザーにあります。
セキュリティ認証情報タブでアクセス キーを作成する必要がある場合があります。 - storageprovider.aws.bucketname – AWS、AWS -> S3 にあります。
[名前] 列の値が必要です。 - storageprovider.aws.region – AWS、AWS -> S3 にあります。
バケット名には AWS リージョン列の値が必要です。 - storageprovider.aws.basepath – [オプション] ファイルが保存されるバケット内のパス。
- storageprovider – com.idrsolutions.microservice.storage.DOStorage に設定する必要があります。
- storageprovider.do.accesskey – Digital Ocean -> API にあります。ページの下部に「スペース アクセス キー」があり、ここで新しいキーを生成/取得できます。
- storageprovider.do.secretkey – Digital Ocean -> API にあります。ページの下部に「スペース アクセス キー」があり、ここで新しいシークレットを生成/取得できます。
- storageprovider.do.bucketname – Digital Ocean -> Spaces にあります。 [名前] 列の値が必要です。
- storageprovider.do.region – Digital Ocean -> Spaces で見つかります。値は、Spaces URL の 2 番目と 3 番目の「.」の間にあります。
- storageprovider.do.basepath – [オプション] ファイルが保存されるバケット内のパス。
- storageprovider – com.idrsolutions.microservice.storage.AzureStorage に設定する必要があります。
- storageprovider.azure.accountname – [Azure] -> [ストレージ アカウント] で、[名前] 列の下の値を確認できます。
- storageprovider.azure.accountkey – Azure -> ストレージ アカウント -> セキュリティ + ネットワーク -> アクセス キーにあります。
- storageprovider.azure.containername – ストレージ アカウント内の BLOB コンテナーの名前。
- storageprovider.azure.basepath – [オプション] ファイルが保存されるバケット内のパス。
- 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 – [オプション] ファイルが保存されるバケット内のパス。
- storageprovider – com.idrsolutions.microservice.storage.OracleStorage に設定する必要があります。
- storageprovider.oracle.ociconfigfilepath – Oracle CLoud Platformで生成された構成ファイルへのパス -> Identity * Security -> Users まだ持っていない場合は、書き込み権限を持つユーザーを作成し、このユーザーを開いて「API Keys」セクションに移動します。「API キーの追加」オプションをクリックし、ポップアップ表示される秘密キーと公開キーの両方をダウンロードし、秘密キーを oci というディレクトリに保存して、「追加」をクリックします。構成ファイルのプレビューで、プレビューの内容をコピーし、秘密キーのパスを更新して、oci ディレクトリ内の config という名前のファイルに保存します。Docker を使用する場合は、oci ディレクトリをマウントし、この値を Docker 上の構成ファイルへのパスに設定する必要があります。マウントは以下のように行うことができます。
--mount "source=/path/to/oci/,target=/root/.oci/,type=bind"
docker を使用する場合、構成ファイル内の秘密キーのパスは、秘密キーの docker イメージのパスと一致する必要があることに注意してください。 - storageprovider.oracle.region – これは構成ファイルで見つけることができます。または、Oracle Portal の右上隅にあるリージョン名を取得して、この検索テーブルで ID を見つけます。
- storageprovider.oracle.profile – 使用する構成ファイル内のプロファイル。これらは構成ファイル内にあります。
- storageprovider.oracle.bucketname – Oracle Cloud Platform -> Storage -> Buckets にあります。 name 列の値はバケット名です。
- storageprovider.oracle.namespace – Oracle Cloud Platform -> Storage -> Buckets にあります。使用するバケットをクリックすると、「バケット情報」タブの下にネームスペース・エントリが表示されます。
- storageprovider.oracle.basepath – [オプション] ファイルが保存されるバケット内のパス。
デフォルト値
値が指定されない場合、または無効な値が指定された場合、この機能は使用されず、zip ファイルはサーバーのローカル ストレージに保持されます。
Dockerでの使い方
独自のプロパティ ファイルを Docker イメージに提供するには、プロパティ ファイルをイメージにマウントする必要があります。これを行うには、docker run コマンドに以下を追加します。
--mount "source=/path/to/properties/directory/jpedal-microservice.properties,target=/root/.idr/jpedal-microservice/jpedal-microservice.properties,type=bind"