Vous pouvez installer (et gérer) n'importe quelle extension Firebase officielle à 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é à la formule Blaze (avec paiement à l'usage). Bien que l'installation d'une extension soit sans frais, 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 encore fait, ajoutez Firebase à votre projet et passez à la formule Blaze (paiement à l'usage) pour votre projet Firebase.
Étape 1 : Afficher des informations détaillées sur une extension
Cette étape est facultative, mais vivement recommandée.
Avant d'installer un Firebase Extension, nous vous recommandons de consulter des informations détaillées sur l'extension, y compris :
- Fonctionnement de l'extension, tâches de pré-installation et détails sur l'extension
- Informations générales d'identification et description
- Indique 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 des informations détaillées sur une extension :
Parcourez les extensions Firebase officielles dans Extensions Hub.
Cliquez sur la fiche d'une extension pour :
Affichez les informations détaillées de l'extension.
Recherchez le lien vers le code source de l'extension dans le dépôt de code source Firebase Extensions.
Dans le répertoire des extensions de l'extension, vous pouvez afficher ces informations détaillées dans
README.
Étape 2 : Installez une extension
Lors de l'installation, vous serez invité à examiner les spécifications de base de l'extension (telles que les API activées, les ressources créées, les accès accordés, etc.). Vous serez informé de toute exigence de facturation et vous serez également invité à spécifier des valeurs pour les paramètres configurables de l'extension.
Parcourez les extensions Firebase officielles dans Extensions Hub.
Cliquez sur la fiche d'une extension, puis consultez les informations détaillées la concernant. Elles 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 : Terminer la configuration post-installation
Certaines extensions nécessitent des étapes obligatoires ou facultatives à suivre avant de pouvoir les utiliser. Vous trouverez ces instructions sur la page d'informations post-installation de votre extension dans le tableau de bord Extensions de la console Firebase (le lien spécifique vers le tableau de bord s'affiche dans le terminal après l'installation).
Vous trouverez également 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 (collections Cloud Firestore, chemins Realtime Database, buckets Cloud Storage) 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 pour l'extension Run Payments with Stripe.
Ensuite, consultez 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 chaque instance installée et y faites référence à 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 console Firebase.
Surveillez l'activité de votre extension installée, y compris son état, son utilisation et ses journaux.
À 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, et la mettre à jour vers la dernière version.
Nous vous recommandons de configurer des alertes budgétaires pour votre projet et de surveiller le tableau de bord Utilisation et facturation dans la console Firebase.