Partager les ressources du projet sur plusieurs sites

Vous pouvez configurer un ou plusieurs sites d'hébergement Firebase dans un seul projet Firebase. Puisque les sites sont tous dans le même projet Firebase, tous les sites peuvent accéder aux autres ressources Firebase du projet.

• Chaque site possède sa propre configuration d'hébergement .
• Chaque site héberge sa propre collection de contenu.
• Chaque site peut avoir un ou plusieurs domaines associés .

En configurant plusieurs sites d'hébergement au sein du même projet Firebase, vous pouvez partager plus facilement les ressources Firebase entre des sites et des applications associés. Par exemple, si vous configurez votre blog, votre panneau d'administration et votre application publique en tant que sites individuels dans le même projet Firebase, ils peuvent tous partager la même base de données d'utilisateurs d'authentification Firebase, tout en ayant également leurs propres domaines ou contenus uniques.

Important : Pour mettre en miroir vos environnements de flux de travail (par exemple, Dev, Q1, Q2, Prod), nous vous recommandons de créer un projet Firebase distinct pour chaque environnement plutôt que de créer plusieurs sites dans un seul projet Firebase. En règle générale, vous ne souhaitez pas utiliser les ressources Firebase de l'environnement de production (comme les données client dans une base de données en temps réel) dans un environnement de développement. Envisagez d'utiliser la configuration automatique du SDK pour mettre en miroir plusieurs environnements à l'aide d'une seule base de code.

La fonctionnalité multisite prend en charge un maximum de 36 sites par projet Firebase.

Étape 1 : Mettez à jour votre version Firebase CLI

Accédez aux fonctionnalités d'hébergement Firebase les plus récentes en mettant à jour vers la dernière version de Firebase CLI .

Étape 2 : Ajouter des sites supplémentaires

Ajoutez des sites supplémentaires à un projet Firebase à l'aide de l'une des méthodes suivantes :

• Utilisez le workflow dans la page Hébergement de la console Firebase

• Utilisez la commande CLI Firebase : firebase hosting:sites:create SITE_ID

• Utilisez l'API REST d'hébergement : projects.sites.create

Pour chacune de ces méthodes, vous spécifierez un SITE_ID qui sera utilisé pour construire les sous-domaines par défaut fournis par Firebase pour le site :

• SITE_ID .web.app
• SITE_ID .firebaseapp.com

Étant donné que SITE_ID est utilisé pour ces URL, l'ID de site doit répondre aux exigences suivantes :

• Il doit s'agir d'une étiquette de nom d'hôte valide, ce qui signifie qu'elle ne peut pas contenir . , _ , etc.
• Doit contenir 30 caractères ou moins
• Doit être unique au monde dans Firebase

À chaque site, vous pouvez également éventuellement ajouter des domaines personnalisés pour diffuser le même contenu et la même configuration sur plusieurs URL.

Remarque : Si vous avez créé plusieurs instances de Firebase Realtime Database dans votre projet Firebase avant août 2018, Firebase a automatiquement provisionné un site correspondant pour chaque instance de base de données. Si vous n'avez pas besoin de ces sites supplémentaires, vous pouvez les supprimer sans affecter vos instances de base de données.

Supprimer un site secondaire

Supprimez les sites indésirables d'un projet Firebase à l'aide de l'une des méthodes suivantes :

• Utilisez le workflow dans la page Hébergement de la console Firebase

• Utilisez la commande CLI Firebase : firebase hosting:sites:delete SITE_ID

• Utilisez l'API REST d'hébergement : projects.sites.delete

Notez que vous ne pouvez pas supprimer le site par défaut, qui a le même SITE_ID que votre ID de projet Firebase.

Attention : La suppression d'un site est une action permanente. Si vous supprimez un site, Firebase ne conserve aucun enregistrement des fichiers déployés ni de l'historique de déploiement, et le SITE_ID ne peut pas être réactivé par vous ou par quelqu'un d'autre.

Étape 3 : Configurez les cibles de déploiement pour vos sites

Lorsque vous disposez de plusieurs sites et que vous exécutez des commandes de déploiement Firebase CLI, la CLI a besoin d'un moyen de communiquer quels paramètres doivent être déployés sur chaque site. Avec les cibles de déploiement, vous pouvez identifier de manière unique un site spécifique avec un TARGET_NAME dans votre fichier de configuration firebase.json et dans vos commandes Firebase CLI pour tester ou déployer sur vos sites.

