Storage Writer

Esta guía te muestra cómo construir una función AWS Lambda que sube archivos a S3 localmente usando LocalStack. Este lab demuestra múltiples métodos de despliegue — Terraform, CloudFormation y Boto3.

Prerrequisitos

• Docker instalado y en ejecución.
• Dev Containers extension instalada (opcional).
• AWS Toolkit para VS Code (opcional, incluido en el Dev Container).

Cómo ejecutar

1. Configurar el entorno:

   Dev Container (recomendado)

   Abre VS Code en la carpeta del proyecto y ejecuta este comando en la Paleta de Comandos:

   > Dev Containers: Reopen in Container

   Manual
   1. Inicia LocalStack:

      docker compose up -d localstack

   2. Configura el entorno (instala mise, Python, AWS CLI, Terraform y sincroniza dependencias):

      scripts/setup-mve.sh

   3. Instala el AWS Toolkit: Instala la extensión AWS Toolkit y conecta usando el perfil localstack configurado por el script de instalación.
   4. Despliega los recursos:

      scripts/boto3/deploy.sh

2. Ejecutar el ejemplo:

   Python

   python main.py

   AWS Toolkit
   1. Selecciona el perfil localstack en el AWS Toolkit.
   2. Haz clic derecho en la función upload-to-s3 y selecciona Invoke Lambda….

Métodos de despliegue

Hay otros métodos de despliegue que puedes usar en este lab.

Terraform

scripts/terraform/deploy.sh

CloudFormation

scripts/cloudformation/deploy.sh

Boto3

scripts/boto3/deploy.sh

Cambio de método de despliegue

Si cambias entre Terraform, CloudFormation o Boto3, ejecuta Limpieza primero para evitar conflictos de nombres de recursos.

Validar resultados

AWS CLI

• Comprueba el bucket S3:

  aws s3 ls s3://test-bucket/ --profile localstack

• Consulta los logs de Lambda:

  aws logs tail /aws/lambda/upload-to-s3 --profile localstack

AWS Toolkit

• S3: Despliega la sección S3 para ver los archivos subidos.
• CloudWatch: Despliega la sección Logs para ver la salida de ejecución de Lambda.

Limpieza

Para eliminar únicamente los recursos desplegados, ejecuta el script de destrucción del método que usaste:

Terraform

scripts/terraform/destroy.sh

CloudFormation

scripts/cloudformation/destroy.sh

Boto3

scripts/boto3/destroy.sh

Para eliminar también todos los contenedores y volúmenes:

docker compose down -v

Solución de problemas

Problema	Solución
Timeout de Lambda	Asegúrate de que LocalStack tiene suficientes recursos de memoria y CPU.
Conexión rechazada	Asegúrate de que LocalStack está en ejecución y espera el mensaje Ready. en los logs.

Siguientes pasos

• Consulta el proyecto equivalente en Azure.
• Consulta el proyecto equivalente en Google Cloud.
• Profundiza en el Lab Lambda (SAM).
• Profundiza en el Lab S3 (MinIO).