Cloud-Speicher

S3-kompatibler Objektspeicher mit vorsignierten URLs.

Entry-Typen

Kind	Beschreibung
`config.aws`	AWS-Anmeldedaten und Regionskonfiguration
`cloudstorage.s3`	S3-Bucket-Verbindung

AWS-Konfiguration

- 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"

Feld	Typ	Erforderlich	Beschreibung
`region`	string	Bedingt	AWS-Region. Erforderlich, sofern `region_env` nicht gesetzt ist
`region_env`	string	Bedingt	Name der Umgebungsvariable, die die Region enthält
`access_key_id_env`	string	Nein	Umgebungsvariablenname für Access Key
`secret_access_key_env`	string	Nein	Umgebungsvariablenname für Secret Key

Anmeldedaten werden aus den angegebenen Umgebungsvariablen geladen. Sowohl access_key_id_env als auch secret_access_key_env müssen sich zu nicht-leeren Werten auflösen, damit statische Anmeldedaten greifen; andernfalls wird die AWS SDK Standard-Anmeldekette verwendet (IAM-Rollen, Instanzprofile, etc.).

Requests werden vom AWS SDK mit AWS Signature Version 4 unter Verwendung der aufgelösten Anmeldedaten signiert. Es ist keine Signierungskonfiguration erforderlich.

Verwenden Sie die _env-Varianten (region_env sowie bucket_env/endpoint_env unten), wenn ein Wert je Deployment unterschiedlich ist. Der Variablenname wird beim Start aus der Umgebungs-Registry aufgelöst. AWS-Konfiguration ist geplant, in zukünftigen Releases mit anderen AWS-Diensten (SQS, etc.) geteilt zu werden.

S3-Speicher

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

Feld	Typ	Erforderlich	Beschreibung
`bucket`	string	Bedingt	S3-Bucket-Name. Erforderlich, sofern `bucket_env` nicht gesetzt ist
`bucket_env`	string	Bedingt	Name der Umgebungsvariable, die den Bucket-Namen enthält
`config`	reference	Ja	AWS-Konfigurations-Entry-Referenz
`endpoint`	string	Nein	Benutzerdefinierter Endpunkt für S3-kompatible Dienste
`endpoint_env`	string	Nein	Name der Umgebungsvariable, die den benutzerdefinierten Endpunkt enthält

S3-kompatible Dienste

Für MinIO oder andere S3-kompatible Dienste setzen Sie einen benutzerdefinierten Endpunkt:

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

Wenn ein Endpunkt angegeben wird, wird Pfadstil-Zugriff automatisch aktiviert.

Lua-API

Siehe Cloud-Storage-Modul für Operationen (list, upload, download, delete, vorsignierte URLs).

Siehe auch

Cloud-Storage-Modul - Lua-API-Referenz
Dateisystem - Lokale Dateisystem-Einträge
Queue - Der SQS-Handler nutzt dieselben config.aws-Einträge