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