Vous pouvez installer (et gérer) n'importe quelle extension officielle Firebase à l'aide de la console Firebase, de la Firebase CLI (interface de ligne de commande) ou d'un SDK généré automatiquement.
Veillez à consulter les différences entre les actions compatibles pour chaque méthode d'installation.
Pour installer ou gérer des extensions, vous devez disposer de l'un des rôles suivants : Propriétaire ou Éditeur ou Administrateur Firebase.
Pour installer une extension, votre projet doit être associé au forfait Blaze (paiement à l'utilisation). L'installation d'une extension n'entraîne aucun frais, mais vous pouvez être facturé pour votre utilisation des services Firebase ou des services Cloud tels que Cloud Secret Manager si votre utilisation dépasse le niveau sans frais des services.
Avant de commencer
Si ce n'est pas déjà fait, ajoutez Firebase à votre projet et passez votre projet Firebase au forfait Blaze (paiement à l'utilisation).
Étape 1 : Afficher des informations détaillées sur une extension
Cette étape est facultative, mais fortement recommandée.
Avant d'installer une Firebase Extension, nous vous recommandons de consulter des informations détaillées à son sujet, y compris les éléments suivants :
- Fonctionnement de l'extension, tâches de préinstallation et détails sur l'extension
- Informations d'identification générales et description
- Nécessité d'un compte de facturation pour les tâches de l'extension
- 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 des informations détaillées sur une extension :
Parcourez les extensions Firebase officielles dans le Extensions Hub.
Cliquez sur la fiche d'une extension pour :
Afficher les informations détaillées de l'extension.
Trouver le lien vers le code source de l'extension dans le Firebase Extensions dépôt source.
Dans le répertoire de l'extension, vous pouvez consulter ces informations détaillées dans le
README.
Étape 2 : Installer une extension
Lors du processus d'installation, vous serez invité à examiner les spécifications de base de l'extension (telles que les API activées, ressources créées, accès accordé, etc.). Vous serez informé des exigences de facturation et invité à spécifier des valeurs pour les paramètres configurables de l'extension.
Parcourez les extensions Firebase officielles dans le Extensions Hub.
Cliquez sur la fiche d'une extension, puis consultez les informations détaillées de l'extension, qui peuvent fournir des instructions d'utilisation spécifiques et des tâches de préinstallation.
Cliquez sur Installer, puis suivez les instructions à l'écran pour installer l'extension.
Étape 3 : Effectuer la configuration post-installation
Certaines extensions nécessitent des étapes obligatoires ou facultatives à suivre avant de les utiliser. Vous trouverez ces instructions sur la page de détails post-installation de votre extension dans le Extensions tableau de bord de la Firebase console (le lien spécifique vers le tableau de bord s'affiche 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.
Créer des ressources Firebase
Si vous avez configuré l'extension pour qu'elle utilise des ressources Firebase (Cloud Firestore collections, Realtime Database chemins, Cloud Storage buckets) qui n'existent pas encore, créez-les avant d'utiliser l'extension.
Créer des gestionnaires d'événements Eventarc
Certaines extensions publient des événements dans Eventarc lorsque des événements importants se produisent lors de l'exécution. Si une extension publie des événements et que vous les avez activés lors de l'installation, vous pouvez écrire des fonctions qui réagissent à ces événements avec votre propre logique personnalisée. Cela peut être utile, par exemple, pour avertir les utilisateurs lorsque des tâches de longue durée sont terminées ou pour post-traiter la sortie d'une fonction d'extension.
Consultez la documentation de l'extension pour obtenir la liste des événements (le cas échéant) qu'elle publie. Par exemple, consultez les types d'événements de l'extension Run Payments with Stripe.
Ensuite, consultez la section Déclencheurs d'événements personnalisés pour savoir comment écrire des gestionnaires d'événements Eventarc.
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 référencez chaque instance installée à l'aide de son ID d'instance, 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.
Étapes suivantes
Affichez les détails et la configuration de votre extension installée dans la Firebase console.
Surveillez l'activité de votre extension installée, y compris les vérifications de son état, de son utilisation et de ses journaux.
Gérez votre extension installée à l'aide de la Firebase console. Pour les extensions Firebase officielles, vous pouvez reconfigurer ou désinstaller votre extension, ainsi que la mettre à jour vers la dernière version.
Pour tous les projets, nous vous recommandons de configurer des alertes de budget pour votre projet et de surveiller votre tableau de bord Firebase dans la console.