Almacenamiento en la Nube

Almacenamiento en la Nube

Almacenamiento de objetos compatible con S3 con URLs prefirmadas.

Tipos de Entrada

Tipo	Descripción
config.aws	Configuración de credenciales y región AWS
cloudstorage.s3	Conexión a bucket S3

Configuración 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"

Campo	Tipo	Requerido	Descripción
region	string	Condicional	Región AWS. Requerido salvo que se establezca region_env
region_env	string	Condicional	Nombre de variable de entorno que contiene la región
access_key_id_env	string	No	Nombre de variable de entorno para access key
secret_access_key_env	string	No	Nombre de variable de entorno para secret key

Las credenciales se cargan desde las variables de entorno especificadas. Tanto access_key_id_env como secret_access_key_env deben resolverse a valores no vacíos para que se apliquen credenciales estáticas; en caso contrario se usa la cadena de credenciales por defecto del SDK de AWS (roles IAM, perfiles de instancia, etc.).

Las solicitudes son firmadas con AWS Signature Version 4 por el SDK de AWS usando las credenciales resueltas. No se requiere configuración de firma.

Usa las variantes _env (region_env, y bucket_env/endpoint_env más abajo) cuando un valor difiere por despliegue. El nombre de la variable se resuelve desde el registro de entorno en el arranque. La configuración AWS está planeada para compartirse con otros servicios AWS (SQS, etc.) en futuras versiones.

Almacenamiento S3

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

Campo	Tipo	Requerido	Descripción
bucket	string	Condicional	Nombre del bucket S3. Requerido salvo que se establezca bucket_env
bucket_env	string	Condicional	Nombre de variable de entorno que contiene el nombre del bucket
config	referencia	Sí	Referencia a entrada de config AWS
endpoint	string	No	Endpoint personalizado para servicios compatibles con S3
endpoint_env	string	No	Nombre de variable de entorno que contiene el endpoint personalizado

Servicios Compatibles con S3

Para MinIO u otros servicios compatibles con S3, establezca un endpoint personalizado:

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

Cuando se proporciona un endpoint, el acceso por estilo de ruta se habilita automáticamente.

API Lua

Ver Módulo Cloud Storage para operaciones (list, upload, download, delete, URLs prefirmadas).

Ver También

• Módulo Cloud Storage - Referencia de la API Lua
• Filesystem - Entradas de filesystem local
• Queue - El handler SQS comparte las mismas entradas config.aws