Vai al contenuto principale

Distribuzione delle API

Le API di ChurchApps vengono distribuite come funzioni AWS Lambda utilizzando il Serverless Framework. Questa pagina copre il flusso di lavoro di build, distribuzione e configurazione per gli ambienti di staging e produzione.

Prima di Iniziare

  • Configura l'API in locale -- vedi Configurazione API Locale
  • Configura le credenziali AWS sulla tua macchina
  • Assicurati di avere accesso all'account AWS di destinazione

Build​

Le API vengono compilate per la produzione utilizzando una configurazione TypeScript dedicata:

npm run build:prod

Questo utilizza tsconfig.prod.json per compilare il progetto per il runtime Lambda.

Distribuzione​

Distribuisci in staging:

npm run deploy-staging

Distribuisci in produzione:

npm run deploy-prod

Cosa Viene Creato​

Ogni distribuzione dell'API crea o aggiorna le seguenti funzioni AWS Lambda:

FunzioneScopo
webGestore delle richieste HTTP tramite API Gateway
socketGestore delle connessioni WebSocket
timer15MinAttività pianificata che viene eseguita ogni 15 minuti
timerMidnightAttività pianificata che viene eseguita ogni giorno a mezzanotte

Configurazione dell'Ambiente​

Negli ambienti distribuiti, la configurazione viene letta da AWS SSM Parameter Store anziché dai file .env. Questo mantiene i segreti fuori dal pacchetto di distribuzione e consente modifiche alla configurazione senza ridistribuire.

Avviso

Non committare mai le credenziali di produzione nel repository. Tutta la configurazione sensibile deve essere memorizzata in AWS SSM Parameter Store e accessibile a runtime.

Suggerimento

Per testare una distribuzione senza influire sulla produzione, distribuisci sempre prima in staging utilizzando npm run deploy-staging e verifica le modifiche prima di promuoverle in produzione.

Articoli Correlati​