クラウドストレージ

署名付きURL付きのS3互換オブジェクトストレージ。

エントリ種別

種別	説明
`config.aws`	AWS認証情報とリージョン設定
`cloudstorage.s3`	S3バケット接続

AWS設定

- name: aws_config
  kind: config.aws
  region: "us-east-1"
  access_key_id_env: "AWS_ACCESS_KEY_ID"
  secret_access_key_env: "AWS_SECRET_ACCESS_KEY"

フィールド	型	必須	説明
`region`	string	条件付き	AWSリージョン。`region_env` が設定されていない限り必須
`region_env`	string	条件付き	リージョンを保持する環境変数名
`access_key_id_env`	string	いいえ	アクセスキー用環境変数名
`secret_access_key_env`	string	いいえ	シークレットキー用環境変数名

認証情報は指定された環境変数からロードされます。静的な認証情報を適用するには access_key_id_env と secret_access_key_env の両方が空でない値に解決される必要があります。そうでない場合は、AWS SDK のデフォルト認証チェーン（IAM ロール、インスタンスプロファイルなど）が使用されます。

リクエストは、解決された認証情報を使用して AWS SDK によって AWS Signature Version 4 で署名されます。署名の設定は不要です。

値がデプロイごとに異なる場合は、_env バリアント（region_env、および後述の bucket_env/endpoint_env）を使用してください。変数名は起動時に環境レジストリから解決されます。 AWS設定は将来のリリースで他のAWSサービス（SQSなど）と共有される予定です。

S3ストレージ

- name: files
  kind: cloudstorage.s3
  bucket: "my-bucket"
  config: app.infra:aws_config

フィールド	型	必須	説明
`bucket`	string	条件付き	S3バケット名。`bucket_env` が設定されていない限り必須
`bucket_env`	string	条件付き	バケット名を保持する環境変数名
`config`	reference	はい	AWS設定エントリ参照
`endpoint`	string	いいえ	S3互換サービス用カスタムエンドポイント
`endpoint_env`	string	いいえ	カスタムエンドポイントを保持する環境変数名

S3互換サービス

MinIOまたは他のS3互換サービスの場合、カスタムエンドポイントを設定：

- name: local_storage
  kind: cloudstorage.s3
  bucket: "local-bucket"
  config: app.infra:aws_config
  endpoint: "http://localhost:9000"

エンドポイントが提供されると、パススタイルアクセスが自動的に有効になります。

Lua API

操作（list、upload、download、delete、署名付きURL）についてはクラウドストレージモジュールを参照してください。

クラウドストレージ

クラウドストレージ

エントリ種別

AWS設定

S3ストレージ

S3互換サービス

Lua API

関連項目