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

Gérer les extensions Firebase installées

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

Afficher les détails et la configuration d'une extension installée

  1. Accédez à votre tableau de bord Firebase Extensions dans la console Firebase.

  2. Sur la carte de l'extension installée, cliquez sur Gérer .

Surveiller une extension installée

Dans la console Firebase, vous pouvez surveiller l'activité d'une extension installée, notamment en vérifiant son état, son utilisation et ses journaux.

Définir des alertes budgétaires

La définition d'alertes budgétaires est une bonne pratique en général, mais les alertes peuvent être particulièrement importantes lorsque vous faites confiance au code d'une autre partie pour s'exécuter dans votre projet.

Assurez-vous de configurer des alertes budgétaires pour votre projet Firebase.

Afficher les fonctions créées par les extensions

  1. Accédez à votre tableau de bord Fonctions de la console Firebase.

  2. Dans l'onglet Tableau de bord , vous pouvez afficher les fonctions des extensions Firebase (ainsi que toutes les autres fonctions que vous avez déployées pour votre projet).

    Les fonctions créées par les extensions ont des noms, au format : ext- extension-instance-id - functionName

    Par exemple : ext-awesome-task-simplifier-onUserCreate

Afficher les tâches Cloud Scheduler créées par les extensions

  1. Ouvrez la page Cloud Scheduler de votre projet dans Google Cloud Console.

  2. Dans la liste des tâches, vous pouvez afficher les tâches Cloud Scheduler à partir des extensions Firebase (ainsi que toutes les autres tâches que vous avez créées pour votre projet).

    Les tâches créées par les extensions ont des noms au format : firebase-ext- extension-instance-id - functionName

    Par exemple : firebase-ext-awesome-task-simplifier-doTask

Vérifier si une extension installée est saine

Vous pouvez consulter toutes les erreurs des fonctions (y compris celles créées par Firebase Extensions) dans la console.

  1. Dans l'onglet Santé de votre tableau de bord Fonctions , vous pouvez afficher un aperçu des erreurs et des informations sur les performances de toutes les fonctions de votre projet.

  2. Pour afficher les informations d'une extension spécifique, utilisez le filtre en haut de la page pour sélectionner une fonction spécifique.

Vérifiez la fréquence d'exécution d'une extension installée

  1. Dans l'onglet Tableau de bord de votre tableau de bord Fonctions , recherchez la fonction spécifique de l'extension Firebase que vous souhaitez vérifier.

  2. Cliquez sur (le menu de débordement) à l'extrême droite de l'entrée, puis sélectionnez Statistiques d'utilisation détaillées .

  3. Dans la Google Cloud Console affichée, vous pouvez explorer différentes invocations d'une fonction et même inspecter son code source.

Afficher les journaux d'une extension

Si vous essayez de déboguer votre projet ou de soumettre un rapport de bogue à Firebase, il est utile d'afficher les journaux des fonctions en cours d'exécution dans votre projet.

Dans l'onglet Logs de votre tableau de bord Fonctions , utilisez le filtre en haut de la page pour sélectionner les fonctions créées par votre extension.

Mettre à jour une extension installée vers la dernière version

Vous pouvez mettre à jour une instance installée d'une extension vers sa dernière version publiée. Vous souhaiterez peut-être mettre à jour une instance installée, car l'instance est déjà en cours d'exécution ou configurée activement dans votre workflow de test, de projet ou d'application.

Lorsque vous mettez à jour une instance, toutes les ressources et la logique spécifiques à l'extension de l'instance sont écrasées pour utiliser le code source et les fichiers de la nouvelle version. L'ID d'instance et le compte de service de l'extension ne changeront pas.

Au cours du processus de mise à jour, vous serez informé de tout changement apporté à la nouvelle version et vous pourrez spécifier des valeurs pour tout nouveau paramètre.

  1. Accédez à votre tableau de bord Firebase Extensions , puis sur la carte de l'extension installée, cliquez sur Gérer .

  2. Dans le coin supérieur droit, cliquez sur Mettre à jour l'extension .

    Si l'extension n'a pas de nouvelle version disponible, la page de détails n'aura pas de bouton de mise à jour.

  3. Passez en revue les nouveautés de la mise à jour et configurez l'extension (si nécessaire).

  4. Cliquez sur Mettre à jour l'extension .

Reconfigurer une extension installée

Vous pouvez modifier les valeurs des paramètres configurés par l'utilisateur pour une extension installée. Ces nouvelles valeurs seront utilisées dans tous les futurs déclencheurs de l'extension, mais tous les artefacts ou éléments structurels précédents créés par l'extension (comme les images stockées ou les compartiments de stockage existants) ne seront pas modifiés.

  1. Accédez à votre tableau de bord Firebase Extensions , puis sur la carte de l'extension installée, cliquez sur Gérer .

  2. Dans le coin supérieur droit, cliquez sur Reconfigurer l'extension .

  3. Suivez les instructions à l'écran pour reconfigurer les valeurs des paramètres de votre poste.

  4. Cliquez sur Enregistrer .

Désinstaller une extension

Vous pouvez désinstaller une extension de votre projet Firebase. Cette action supprime le compte de service et toutes les ressources (comme un ensemble de fonctions) que Firebase a créées spécifiquement pour cette instance de l'extension. Cependant, les éléments suivants ne sont pas supprimés :

  • Tous les artefacts créés par l'extension (comme les images stockées).

  • Toutes les autres ressources de votre projet, comme une instance de base de données ou un bucket Cloud Storage. Même si l'extension a interagi avec ces autres ressources, elles ne sont pas spécifiques à l'extension , elles ne sont donc pas supprimées si l'extension est désinstallée.

Voici comment désinstaller une extension :

  1. Accédez à votre tableau de bord Firebase Extensions , puis sur la carte de l'extension installée, cliquez sur Gérer .

  2. En bas de l'écran, cliquez sur Désinstaller l'extension .

  3. Vérifiez ce qui sera supprimé, puis cliquez sur Désinstaller l'extension pour confirmer la suppression.