Déployer la version en ligne et de prévisualisation des canaux via des demandes d'extraction GitHub

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

  • Crée un canal de prévisualisation (et son URL de prévisualisation associée) pour chaque requête d'extraction dans votre dépôt GitHub.

  • Ajoute un commentaire à la requête d'extraction avec l'URL de prévisualisation afin que vous et chaque examinateur puissiez afficher et tester les modifications de la requête d'extraction dans une version "prévisualisation" de votre application.

    Image d'un commentaire de demande d'extraction GitHub Actions avec l'URL de l'aperçu

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

  • (Facultatif) Déploie l'état actuel de votre dépôt GitHub sur votre canal en direct lorsque la requête d'extraction est fusionnée.

Rappel : Lorsque vous utilisez des URL de prévisualisation, votre application interagit avec les ressources backend réelles de votre projet Firebase.

Configurer l'action GitHub pour déployer sur Firebase Hosting

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

  2. Dans une version locale de votre dépôt, configurez Firebase Hosting à l'aide de la firebase init commande.

    • Si vous n'avez PAS configuré Hosting, 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é Hosting, il vous suffit de configurer la partie de l'action GitHub de Hosting. Exécutez cette version de la commande à partir de la racine de votre répertoire local :

      firebase init hosting:github
  3. Suivez les invites de l'interface de ligne de commande. La commande se chargera automatiquement de la configuration de 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 transfère vers le dépôt GitHub spécifié en tant que secret GitHub.

    • Écrit des fichiers de configuration yaml de workflow GitHub qui font référence au secret nouvellement créé. Ces fichiers configurent l'action GitHub pour déployer sur Firebase Hosting.

  4. Dans GitHub, créez une branche et validez les fichiers yaml de workflow créés par l'interface de ligne de commande.

  5. Publiez la branche dans votre dépôt GitHub.

  6. Fusionnez la branche.

Et voilà ! Toute requête d'extraction ultérieure dans ce dépôt GitHub recevra automatiquement sa propre "URL de prévisualisation".

En savoir plus sur l'action GitHub

  • Firebase gère l'action GitHub "Deploy to Firebase Hosting" en tant que projet Open Source. Afficher le code source

  • L'action GitHub "Deploy to Firebase Hosting" (Déployer sur Firebase Hosting) permet une configuration plus poussée, comme la personnalisation de la date d'expiration d'un canal de prévisualisation ou la définition d'un canal non en direct sur lequel déployer lorsqu'une requête d'extraction est fusionnée. En savoir plus sur les options de configuration disponibles

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