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

管理已安装的 Firebase 扩展程序

要安装或管理扩展程序,您必须拥有以下某个角色:Owner 或 EditorFirebase Admin

列出项目的已安装扩展程序

您可以列出 Firebase 项目中安装的所有扩展程序,并查看每个扩展程序的实例 ID。

运行 extensions-list 命令:

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

监控已安装的扩展程序

在 Firebase 控制台中,您可以监控已安装扩展程序的活动,包括检查其运行状况、使用情况和日志。

设置预算提醒

通常情况下,设置预算提醒是一种不错的做法,而当您依赖另一方的代码在您的项目中运行时,提醒可能就尤为重要了。

请务必为您的 Firebase 项目设置结算提醒

查看扩展程序创建的函数

  1. 转到 Firebase 控制台的 Functions 信息中心

  2. 在“信息中心”标签页中,您可以查看 Firebase Extensions 中的函数(以及您为项目部署的任何其他函数)。

    扩展程序创建的函数名称采用以下格式:ext-extension-instance-id-functionName

    例如:ext-awesome-task-simplifier-onUserCreate

查看扩展程序创建的 Cloud Scheduler 作业

  1. 在 Google Cloud Console 中打开项目的 Cloud Scheduler 页面。

  2. 在“作业”列表中,您可以查看来自 Firebase Extensions 扩展程序的 Cloud Scheduler 作业(以及您为项目创建的任何其他作业)。

    扩展程序创建的作业名称采用以下格式:firebase-ext-extension-instance-id-functionName

    例如:firebase-ext-awesome-task-simplifier-doTask

检查已安装的扩展程序运行状况是否正常

您可以在控制台中查看函数(包括 Firebase Extensions 创建的函数)的所有错误。

  1. Functions 信息中心的“运行状况”标签页中,您可以简要了解项目中所有函数的错误和性能信息。

  2. 要查看特定扩展程序的信息,请使用页面顶部的过滤器选择特定函数。

查看已安装扩展程序的运行频率

  1. Functions 信息中心的“信息中心”标签页中,找到您要查看的 Firebase Extensions 扩展程序的特定函数。

  2. 点击条目最右侧的 (溢出菜单),然后选择详细用量统计信息

  3. 在显示的 Google Cloud Console 中,您可以深入了解对函数的各种调用,甚至检查其源代码。

查看扩展程序的日志

如果您要尝试调试项目或向 Firebase 提交错误报告,那么查看项目中运行的函数的日志会很有帮助。

Functions 信息中心的“日志”标签页中,使用页面顶部的过滤器选择您的扩展程序创建的函数。

将已安装的扩展程序更新到最新版本

您可以将已安装的扩展程序实例更新到其最新发布的版本。您可能需要更新已安装的实例,因为实例已在测试、项目或应用工作流中设置或正在运行。

更新实例时,实例的所有扩展程序专用资源和逻辑都将被覆盖,以使用新版源代码和文件。扩展程序的实例 ID 和服务帐号不会更改。

在更新过程中,您会收到新版本的所有更改通知,并且您可以为任何新参数指定值。

  1. 运行 extensions-list 命令以获取扩展程序的实例 ID:

    firebase ext:list --project=projectId-or-alias
  2. 运行 extension-update 命令:

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

重新配置已安装的扩展程序

您可以为已安装的扩展程序更改用户配置的参数值。将来触发此扩展程序时,系统会使用这些新值,但扩展程序之前创建的所有工件或结构元素(如存储的图片或现有存储分区)均不会更改。

  1. 运行 extensions-list 命令以获取扩展程序的实例 ID:

    firebase ext:list --project=projectId-or-alias
  2. 运行 extension-configure 命令:

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

    其中,--params 是可选标志,用于提供一个文件,该文件定义了用户可配置参数的值,并允许您忽略交互式终端发出的输入这些值的提示。在遵循 dotenv 语法的 .env 文件中定义各值。

  3. 如果出现提示(或您未提供 .env 文件),请输入配置值以自定义项目的扩展程序。

卸载扩展程序

您可以从 Firebase 项目中卸载扩展程序。此操作会删除 Firebase 为该扩展程序实例专门创建的服务帐号和所有资源(如一组函数)。但以下各项不会被删除:

  • 扩展程序创建的任何工件(如存储的图片)。

  • 项目中的任何其他资源,例如数据库实例或 Cloud Storage 存储分区。即使扩展程序与这些其他资源进行了交互,这些资源也并非特定于扩展程序,因此在扩展程序卸载后不会被删除。

扩展程序的卸载方法如下:

  1. 运行 extensions-list 命令以获取扩展程序的实例 ID:

    firebase ext:list --project=projectId-or-alias
  2. 运行 extension-uninstall 命令:

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