Déployer la version en ligne et de prévisualisation des canaux via des demandes d'extraction GitHub
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Vous pouvez intégrer les déploiements à Firebase Hosting via une action GitHub. Voici ce que cette action GitHub peut faire pour vous :
Crée un canal d'aperçu (et son URL d'aperçu associée) pour chaque demande d'extraction dans votre dépôt GitHub.
Ajoute un commentaire à la demande de pull avec l'URL de l'aperçu afin que vous et chaque réviseur puissiez afficher et tester les modifications de la demande de pull dans une version "preview" de votre application.
Met à jour l'URL d'aperçu avec les modifications apportées à chaque commit en déployant automatiquement le contenu sur le canal d'aperçu associé. L'URL ne change pas à chaque nouveau commit.
(Facultatif) Déploie l'état actuel de votre dépôt GitHub sur votre chaîne en direct lorsque la demande d'extraction est fusionnée.
Rappel : Lorsque vous utilisez des URL d'aperçu, votre application interagit avec les ressources de backend réelles de votre projet Firebase.
Configurer l'action GitHub pour le déploiement sur Firebase Hosting
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.
Dans une version locale de votre dépôt, configurez Firebase Hosting à l'aide de la commande firebase init.
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 GitHub Actions de Hosting. Exécutez cette version de la commande à partir de la racine de votre répertoire local :
firebase init hosting:github
Suivez les invites de l'interface de ligne de commande. 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 l'importe dans le dépôt GitHub spécifié en tant que secret GitHub.
Écrit les fichiers de configuration du workflow GitHub yaml qui font référence au secret nouvellement créé. Ces fichiers configurent l'action GitHub pour le déploiement sur Firebase Hosting.
Dans GitHub, créez une branche et validez les fichiers de workflow yaml créés par la CLI.
Publiez la branche dans votre dépôt GitHub.
Fusionnez la branche.
Et voilà ! Toute demande de pull ultérieure dans ce dépôt GitHub obtiendra automatiquement sa propre "URL de prévisualisation".
En savoir plus sur l'action GitHub
Firebase gère l'action GitHub "Déployer sur Firebase Hosting" en tant que projet Open Source.
Affichez le code source.
L'action GitHub "Deploy to Firebase Hosting" permet une configuration plus poussée, par exemple en personnalisant la date d'expiration d'un canal d'aperçu ou en définissant un canal non actif sur lequel déployer une requête d'extraction lorsqu'elle est fusionnée.
Découvrez les options de configuration disponibles.
En savoir plus sur les actions GitHub en général
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[null,null,["Dernière mise à jour le 2025/08/08 (UTC)."],[],[],null,["\u003cbr /\u003e\n\nYou can integrate deploys to Firebase Hosting via a GitHub Action. Here's\nwhat this GitHub Action can do for you:\n\n- Creates a new preview channel (and its associated preview URL) for every PR on\n your GitHub repository.\n\n- Adds a comment to the PR with the preview URL\n so that you and each reviewer can view and test the PR's changes in a\n \"preview\" version of your app.\n\n- Updates the preview URL with changes from each commit by automatically\n deploying to the associated preview channel. The URL doesn't change with each\n new commit.\n\n- *(Optional)* Deploys the current state of your GitHub repo to your live\n channel when the PR is merged.\n\nReminder: When using preview URLs, your app interacts with the *real* backend\nresources of your Firebase project.\n\nSet up the GitHub Action to deploy to Firebase Hosting\n\n1. Create a GitHub repository (public or private) or use an existing one. You\n must have admin permissions for the repository.\n\n2. In a local version of your repo, set up Firebase Hosting using the\n [`firebase init` command](/docs/hosting/quickstart#initialize).\n\n - If you've NOT set up Hosting, run this version of the command\n from the root of your local directory:\n\n ```\n firebase init hosting\n ```\n - If you've ALREADY set up Hosting, then you just need to set up the\n GitHub Action part of Hosting. Run this version of the command from\n the root of your local directory:\n\n ```\n firebase init hosting:github\n ```\n3. Follow the CLI prompts, and the command will automatically take care of\n setting up the GitHub Action:\n\n - Creates a service account in your Firebase project with permission to\n deploy to Firebase Hosting.\n\n - Encrypts that service account's JSON key and uploads it to the specified\n GitHub repository as a\n [GitHub secret](//docs.github.com/en/free-pro-team@latest/actions/reference/encrypted-secrets).\n\n - Writes GitHub workflow `yaml` configuration files that reference the\n newly created secret. These files configure the GitHub Action to deploy to\n Firebase Hosting.\n\n4. In GitHub, create a new branch and commit the workflow `yaml` files created\n by the CLI.\n\n5. Publish the branch to your GitHub repository.\n\n6. Merge the branch.\n\nThat's it! Any subsequent PR in this GitHub repo will automatically get its own\n\"preview URL\"!\n\nLearn more about the GitHub Action\n\n- Firebase maintains the \"Deploy to Firebase Hosting\" GitHub Action as an\n open-source project.\n [View the source code.](//github.com/marketplace/actions/deploy-to-firebase-hosting)\n\n- The \"Deploy to Firebase Hosting\" GitHub Action allows for further\n configuration, like customizing the expiry date for a preview channel or\n setting a non-live channel to deploy to when a PR is merged.\n [Learn about the available configuration options.](//github.com/marketplace/actions/deploy-to-firebase-hosting#options)\n\n- Learn more about\n [GitHub Actions](//docs.github.com/en/free-pro-team@latest/actions),\n in general."]]
