若要安装或管理扩展程序,您必须拥有以下某个角色:Owner 或 Editor或 Firebase Admin。
列出项目的已安装扩展程序实例
您可以列出已安装的扩展程序的每个实例。
运行 extensions-list 命令:
firebase ext:list --project=projectId-or-alias
监控已安装的扩展程序实例
在 Firebase 控制台中,您可以监控已安装扩展程序的活动,包括检查其运行状况、使用情况和日志。
设置预算提醒
通常情况下,设置预算提醒是一种不错的做法,而当您依赖另一方的代码在您的项目中运行时,提醒可能就尤为重要了。
请务必为您的 Firebase 项目设置预算提醒。
查看扩展程序创建的函数
转到 Firebase 控制台的 Functions 信息中心。
在“信息中心”标签页中,您可以查看 Firebase Extensions 中的函数(以及您为项目部署的任何其他函数)。
扩展程序创建的函数名称采用以下格式:
ext-extension-instance-id-functionName
例如:
ext-awesome-task-simplifier-onUserCreate
查看扩展程序创建的 Cloud Scheduler 作业
在 Google Cloud Console 中打开项目的 Cloud Scheduler 页面。
在“作业”列表中,您可以查看来自 Firebase Extensions 扩展程序的 Cloud Scheduler 作业(以及您为项目创建的任何其他作业)。
扩展程序创建的作业名称采用以下格式:
firebase-ext-extension-instance-id-functionName
例如:
firebase-ext-awesome-task-simplifier-doTask
查看扩展程序创建的 Cloud Secret Manager 密文
在 Google Cloud Console 中打开项目的 Secret Manager 页面。
在“密文”列表中,您可以查看为 Firebase Extensions 创建的密文(以及您为项目创建的任何其他密文)。
扩展程序创建的密文名称采用以下格式:
ext-extension-instance-id-paramnName
例如:
ext-awesome-task-simplifier-API_KEY
密文使用密钥
firebase-extensions-managed
进行标记。除非您想阻止 Firebase 管理密文,否则请勿移除此标签。
检查已安装的扩展程序运行状况是否正常
您可以在控制台中查看函数(包括 Firebase Extensions 创建的函数)的所有错误。
在 Functions 信息中心的“运行状况”标签页中,您可以简要了解项目中所有函数的错误和性能信息。
要查看特定扩展程序的信息,请使用页面顶部的过滤器选择特定函数。
查看已安装扩展程序的运行频率
在 Functions 信息中心的“信息中心”标签页中,找到您要查看的 Firebase Extensions 扩展程序的特定函数。
点击条目最右侧的
(溢出菜单),然后选择详细用量统计信息。在显示的 Google Cloud Console 中,您可以深入了解对函数的各种调用,甚至检查其源代码。
查看扩展程序的日志
如果您要尝试调试项目或向 Firebase 提交错误报告,那么查看项目中运行的函数的日志会很有帮助。
在 Functions 信息中心的“日志”标签页中,使用页面顶部的过滤器选择您的扩展程序创建的函数。
将已安装的扩展程序实例更新到最新版本
您可以将已安装的扩展程序实例更新到其最新发布的版本。您可能需要更新已安装的实例,因为实例已在测试、项目或应用工作流中设置或正在运行。
更新实例时,实例的所有扩展程序专用资源和逻辑都将被覆盖,以使用新版源代码和文件。扩展程序的实例 ID 和服务帐号不会更改。
在更新过程中,您会收到新版本的所有更改通知,并且您可以为任何新参数指定值。
运行 extensions-list 命令以获取扩展程序的实例 ID:
firebase ext:list --project=projectId-or-alias
运行 extension-update 命令:
firebase ext:update extensionInstanceId --project=projectId-or-alias
重新配置已安装的扩展程序实例
您可以为已安装的扩展程序实例更改用户配置的参数值。将来触发此实例时,系统会使用这些新值,但扩展程序之前创建的所有工件或结构元素(如存储的图片或现有存储桶)均不会更改。
运行 extensions-list 命令以获取扩展程序的实例 ID:
firebase ext:list --project=projectId-or-alias
运行 extension-configure 命令:
firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile
其中,
--params
是可选标志,用于提供一个文件,该文件定义了用户可配置参数的值,并允许您忽略交互式终端发出的输入这些值的提示。在遵循 dotenv 语法的.env
文件中定义各值。如果出现提示(或您未提供
.env
文件),请输入配置值以自定义项目的扩展程序。
卸载扩展程序实例
您可以从 Firebase 项目中卸载扩展程序实例。此操作会删除 Firebase 为该扩展程序实例专门创建的服务帐号和所有资源(如一组函数)。但以下各项不会被删除:
扩展程序创建的任何工件(如存储的图片)。
项目中的任何其他资源,例如数据库实例或 Cloud Storage 存储分区。即使扩展程序与这些其他资源进行了交互,这些资源也并非特定于扩展程序,因此在扩展程序卸载后不会被删除。
扩展程序的卸载方法如下:
运行 extensions-list 命令以获取扩展程序的实例 ID:
firebase ext:list --project=projectId-or-alias
运行 extension-uninstall 命令:
firebase ext:uninstall extensionInstanceId --project=projectId-or-alias