SQL Writer

Esta guía te muestra cómo construir un escenario de nube híbrida usando LocalStack y una instancia externa de PostgreSQL. Este lab demuestra cómo una AWS Lambda recupera secretos de Secrets Manager e interactúa con una base de datos fuera del entorno AWS.

Prerrequisitos

Docker instalado y en ejecución.
Dev Containers extension instalada (opcional).
Terraform (incluido en el Dev Container).
AWS CLI (incluido en el Dev Container).
DBeaver o cualquier cliente SQL (para verificar resultados).

Cómo ejecutar

Configurar el entorno:
- Dev Container (recomendado)
- Manual
Abre VS Code en la carpeta del proyecto y ejecuta este comando en la Paleta de Comandos:
Ventana de terminal
> Dev Containers: Reopen in Container
Ventana de terminal
docker compose up -d

A continuación, configura el AWS CLI:

aws configure set aws_access_key_id test
aws configure set aws_secret_access_key test
aws configure set region us-east-1

Desplegar recursos:

python package_lambda.py
terraform init && terraform apply -auto-approve

Ejecutar el ejemplo:

aws --endpoint-url=http://localhost:4566 lambda invoke \
    --function-name AddUserFunction \
    --payload '{}' \
    response.json

Validar resultados

Verifica con DBeaver: Conecta a la instancia local de PostgreSQL y ejecuta la siguiente consulta:
- Host: localhost.
- Port: 5432.
- Database: mydb.
- User: myuser.
- Password: mypassword.
```
SELECT * FROM users ORDER BY created_at DESC;
```

Verifica con AWS CLI:

Lista las funciones Lambda:

aws --endpoint-url=http://localhost:4566 lambda list-functions

Comprueba los secretos:

aws --endpoint-url=http://localhost:4566 secretsmanager list-secrets

Limpieza

terraform destroy -auto-approve
docker compose down -v
rm lambda.zip response.json

Solución de problemas

Problema	Solución
Conexión rechazada	Asegúrate de que `host.docker.internal` es accesible desde el contenedor LocalStack. En versiones antiguas de Docker en Linux, añádelo a `extra_hosts` en `docker-compose.yml`.
Puerto ya en uso	Modifica los mapeos de puertos para `4566` o `5432` en `docker-compose.yml`.