Comandos del repo
Todos se corren con npm run <comando> desde la raíz del repo y funcionan igual en Windows (PowerShell), macOS y Linux. Usan el perfil, la Región y el nombre del stack de cdk.json.
Las opciones van como palabras, sin guiones (por ejemplo npm run datos mostrar-key), porque npm se queda con los --flags sueltos.
Para empezar
| Comando | Qué hace |
|---|---|
npm ci |
Instala exactamente lo que dice package-lock.json, con las protecciones del .npmrc |
npm run verify <N> |
El checkpoint del módulo N (0, 1, 2 <url>, 3, 4, 5 <url> o cognito). Si sale verde, terminaste |
npm run doctor |
Versiones de Node, npm, Git y AWS CLI, sesión, bootstrap, stack, Región y días restantes de AWS Free Tier |
Para desplegar
| Comando | Qué hace |
|---|---|
npm run bootstrap |
cdk bootstrap: prepara tu cuenta y Región para CDK. Se hace una sola vez |
npm run synth |
cdk synth: genera la plantilla de CloudFormation a partir de infra/gastos-stack.ts, sin desplegar nada |
npm run diff |
cdk diff: lista lo que cambiaría un deploy |
npm run deploy |
cdk deploy: empaqueta las Lambdas con esbuild y despliega. Te enseña los cambios de permisos y pregunta antes de aplicarlos |
npm run sync |
cdk watch: cada vez que guardas, sube el cambio y muestra los logs de tus Lambdas. Solo para desarrollo |
npm run probar |
Registra un gasto y lista los gastos de tu API. Con npm run probar 28 "galleta" snacks atajo registras el tuyo; con npm run probar lista solo los lista |
npm run preparar-pagina |
Escribe web/config.js con la URL de tu API; revísalo y usa git add -f web/config.js antes del commit |
Para ver los logs de una Lambda en vivo, con el AWS CLI:
aws logs tail /aws/lambda/gastos-hormiga-registrar --follow \
--profile gastos-hormiga
Para revisar
| Comando | Qué hace |
|---|---|
npm test |
Los tests de tests/ |
npm run typecheck |
Revisa los tipos de TypeScript |
npm run datos |
La URL de tu API. Con mostrar-key también la API key completa |
Para tu API key y tu usuario
| Comando | Qué hace |
|---|---|
npm run rotar-key |
Crea una API key nueva y borra la anterior. Pausa npm run sync antes |
npm run crear-usuario |
Crea tu usuario de Cognito (paso extra A) |
Para limpiar
| Comando | Qué hace |
|---|---|
npm run limpiar-practica |
Borra la Lambda, tabla, logs y roles de la práctica manual previa a CDK |
npm run limpiar |
Borra tu app completa, incluida la tabla con tus gastos. Pide confirmación |
Probar con otro perfil
Para correr un comando con otro perfil sin editar cdk.json, usa la variable GASTOS_PERFIL. Se escribe distinto en cada sistema:
Windows (PowerShell)
$env:GASTOS_PERFIL = "otro-perfil"
npm run verify 4
macOS y Linux
GASTOS_PERFIL=otro-perfil npm run verify 4