Déployez sur des canaux en direct et en avant-première via des demandes d'extraction GitHub

Vous pouvez intégrer des déploiements à Firebase Hosting via une action GitHub. Voici ce que cette action GitHub peut faire pour vous :

  • Crée un nouveau canal de prévisualisation (et son URL de prévisualisation associée) pour chaque PR sur votre référentiel GitHub.

  • Ajoute un commentaire au PR avec l'URL d'aperçu afin que vous et chaque examinateur puissiez voir et tester les modifications du PR dans une version « aperçu » de votre application.

    image du commentaire GitHub Action PR avec l'URL d'aperçu

  • Met à jour l'URL d'aperçu avec les modifications de chaque validation en déployant automatiquement sur le canal d'aperçu associé. L'URL ne change pas à chaque nouveau commit.

  • (Facultatif) Déploie l'état actuel de votre référentiel GitHub sur votre canal en direct lorsque le PR est fusionné.

Rappel : Lorsque vous utilisez des URL d'aperçu, votre application interagit avec les véritables ressources backend de votre projet Firebase.

Configurer l'action GitHub à déployer sur l'hébergement Firebase

  1. Créez un référentiel GitHub (public ou privé) ou utilisez-en un existant. Vous devez disposer des autorisations d'administrateur pour le référentiel.

  2. Dans une version locale de votre référentiel, configurez Firebase Hosting à l'aide de la commande firebase init .

    • Si vous n'avez PAS configuré l'hébergement, exécutez cette version de la commande à partir de la racine de votre répertoire local :

      firebase init hosting
    • Si vous avez DÉJÀ configuré l'hébergement, il vous suffit de configurer la partie GitHub Action de l'hébergement. Exécutez cette version de la commande à partir de la racine de votre répertoire local :

      firebase init hosting:github
  3. Suivez les invites CLI et la commande se chargera automatiquement de configurer l'action GitHub :

    • Crée un compte de service dans votre projet Firebase avec l'autorisation de déployer sur Firebase Hosting.

    • Chiffre la clé JSON de ce compte de service et la télécharge dans le référentiel GitHub spécifié en tant que secret GitHub .

    • Écrit les fichiers de configuration yaml du flux de travail GitHub qui référencent le secret nouvellement créé. Ces fichiers configurent l'action GitHub à déployer sur l'hébergement Firebase.

  4. Dans GitHub, créez une nouvelle branche et validez les fichiers yaml de workflow créés par la CLI.

  5. Publiez la branche dans votre référentiel GitHub.

  6. Fusionner la branche.

C'est ça! Tout PR ultérieur dans ce référentiel GitHub obtiendra automatiquement sa propre "URL de prévisualisation" !

En savoir plus sur l'action GitHub

  • Firebase maintient l'action GitHub "Déployer sur l'hébergement Firebase" en tant que projet open source. Afficher le code source.

  • L'action GitHub "Déployer sur l'hébergement Firebase" permet une configuration supplémentaire, comme la personnalisation de la date d'expiration d'un canal de prévisualisation ou la définition d'un canal non actif à déployer lors de la fusion d'un PR. Découvrez les options de configuration disponibles.

  • En savoir plus sur les actions GitHub en général.