Important : L'utilisation de cibles de déploiement est la méthode recommandée pour configurer les déploiements pour plusieurs sites d'hébergement.
Si vous avez déjà configuré votre fichier firebase.json en faisant explicitement référence à votre SITE_ID , vous devez modifier votre configuration firebase.json et vos commandes CLI pour utiliser des cibles de déploiement à la place.

Pour créer une cible de déploiement et appliquer un TARGET_NAME à un site d'hébergement, exécutez la commande CLI suivante à partir de la racine du répertoire de votre projet :

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

Où sont les paramètres :

• TARGET_NAME — un nom unique (que vous avez défini vous-même) pour le site d'hébergement sur lequel vous déployez

• RESOURCE_IDENTIFIER - le SITE_ID du site d'hébergement tel que répertorié dans votre projet Firebase

Par exemple, si vous avez créé deux sites ( myapp-blog et myapp-app ) dans votre projet Firebase, vous pouvez appliquer un TARGET_NAME unique ( blog et app , respectivement) à chaque site en exécutant les commandes suivantes :

firebase target:apply hosting blog myapp-blog

firebase target:apply hosting app myapp-app

Les paramètres des cibles de déploiement sont stockés dans le fichier .firebaserc dans le répertoire de votre projet, vous n'avez donc besoin de configurer les cibles de déploiement qu'une seule fois par projet.

Étape 4 : Définir la configuration d'hébergement pour chaque site

Utilisez TARGET_NAME appliqué à un site lorsque vous définissez sa configuration d'hébergement dans votre fichier firebase.json .

• Si votre fichier firebase.json définit la configuration pour plusieurs sites, utilisez un format de tableau :

  {
    "hosting": [ {
        "target": "blog",  // "blog" is the applied TARGET_NAME for the Hosting site "myapp-blog"
        "public": "blog/dist",  // contents of this folder are deployed to the site "myapp-blog"
  
        // ...
      },
      {
        "target": "app",  // "app" is the applied TARGET_NAME for the Hosting site "myapp-app"
        "public": "app/dist",  // contents of this folder are deployed to the site "myapp-app"
  
        // ...
  
        "rewrites": [...]  // You can define specific Hosting configurations for each site
      }
    ]
  }
  

• Si votre fichier firebase.json définit la configuration pour un seul site, il n'est pas nécessaire d'utiliser un format tableau :

  {
    "hosting": {
        "target": "blog",
        "public": "dist",
  
        // ...
  
        "rewrites": [...]
    }
  }
  

Étape 5 : Testez localement, prévisualisez les modifications et déployez sur vos sites

Exécutez l’une des commandes suivantes à partir de la racine du répertoire de votre projet local.

Commande	Description
firebase emulators:start --only hosting	Émule le contenu d'hébergement et la configuration du site d'hébergement par défaut sur une URL hébergée localement
firebase emulators:start --only hosting: TARGET_NAME	Émule le contenu d'hébergement et la configuration du site d'hébergement spécifié sur une URL hébergée localement
firebase hosting:channel:deploy \ CHANNEL_ID	Déploie le contenu d'hébergement et la configuration du site d'hébergement par défaut sur une URL d'aperçu
firebase hosting:channel:deploy \ CHANNEL_ID --only TARGET_NAME	Déploie le contenu d'hébergement et la configuration du site d'hébergement spécifié sur une URL d'aperçu
firebase deploy --only hosting	Déploie le contenu et la configuration de l'hébergement sur le canal en direct de tous les sites d'hébergement configurés dans firebase.json
firebase deploy --only hosting: TARGET_NAME	Déploie le contenu et la configuration de l'hébergement sur le canal en direct du site d'hébergement spécifié

Commande	Description
(non recommandé ; utilisez plutôt emulators:start ) firebase serve --only hosting	Sert le contenu d'hébergement et la configuration du site d'hébergement par défaut sur une URL hébergée localement
(non recommandé ; utilisez plutôt emulators:start ) firebase serve --only hosting: TARGET_NAME	Sert le contenu d'hébergement et la configuration du site d'hébergement spécifié sur une URL hébergée localement

Remarque : En exécutant des commandes avec l'indicateur --only hosting , vous émulez ou déployez uniquement votre contenu et votre configuration d'hébergement. Si vous souhaitez également émuler ou déployer d'autres ressources ou configurations de projet (comme des fonctions ou des règles de base de données), exécutez des commandes avec une liste séparée par des virgules dans l'indicateur (par exemple, --only hosting,functions ).

Pour les déploiements sur les canaux de prévisualisation, vous ne spécifiez pas hosting dans l'indicateur --only car ces commandes ne peuvent déployer que votre contenu et votre configuration d'hébergement.