Gérer les chaînes, versions et versions d'aperçu en direct pour votre site

Firebase Hosting fournit des outils via la console Firebase et la CLI Firebase pour gérer les canaux, les versions et les versions de votre site Hosting.

Présentation de l'infrastructure Hosting

Comprendre l'infrastructure Hosting vous aide à comprendre décrites sur cette page.

Chaque projet Firebase dispose d'un Hosting site par défaut avec accès à tous les éléments les ressources du projet (bases de données, authentification, fonctions, etc.). Un site contient un ou plusieurs canaux, chaque canal étant associé à une URL qui diffuse du contenu spécifique et à une configuration Hosting.

Hiérarchie Firebase Hosting" />

Chaque site Hosting a une section "En ligne" d'une chaîne qui diffuse du contenu Hosting au niveau des (1) sous-domaines du site provisionnés par Firebase (SITE_ID.web.app et SITE_ID.firebaseapp.com) et (2) toute autre connexion domaines personnalisés. Vous pouvez également créer des chaînes de prévisualisation qui diffusent leur propre contenu et leur propre configuration sur des "URL de prévisualisation" temporaires et partageables (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app).

Le contenu et la configuration diffusés par chaque canal sont regroupés dans un version disposant d'un identifiant unique. Lorsque vous déployez votre application sur votre site, Firebase crée un objet version qui pointe vers une version spécifique. A contient des métadonnées sur le déploiement, telles que l'identité de l'utilisateur et la date déployés.

À partir de l'API Tableau de bord Hosting, vous pouvez consulter l'historique complet des sorties de votre chaîne en direct dans un Tableau Historique des versions. Si vous avez plusieurs sites Hosting, cliquez sur Afficher pour pour accéder à l'historique des mises à jour. Si vous disposez de chaînes d'aperçu, elles s'affichent également dans le tableau de bord Hosting.

Gérer les paramètres d'une chaîne

Vous pouvez contrôler les paramètres de chaque version de votre site. Certains paramètres, tels que d'expiration du canal de distribution, ne s'appliquent qu'aux versions preview.

Limiter le nombre de versions à conserver

Chaque fois que vous déployez une version (et que vous créez une version), Hosting conserve associée à la version précédente dans le Hosting de votre projet stockage. Vous pouvez définir le nombre de versions à conserver pour chaque canal de votre du projet, à la fois en direct et en preview.

• Pourquoi Hosting conserve-t-il les versions précédentes ?
  Pour votre chaîne en direct, vous pouvez : Effectuez un rollback vers une version précédente de votre site, si nécessaire. Pour le rollback n'est pas encore disponible.

• Pourquoi limiter le nombre de versions à conserver ?
  Cette fonctionnalité peut vous aider à contrôler le niveau d'utilisation l'espace de stockage Hosting du projet, le contenu des versions précédentes est conservé dans cet espace de stockage. Vous pouvez surveiller Hosting d'espace de stockage à partir du Onglet Stockage dans la console.

• Que se passe-t-il lorsque vous limitez les versions à conserver ?
  Lorsque vous définissez une limite de publication à conserver, le contenu de toutes les versions dépassant la suppression de la limite définie est planifiée, en commençant par les versions les plus anciennes.

Pour définir la limite de stockage des versions d'une version:

1. Dans Console Firebase, Accédez à la boîte de dialogue des paramètres de stockage des versions:

   • Pour votre chaîne en direct
     Dans le tableau Historique des versions de votre site, cliquez sur more_vert, puis sélectionnez Paramètres de stockage des versions

   • Pour toute version preview
     Sur la ligne du canal d'aperçu, cliquez sur more_vert, puis sélectionnez Paramètres de la chaîne :

2. Saisissez le nombre de versions que vous souhaitez conserver, puis cliquez sur Enregistrer.

Définir la date d'expiration d'un canal de prévisualisation

Par défaut, un critère de prévisualisation expire sept jours après sa date de création, mais votre la chaîne en direct du site n'expirera jamais.

Lorsqu'un canal de prévisualisation expire, la chaîne, ses sorties et associées, sont supprimées dans un délai de 24 heures. La l'URL d'aperçu associée est également désactivée. Il existe une exception à cette règle. La suppression de versions a lieu si une version est associée à une autre version se produit, par exemple, si vous clonez une version d'un canal à un autre sur un même site).

Hosting propose deux méthodes différentes pour contrôler l'expiration d'une chaîne:

• Console Firebase
  Sur la ligne du canal de prévisualisation, cliquez sur more_vert, puis sélectionnez Paramètres de la chaîne. Saisissez la date et l'heure d'expiration.

• CLI Firebase
  Lorsque vous effectuez un déploiement dans votre version preview, transmettez la --expires DURATION, par exemple:

  firebase hosting:channel:deploy new-awesome-feature --expires 7d

  Le délai d'expiration peut atteindre 30 jours à compter de la date de déploiement. Utiliser h pour heures, d pour les jours et w pour les semaines (par exemple, 12h, 7d, 2w, respectivement).

Cloner une version d'une chaîne à une autre

