Google 致力于为黑人社区推动种族平等。查看具体举措

Gérer les extensions Firebase installées

Pour installer ou gérer les extensions, vous devez recevoir une de ces rôles: Propriétaire ou de l' éditeur ou Firebase administrateur .

Répertorier les instances d'extension installées d'un projet

Vous pouvez répertorier chaque instance des extensions que vous avez installées.

Exécutez la commande extensions-list :

firebase ext:list --project=projectId-or-alias

Surveiller une instance d'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 qu'il s'exécute dans votre projet.

Assurez - vous que vous avez configuré des alertes budgétaires pour votre projet Firebase.

Afficher les fonctions créées par les extensions

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

  2. Dans l'onglet Tableau de bord, vous pouvez afficher les fonctions de Firebase extensions (aux côtés de toutes les autres fonctions que vous avez déployés pour votre projet).

    Les fonctions créées par des extensions ont des noms, dans le 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 votre projet Planificateur Nuage page dans le 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 emplois créés par des extensions ont des noms dans le 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 voir un aperçu des erreurs et des informations de performance pour 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 pour l'extension Firebase que vous voulez vérifier.

  2. Cliquez (le menu de trop - plein) à l'extrême droite du côté de l'entrée, puis sélectionnez les 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 Journaux de votre tableau de bord Fonctions , utilisez le filtre en haut de la page pour sélectionner les fonctions créées par votre poste.

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 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. Exécutez la commande extensions-list pour obtenir l'ID d'instance de l'extension :

    firebase ext:list --project=projectId-or-alias
  2. Exécutez la commande extension-update :

    firebase ext:update extensionInstanceId --project=projectId-or-alias

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 de l'instance, mais tous les artefacts précédents ou des éléments de structure créés par l'extension (comme des images stockées ou des seaux de stockage existants) ne seront pas modifiés.

  1. Exécutez la commande extensions-list pour obtenir l'ID d'instance de l'extension :

    firebase ext:list --project=projectId-or-alias
  2. Exécutez la commande extension-configure :

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    --params est un drapeau en option pour fournir un fichier qui définit les valeurs des paramètres configurables par l' utilisateur et vous permet de contourner les invites terminaux interactifs pour ces valeurs. Définissez vos valeurs dans un .env fichier qui suit la dotenv syntaxe.

  3. Si vous êtes invité (ou vous n'avez pas fourni un .env fichier), entrez les valeurs de configuration pour personnaliser l'extension pour votre projet.

Désinstaller une instance d'extension

Vous pouvez désinstaller une instance d'une extension de votre projet Firebase. Cette action supprime le compte de service et toutes les ressources (comme un ensemble de fonctions) qui Firebase créé 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 interagi avec ces ressources, ils ne sont pas l' extension spécifique, donc ils ne sont pas supprimés si l'extension est désinstallée.

Voici comment désinstaller une extension :

  1. Exécutez la commande extensions-list pour obtenir l'ID d'instance de l'extension :

    firebase ext:list --project=projectId-or-alias
  2. Exécutez la commande extension-uninstall :

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias