Step Functions (LocalStack)

Esta guía te muestra cómo trabajar con AWS Step Functions localmente usando LocalStack, Python y el AWS Toolkit para VS Code. Este lab demuestra un flujo de incorporación de usuarios con ejecución paralela de Lambda y creación de usuarios IAM.

Prerrequisitos

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

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
pip3 install uv && uv sync

Configurar el perfil de LocalStack: Configura un perfil de AWS dedicado para LocalStack:

aws configure set aws_access_key_id test --profile localstack
aws configure set aws_secret_access_key test --profile localstack
aws configure set region us-east-1 --profile localstack
aws configure set output json --profile localstack
aws configure set endpoint_url http://localhost:4566 --profile localstack

Ejecutar el ejemplo:
- Inicia LocalStack:
  Ventana de terminal
```
docker compose up -d
```
- Despliega la infraestructura:
  Ventana de terminal
```
python deploy.py
```
- Ejecuta el flujo:
  Ventana de terminal
```
python main.py
```

Uso del AWS Toolkit

Abre la Paleta de Comandos: Pulsa F1 o Ctrl+Shift+P.
Conecta a AWS: Escribe y selecciona AWS: Connect to AWS.
Selecciona el perfil: Selecciona el perfil localstack.
Visualiza el grafo: Abre step_function.asl.json y haz clic en el icono Visual Graph (arriba a la derecha).
Ejecuta: En el AWS Explorer, haz clic derecho en UserOnboardingWorkflow y selecciona Start Execution.

Validar resultados

Verifica la creación del usuario IAM:
Ventana de terminal
```
aws iam list-users --profile localstack
```

Verifica los logs de DynamoDB:

aws dynamodb scan --table-name UserLogs --profile localstack

Verifica las funciones Lambda:

aws lambda list-functions --profile localstack

Limpieza

docker compose down -v

Solución de problemas

Problema	Solución
La función Lambda está en estado ‘Pending’	Espera 5-10 segundos después de `deploy.py` e inténtalo de nuevo. LocalStack puede estar todavía inicializando el entorno Lambda.
Conexión rechazada	Asegúrate de que LocalStack está en ejecución: `docker ps`