Vai al contenuto principale

Distribuzione delle Applicazioni Web

Le applicazioni web di ChurchApps vengono distribuite come siti statici su Amazon S3 con CloudFront come CDN. Le distribuzioni sono automatizzate tramite GitHub Actions, ma possono anche essere eseguite manualmente quando necessario.

Prima di Iniziare

  • Configura l'applicazione web in locale e verifica che si compili -- vedi Applicazioni Web
  • Configura le credenziali AWS con accesso a S3 e CloudFront
  • Conosci il nome del bucket S3 di destinazione e l'ID della distribuzione CloudFront

Passaggi di Distribuzione​

  1. Compila l'app -- genera l'output statico:

    npm run build

  2. Sincronizza con S3 -- carica l'output della build nel bucket S3:

    aws s3 sync build/ s3://bucket-name

  3. Invalida CloudFront -- svuota la cache del CDN in modo che gli utenti ricevano la versione più recente:

    aws cloudfront create-invalidation --distribution-id YOUR_DIST_ID --paths "/*"

Distribuzioni Automatizzate​

I workflow di GitHub Actions gestiscono la distribuzione automaticamente al push nel branch main. Il workflow esegue tutti e tre i passaggi sopra -- build, sincronizzazione S3 e invalidazione CloudFront -- senza intervento manuale.

Info

In genere non è necessario eseguire questi comandi manualmente. L'unione di una pull request in main attiva la pipeline di distribuzione automatizzata.

Suggerimento

Se devi verificare una build in locale prima della distribuzione, esegui npm run build e ispeziona l'output nella directory build/. Puoi servirla localmente con qualsiasi server di file statici per confermare che tutto funzioni.

Articoli Correlati​