Pular para o conteúdo principal

Implantação de APIs

As APIs do ChurchApps são implantadas como funções AWS Lambda usando o Serverless Framework. Esta página cobre o fluxo de build, implantação e configuração para ambientes de staging e produção.

Antes de Começar

  • Configure a API localmente -- veja Configuração Local da API
  • Configure as credenciais AWS na sua máquina
  • Certifique-se de ter acesso à conta AWS de destino

Build​

As APIs são construídas para produção usando uma configuração TypeScript dedicada:

npm run build:prod

Isso usa o tsconfig.prod.json para compilar o projeto para o runtime Lambda.

Implantação​

Implantar em staging:

npm run deploy-staging

Implantar em produção:

npm run deploy-prod

O Que É Criado​

Cada implantação de API cria ou atualiza as seguintes funções AWS Lambda:

FunçãoPropósito
webManipulador de requisições HTTP via API Gateway
socketManipulador de conexões WebSocket
timer15MinTarefa agendada que executa a cada 15 minutos
timerMidnightTarefa agendada que executa diariamente à meia-noite

Configuração de Ambiente​

Em ambientes implantados, a configuração é lida do AWS SSM Parameter Store em vez de arquivos .env. Isso mantém segredos fora do pacote de implantação e permite alterações de configuração sem reimplantar.

Aviso

Nunca faça commit de credenciais de produção no repositório. Todas as configurações sensíveis devem ser armazenadas no AWS SSM Parameter Store e acessadas em tempo de execução.

Dica

Para testar uma implantação sem afetar a produção, sempre implante em staging primeiro usando npm run deploy-staging e verifique as alterações antes de promover para prod.

Artigos Relacionados​