Saltar al contenido principal

Despliegue de API

Las APIs de ChurchApps se despliegan como funciones de AWS Lambda utilizando Serverless Framework. Esta página cubre el flujo de compilación, despliegue y configuración para entornos de preparación y producción.

Antes de Comenzar

  • Configurar la API localmente -- ver Configuración Local de API
  • Configurar credenciales de AWS en su máquina
  • Asegúrese de tener acceso a la cuenta de AWS de destino

Compilación​

Las APIs se compilan para producción utilizando una configuración TypeScript dedicada:

npm run build:prod

Esto utiliza tsconfig.prod.json para compilar el proyecto para el tiempo de ejecución de Lambda.

Despliegue​

Desplegar en preparación:

npm run deploy-staging

Desplegar en producción:

npm run deploy-prod

Lo Que Se Crea​

Cada despliegue de API crea o actualiza las siguientes funciones de AWS Lambda:

FunciónPropósito
webControlador de solicitud HTTP a través de API Gateway
socketControlador de conexión de WebSocket
timer15MinTarea programada que se ejecuta cada 15 minutos
timerMidnightTarea programada que se ejecuta diariamente a medianoche

Configuración de Entorno​

En entornos desplegados, la configuración se lee desde AWS SSM Parameter Store en lugar de archivos .env. Esto mantiene los secretos fuera del paquete de despliegue y permite cambios de configuración sin redeploying.

aviso

Nunca confirme credenciales de producción al repositorio. Toda la configuración sensible debe almacenarse en AWS SSM Parameter Store y accederse en tiempo de ejecución.

tip

Para probar un despliegue sin afectar la producción, siempre despliega primero en preparación usando npm run deploy-staging y verifica los cambios antes de promover a producción.

Artículos Relacionados​