Installer une extension Firebase

Vous pouvez installer (et gérer ) l' une des extensions Firebase officielles en utilisant soit la console Firebase ou la CLI Firebase (interface de ligne de commande).

Assurez - vous d'examiner les différences dans les actions prises en charge pour la console CLI Firebase et Firebase.


Pour installer ou gérer les extensions, vous devez recevoir une de ces rôles: Propriétaire ou de l' éditeur ou Firebase administrateur .

En outre, pour installer une extension, votre projet doit être sur le Blaze (pay as you go) plan. Vous devrez payer une petite quantité ( généralement autour de 0,01 $ / mois ) pour les ressources nécessaires Firebase par cette extension (même si elle n'est pas utilisé), en plus des frais associés à son utilisation.

Avant que tu commences

  1. Si vous avez pas déjà, ajoutez Firebase à votre projet .

  2. Si vous n'avez pas déjà, mettre à jour votre projet au Blaze (pay as you go) plan.

  3. Installez ou mettez à jour vers la dernière version de la CLI Firebase.

  4. Prenez note de votre ID de projet Firebase ou de l'alias de projet précédemment configuré.

    • ID projet - Exécuter firebase projects:list de partout sur votre ordinateur.
    • Alias projet - Exécuter firebase use à partir de votre répertoire d'applications local.

Étape 1: Informations détaillées sur une extension

Cette étape est facultative, mais fortement recommandée.

Avant d'installer une extension Firebase, nous vous recommandons de consulter les informations détaillées sur l'extension, notamment :

  • Fonctionnement de l'extension, tâches de pré-installation et détails sur l'extension
  • Informations générales d'identification et description
  • Si les tâches de l'extension nécessitent un compte de facturation
  • Services Google (API) et des rôles d'accès requis pour le fonctionnement
  • Ressources créées pour l'extension (comme des fonctions)
  • Descriptions des paramètres configurables par l'utilisateur

Pour afficher les informations détaillées d'une extension :

  1. Assurez - vous que vous avez configuré votre environnement et sélectionnez une extension .

  2. Exécutez la commande extension-info depuis n'importe où sur votre ordinateur :

    firebase ext:info publisher-id/extension-id

    L' publisher-id et extension-id arguments sont nécessaires et se trouvent sur la page de détails préinstallation de l' extension .

Étape 2: Installer une extension

Au cours du processus d'installation, vous serez invité à examiner les spécifications de base pour l'extension (API activées, les ressources créées, l' accès accordé, etc.). Vous serez informé de toutes les exigences de facturation et vous serez également invité à spécifier des valeurs pour les paramètres configurables de l'extension.

  1. Assurez - vous que vous avez configuré votre environnement et sélectionnez une extension .

  2. Exécutez la commande extension-install. Si vous y êtes invité, entrez les valeurs des paramètres pour personnaliser l'instance d'extension.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    L' publisher-id et extension-id arguments sont nécessaires et se trouvent sur la page de détails préinstallation de l' extension .

  3. Une fois l'installation terminée, passez en revue les instructions d'utilisation de votre extension, qui peuvent inclure certaines tâches post-installation requises.

    • Trouvez ces instructions dans la page des détails de post-installation de votre extension dans le tableau de bord des extensions de la console Firebase (le lien spécifique vers le tableau de bord est affiché dans le terminal après l'installation).

      Vous pouvez également trouver ces instructions dans le POSTINSTALL.md fichier inclus dans le répertoire source de l' extension .

    • Le cas échéant, ces instructions vous diront comment tester votre extension (look pour une Voir dans la section d'action).

Installer plusieurs instances d'extension

Vous pouvez installer la même extension plusieurs fois dans le même projet. Chaque instance installée peut avoir sa propre configuration personnalisée et ses propres ressources d'extension. Vous identifiez et faites référence à chaque instance installée en utilisant son ID d'instance, ce qui est unique dans votre projet. Vous serez invité à confirmer ou à modifier l'ID d'instance de chaque instance supplémentaire de l'extension que vous installez.

Prochaines étapes

  • Voir les détails et la configuration de votre extension installée dans la console Firebase.

  • Surveiller l'activité de votre extension installée, y compris des contrôles sur sa santé, l' utilisation et les journaux.

  • Utilisation de la CLI Firebase, gérer votre extension installée. Vous pouvez reconfigurer ou désinstaller votre extension, ainsi que mettre à jour votre extension vers la dernière version.

  • Utilisation de la console Firebase, gérer votre extension installée. Pour les extensions Firebase officielles, vous pouvez reconfigurer ou désinstaller votre extension, ainsi que mettre à jour votre extension vers la dernière version.

  • En tant que meilleure pratique pour tous les projets, assurez - vous de mettre en place des alertes budgétaires pour votre projet et surveiller votre utilisation et tableau de bord de facturation dans la console Firebase.