Lambda (SAM)

Esta guía te muestra cómo trabajar con AWS Lambda utilizando el Serverless Application Model (SAM) y Python. Este ejemplo demuestra cómo compilar y ejecutar un servicio local de API Gateway y Lambda para su invocación directa con el SDK.

Prerrequisitos

Docker instalado y en ejecución.
SAM CLI instalado.

Cómo ejecutar

Configurar el entorno: Ejecuta el script de configuración para instalar las herramientas y dependencias.
Ventana de terminal
```
scripts/setup.sh
```
Iniciar la infraestructura: Inicia ambos servicios locales de SAM (API Gateway y Lambda) en terminales separadas.
- API Gateway: para realizar peticiones HTTP o cURL:
  Ventana de terminal
```
sam local start-api
```
- Lambda SDK: para usar el AWS SDK (boto3) o la AWS CLI:
  Ventana de terminal
```
sam local start-lambda
```
Ejecutar el ejemplo:
Ventana de terminal
python main.py
Ventana de terminal
curl "http://127.0.0.1:3000/get_secret?username=admin"
1. Instala la extensión de VS Code REST Client.
2. Abre el archivo http/get_secret.http.
3. Ejecuta: Haz clic en Send Request sobre la URL.
1. Instala la AWS CLI.
2. Ejecuta si tienes AWS CLI instalada globalmente:
  Ventana de terminal
  aws lambda invoke --function-name GetSecretFunction --profile sam --payload '{"queryStringParameters": {"username": "admin"}}' output.json
3. Ejecuta si tienes AWS CLI instalada a través de mise:
  Ventana de terminal
  mise exec -- aws lambda invoke --function-name GetSecretFunction --profile sam --payload '{"queryStringParameters": {"username": "admin"}}' output.json
4. Verifica el archivo de salida output.json.

Cómo depurar

Utiliza los perfiles de depuración preconfigurados de VS Code:

Script Python (main.py):
- Asegúrate de que los servicios locales de SAM estén en ejecución (sam local start-api y sam local start-lambda).
- Ejecuta la configuración de depuración Python: Main.
Función Lambda:
- Ejecuta la configuración de depuración SAM: Debug get_secret.

Cómo testear

Todos los tests: Ejecuta el script automatizado:
Ventana de terminal
```
scripts/run_tests.sh
```
Individualmente: Usa la pestaña Testing de VS Code para ejecutar o depurar casos de test específicos.

Validar resultados

Logs: Revisa la salida de la consola en las terminales donde se está ejecutando sam local para verificar los detalles de la invocación y los mensajes de log.
AWS CLI Output: Verifica que el archivo generado output.json contenga el cuerpo de la respuesta HTTP y el código de estado esperados.

Limpieza

Detén los servicios locales de SAM activos en tus terminales.
Elimina el entorno virtual y las herramientas desinstaladas:
Ventana de terminal
```
rm -rf .venv
mise uninstall -a
```