Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Installer une extension Firebase

Vous pouvez installer (et gérer ) n'importe laquelle des extensions Firebase officielles à l'aide de la console Firebase ou de la CLI Firebase (interface de ligne de commande).

Assurez-vous de revoir les différences entre les actions prises en charge pour la CLI Firebase et la console Firebase.


Pour installer ou gérer des extensions, vous devez disposer de l'un des rôles suivants : Propriétaire ou Éditeur ou Administrateur Firebase .

De plus, pour installer une extension, votre projet doit être sur le plan Blaze (pay as you go). Un petit montant ( généralement environ 0,01 $/mois ) vous sera facturé pour les ressources Firebase requises par cette extension (même si elle n'est pas utilisée), en plus des frais associés à son utilisation.

Avant que tu commences

  1. Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet .

  2. Si vous ne l'avez pas déjà fait, mettez votre projet à niveau vers le plan Blaze (pay as you go).

  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 du projet - Exécutez les firebase projects:list depuis n'importe où sur votre ordinateur.
    • Alias ​​du projet - Exécutez l' firebase use de firebase use partir de votre répertoire d'applications local.

Étape 1 : Afficher des 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 rôles d'accès requis pour le fonctionnement
  • Ressources créées pour l'extension (comme les fonctions)
  • Descriptions des paramètres configurables par l'utilisateur

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

  1. Assurez-vous d'avoir configuré votre environnement et sélectionné une extension .

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

    firebase ext:info publisher-id/extension-id

    Les arguments publisher-id et extension-id sont obligatoires et se trouvent sur la page des détails de préinstallation de l' extension .

Étape 2 : Installer une extension

Au cours du processus d'installation, vous serez invité à revoir les spécifications de base de l'extension (telles que les 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 d'avoir configuré votre environnement et sélectionné 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

    Les arguments publisher-id et extension-id sont obligatoires et se trouvent sur la page des détails de la 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 fichier POSTINSTALL.md inclus dans le répertoire source de l' extension .

    • Le cas échéant, ces instructions vous indiqueront comment tester votre extension (recherchez une section Voir en action ).

Prochaines étapes

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

  • Surveillez l'activité de votre extension installée, y compris les vérifications de sa santé, de son utilisation et des journaux.

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

  • À l'aide de la console Firebase, gérez 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 configurer des alertes budgétaires pour votre projet et de surveiller votre tableau de bord d' utilisation et de facturation dans la console Firebase.