Vous pouvez cloner une version déployée d'un canal vers un autre. Vous pouvez cloner des chaînes en direct ou en avant-première, des sites Hosting ou même des projets Firebase.

La commande "clone" effectue également le déploiement sur la "cible" pour que l'instance clonée Le contenu et la configuration Hosting sont automatiquement diffusés au niveau de la "cible" l'URL associée à la chaîne.

Cette fonctionnalité est utile pour le suivi des versions ou si vous voulez être sûr que vous déployez le contenu exact que vous avez consulté et/ou testé sur une autre canal. Voici quelques exemples :

• Cloner à partir d'un canal d'aperçu "QA" vers le canal en direct de votre site (mise en ligne)

• Effectuer un clonage à partir de la version en ligne de votre site pour effectuer un "débogage" version preview (comme avant un rollback)

• Cloner à partir d'un canal de votre projet Firebase de préproduction vers un canal de prévisualisation de votre projet Firebase de production

Pour cloner une version, exécutez la commande suivante à partir de n'importe quel répertoire:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

Remplacez chaque espace réservé par le code suivant:

• SOURCE_SITE_ID et TARGET_SITE_ID: il s'agit des identifiants du Hosting sites contenant les critères.

  • Pour votre site Hosting par défaut, utilisez l'ID de votre projet Firebase.
  • Vous pouvez spécifier des sites Hosting qui se trouvent dans le même projet Firebase ou même dans différents projets Firebase.

• SOURCE_CHANNEL_ID et TARGET_CHANNEL_ID: il s'agit des les identifiants des canaux.

  • Pour une chaîne en direct, utilisez live comme ID de chaîne.
  • Si la valeur "target" n'existe pas encore, cette commande crée le canal avant de le déployer.

Restaurer une version précédente de votre site

Vous pouvez effectuer un rollback pour diffuser une version précédente de la version en direct de votre site. Ce est utile si votre version actuelle présente un problème et que vous souhaitez effectuer un rollback pour diffuser une version fonctionnelle connue de votre site. Ou peut-être que votre site contenu temporaire pour des jours fériés ou un événement spécial, mais que vous souhaitez maintenant pour servir vos objectifs "habituels" de votre contenu.

En effectuant un rollback, vous créez une version qui diffuse la même version de du contenu d'une sortie précédente. Dans le tableau Historique des versions, les deux versions indique le même identifiant de version.

Pour effectuer une réinitialisation :

1. Dans la console Firebase, dans le tableau Historique des versions de votre site, pointez sur l'entrée de version précédente à laquelle vous souhaitez revenir.

2. Cliquez sur more_vert, puis sélectionnez Effectuer un rollback

Supprimer manuellement une version

Vous devrez peut-être supprimer manuellement un titre sur votre chaîne en direct pour libérer de l'espace Hosting d'espace de stockage pour votre projet. Toi peut uniquement supprimer les versions précédentes, et non la version actuellement diffusée sur votre site en ligne.

Lorsque vous supprimez une version, vous supprimez en fait son contenu, ce qui dont la suppression est planifiée dans un délai de 24 heures. L'objet release lui-même est conservé de sorte que vous puissiez toujours consulter ses métadonnées (qui a déployé et quand celui-ci a été déployé).

Pour supprimer une version:

1. Dans Console Firebase, dans le tableau Historique des versions de votre site, pointez sur que vous souhaitez supprimer.

2. Cliquez sur more_vert, puis sélectionnez Supprimer.

Supprimer manuellement des fichiers

Dans Firebase Hosting, le principal moyen de supprimer les fichiers sélectionnés d'un site déployé consiste à supprimer les fichiers localement, puis à les redéployer.

Supprimer manuellement un canal de prévisualisation

Pour afficher un aperçu de vos chaînes, cliquez sur la chaîne de votre choix. Dans cette vue, vous pouvez voir, supprimer et annuler les déploiements les plus récents, liés à la chaîne en question. Vous pouvez supprimer un canal de prévisualisation, mais vous ne pouvez pas supprimer la chaîne en ligne de votre site.

Lorsque vous supprimez un canal de prévisualisation, celui-ci, ainsi que ses versions et associées, sont supprimées dans un délai de 24 heures. La l'URL d'aperçu associée est également désactivée. Il existe une exception à la règle La suppression de versions a lieu si une version est associée à une autre version se produit, par exemple, si vous clonez une version d'un canal à un autre sur un même site).

Hosting propose deux méthodes différentes pour supprimer un canal Preview :

• Console Firebase
  Sur la ligne du canal de prévisualisation, cliquez sur more_vert, puis sélectionnez Supprimer la chaîne. Confirmez la suppression.

• CLI Firebase
  Exécutez la commande suivante à partir de n'importe quel répertoire:

  firebase hosting:channel:delete CHANNEL_ID

Commandes CLI pour les canaux de prévisualisation et le clonage

Commandes pour les canaux d'aperçu

Toutes les commandes pour les canaux Preview sont compatibles avec les cibles de déploiement si vous disposez de plusieurs sites Hosting.

Commandes pour le clonage de version