Aller au contenu principal

Déploiement des applications web

Les applications web ChurchApps sont déployées en tant que sites statiques sur Amazon S3 avec CloudFront en tant que CDN. Les déploiements sont automatisés via GitHub Actions, mais peuvent également être exécutés manuellement si nécessaire.

Avant de commencer

  • Configurer l'application web localement et vérifier qu'elle compile -- voir Applications web
  • Configurer les credentials AWS avec l'accès S3 et CloudFront
  • Connaître le nom du bucket S3 cible et l'ID de distribution CloudFront

Étapes de déploiement​

  1. Construire l'application -- générer la sortie statique :

    npm run build

  2. Synchroniser vers S3 -- télécharger la sortie de build vers le bucket S3 :

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

  3. Invalider CloudFront -- vider le cache du CDN afin que les utilisateurs reçoivent la dernière version :

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

Déploiements automatisés​

Les workflows GitHub Actions gèrent le déploiement automatiquement lors de la poussée vers la branche main. Le workflow exécute les trois étapes ci-dessus -- construction, synchronisation S3 et invalidation CloudFront -- sans intervention manuelle.

info

Vous n'avez généralement pas besoin d'exécuter ces commandes manuellement. Fusionner une demande de tirage dans main déclenche le pipeline de déploiement automatisé.

astuce

Si vous avez besoin de vérifier une build localement avant de déployer, exécutez npm run build et inspectez la sortie dans le répertoire build/. Vous pouvez le servir localement avec n'importe quel serveur de fichiers statiques pour confirmer que tout fonctionne.

Articles connexes​