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 instance d'extension installée

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

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

Surveiller une instance d'extension installée

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

Définir des alertes de budget

Il est généralement recommandé de définir des alertes budgétaires, mais elles peuvent être particulièrement importantes lorsque vous faites confiance au code d'un tiers pour l'exécuter dans votre projet.

Assurez-vous de configurer des alertes de budget pour votre projet Firebase.

Afficher les fonctions créées par les extensions

  1. Accédez au tableau de bord des fonctions dans la console Firebase.

  2. Dans l'onglet Dashboard (Panneau de contrôle), vous pouvez afficher les fonctions de Firebase Extensions (ainsi que toutes les autres fonctions que vous avez déployées pour votre projet).

    Les fonctions créées par les extensions ont un nom au format suivant : ext-extension-instance-id-functionName

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

Afficher Cloud Scheduler jobs créés par les extensions

  1. Ouvrir la page Cloud Scheduler de votre projet dans la console Google Cloud.

  2. Dans la liste des jobs, vous pouvez afficher les jobs Cloud Scheduler depuis Firebase Extensions (en plus des autres offres d'emploi que vous avez créées pour votre projet).

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

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

Afficher et gérer les tâches Cloud mises en file d'attente par les extensions

Certaines extensions utilisent Cloud Tasks pour exécuter des tâches plus longues: le plus souvent, traiter des tâches qui s'exécutent à différents dans le cycle de vie d'une extension : installation, reconfiguration après les mises à niveau.

Normalement, ces tâches s'exécutent et se terminent automatiquement, sans que vous ayez à intervenir. Toutefois, si jamais vous devez gérer manuellement la file d'attente d'une extension tâches. Par exemple, pour suspendre la file d'attente ou supprimer de la file d'attente une tâche qui n'a pas encore commencé. Suivez ces étapes:

  1. Dans la section Extensions de la console Firebase ouvrez la page d'informations de l'instance de l'extension.

  2. Sur la page d'informations, ouvrez la section API et ressources. Si l'extension utilise Cloud Tasks, une section Files d'attente Cloud Tasks s'affiche avec une ou plusieurs entrées.

  3. Cliquez sur Afficher la file d'attente pour la file d'attente que vous souhaitez gérer. Cela ouvrira Page "Détails de la file d'attente" de la console Google Cloud, à partir de laquelle vous pouvez afficher des tâches en file d'attente, suspendre la file d'attente, supprimer des tâches de la file d'attente, etc. Voir Gérer les files d'attente et les tâches dans la documentation Cloud Tasks.

Afficher les secrets Cloud Secret Manager créés par les extensions

  1. Ouvrez la page Secret Manager de votre projet. dans la console Google Cloud.

  2. Dans la liste "Secrets", vous pouvez afficher les secrets créés pour Firebase Extensions (ainsi que tous les autres secrets que vous avez créés pour votre projet).

    Les noms des secrets créés par des extensions sont au format suivant: ext-extension-instance-id-paramnName

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

    Les secrets sont libellés avec la clé firebase-extensions-managed. Ne pas supprimer ce libellé, sauf si vous souhaitez empêcher Firebase de gérer le secret.

Vérifier si une extension installée est opérationnelle

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

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

  2. Pour afficher des informations sur une extension spécifique, utilisez le filtre situé en haut de la page pour sélectionner une fonction spécifique.

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

  1. Dans l'onglet Tableau de bord du tableau de bord des fonctions : localiser la fonction spécifique pour le Firebase Extension qui à vérifier.

  2. Cliquez sur le menu à développer situé à droite de l'entrée, puis sélectionnez Données d'utilisation détaillées.

  3. Dans la console Google Cloud qui s'affiche, vous pouvez afficher le détail de différents éléments. des appels 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 d'envoyer un rapport de bug à Firebase, utile pour afficher les journaux des fonctions en cours d'exécution dans votre projet.

Dans l'onglet Journaux de votre tableau de bord des fonctions, utilisez le filtre situé au niveau en haut de la page pour sélectionner les fonctions créées par votre extension.

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

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

Lorsque vous mettez à jour une instance, toutes les ressources et ressources spécifiques à l'extension de l'instance est écrasée pour utiliser le code source et les fichiers de la nouvelle version. La l'ID d'instance et le compte de service de l'extension restent inchangés.

Pendant la mise à jour, vous serez informé de toute modification et vous pourrez spécifier des valeurs pour les nouveaux paramètres.

  1. Accédez à votre tableau de bord Firebase Extensions, puis sur la la fiche de l'instance d'extension, cliquez sur Gérer.

  2. En haut à droite, cliquez sur Mettre à jour l'extension.

    Si aucune nouvelle version n'est disponible pour l'extension, la page d'informations 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 instance d'extension installée

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

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

  2. En haut à droite, cliquez sur Reconfigure extension (Reconfigurer l'extension).

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

  4. Cliquez sur Enregistrer.

Désinstaller une instance d'extension

Vous pouvez désinstaller une instance d'extension de votre projet Firebase. Cette action supprime la compte de service et toutes les ressources (comme un ensemble de fonctions) que Firebase a créé spécifiquement pour cette instance. de l'extension. Toutefois, 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 Cloud Storage bucket. 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.

Pour désinstaller une extension, procédez comme suit:

  1. Accédez à votre tableau de bord Firebase Extensions, puis à 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.