SST (Serverless Stack)

SST

Descripción general

SST (Serverless Stack) es un framework para construir y desplegar aplicaciones full-stack en AWS con constructos de alto nivel para Lambda, API Gateway, DynamoDB, S3 y frameworks frontend. Ofrece desarrollo local en vivo conectado a servicios reales de AWS, enlazado de recursos con tipado seguro y soporte TypeScript sin configuración.

Instrucciones

• Al definir infraestructura, usa sst.config.ts con componentes tipados como sst.aws.Function, sst.aws.Api, sst.aws.Bucket y sst.aws.Dynamo.
• Al conectar recursos, usa la propiedad link en las funciones para conceder automáticamente permisos IAM e inyectar variables de entorno; accede a los recursos enlazados mediante Resource.Name en los handlers.
• Durante el desarrollo local, usa sst dev que ejecuta Lambda localmente con recarga en caliente mientras está conectado a servicios reales de AWS (DynamoDB, S3, SQS), con soporte para depuración con puntos de interrupción en VS Code.
• Al desplegar, usa sst deploy --stage prod para etapas con nombre, sst deploy --stage pr-${PR_NUMBER} para entornos de vista previa y sst remove --stage dev para eliminar.
• Al desplegar frontends, usa los componentes sst.aws.Nextjs, sst.aws.Remix o sst.aws.Astro para SSR en Lambda con activos estáticos en S3 + CloudFront.
• Al gestionar secretos, usa sst secret set KEY value para almacenamiento cifrado y específico por etapa.
• Al organizar el código, mantén los handlers ligeros en packages/functions/ como orquestadores, y coloca la lógica de negocio en packages/core/.

Ejemplos

Ejemplo 1: Construir una API serverless con DynamoDB

Solicitud del usuario: "Crear una API REST en AWS con DynamoDB usando SST"

Acciones:

1. Define la tabla DynamoDB y API Gateway en sst.config.ts
2. Enlaza la tabla a las funciones handler de la API para permisos automáticos
3. Implementa handlers CRUD accediendo a Resource.MyTable.name
4. Ejecuta sst dev para desarrollo local en vivo contra servicios reales de AWS

Resultado: Una API REST serverless con acceso a recursos tipado y depuración en vivo.

Ejemplo 2: Desplegar una app Next.js con entornos de vista previa

Solicitud del usuario: "Desplegar mi app Next.js en AWS con entornos de vista previa por PR"

Acciones:

1. Configura el componente sst.aws.Nextjs con dominio personalizado y recursos enlazados
2. Configura CI para ejecutar sst deploy --stage pr-${PR_NUMBER} en cada pull request
3. Enlaza recursos backend (API, base de datos) al despliegue de Next.js
4. Agrega un paso de limpieza con sst remove cuando se cierre el PR

Resultado: Un despliegue de Next.js en producción en AWS con entornos de vista previa aislados para cada PR.

Directrices

• Usa link en lugar de políticas IAM manuales; SST genera permisos de mínimo privilegio automáticamente.
• Accede a los recursos enlazados mediante Resource.Name en los handlers; nunca codifiques nombres de tabla o ARN de bucket.
• Usa sst dev para el desarrollo diario; es más rápido que desplegar en AWS con cada cambio.
• Crea etapas por desarrollador (sst dev --stage alice) para que cada desarrollador tenga recursos AWS aislados.
• Mantén los handlers ligeros: lógica de negocio en packages/core/, handlers en packages/functions/.
• Usa sst secret para claves API y credenciales; están cifradas y son específicas por etapa.
• Configura sst deploy --stage pr-${PR_NUMBER} en CI para entornos de vista previa en cada pull request.