获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

管理已安装的 Firebase 扩展程序

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

要安装或管理扩展程序,您必须被分配以下角色之一: Owner 或 EditorFirebase Admin

查看已安装扩展实例的详细信息和配置

  1. 转到 Firebase 控制台中的Firebase Extensions 仪表板

  2. 在已安装的扩展实例的卡片上,单击Manage

监控已安装的扩展实例

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

设置预算提醒

设置预算警报通常是一种很好的做法,但当您信任另一方的代码在您的项目中运行时,警报可能尤为重要。

确保为您的 Firebase 项目设置预算提醒

查看扩展创建的函数

  1. 转到 Firebase 控制台的Functions 仪表板

  2. Dashboard选项卡中,您可以查看来自 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

查看和管理按扩展排队的 Cloud Tasks

一些扩展使用Cloud Tasks来运行运行时间更长的任务:最常见的是,处理在扩展生命周期的不同时间点运行的任务——安装、重新配置和升级后。

通常,这些任务会自动运行并完成,无需您的干预。但是,如果您需要手动管理扩展程序的排队任务——例如,暂停队列或从队列中删除尚未开始的任务——请执行以下步骤:

  1. 在 Firebase 控制台扩展部分,打开扩展实例的详细信息页面。

  2. 在详细信息页面上,打开API 和资源部分。如果扩展使用 Cloud Tasks,则会有一个Cloud Task 队列部分,其中包含一个或多个条目。

  3. 针对您要管理的队列单击查看队列。这将打开 Google Cloud Console 中的“队列详细信息”页面,您可以从中查看排队的任务、暂停队列、从队列中删除任务等。请参阅 Cloud Tasks 文档中的管理队列和任务

查看由扩展程序创建的 Cloud Secret Manager 机密

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

  2. 在机密列表中,您可以查看为 Firebase Extensions 创建的机密(以及您为项目创建的任何其他机密)。

    扩展创建的秘密具有以下格式的名称: ext- extension-instance-id - paramnName

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

    密文标有密钥firebase-extensions-managed 。除非您想阻止 Firebase 管理机密,否则不要删除此标签。

检查已安装的扩展是否健康

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

  1. Functions 仪表板Health选项卡中,您可以查看项目中所有函数的错误概览和性能信息。

  2. 要查看特定扩展的信息,请使用页面顶部的过滤器来选择特定功能。

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

  1. Functions dashboardDashboard选项卡中,找到要检查的 Firebase Extension 的特定函数。

  2. 单击条目最右侧的 (溢出菜单),然后选择Detailed usage stats

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

查看扩展日志

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

Functions 仪表板Logs选项卡中,使用页面顶部的过滤器来选择您的扩展程序创建的函数。

将已安装的扩展实例更新到最新版本

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

当您更新实例时,所有实例的扩展特定资源和逻辑都会被覆盖以使用新版本的源代码和文件。扩展的实例 ID 和服务帐户不会更改。

在更新过程中,您将收到有关新版本的任何更改的通知,并且您将能够为任何新参数指定值。

  1. 转到您的Firebase Extensions dashboard ,然后在已安装的扩展实例的卡片上,单击Manage

  2. 在右上角,单击更新扩展程序

    如果扩展没有可用的新版本,详细信息页面将没有更新按钮。

  3. 查看更新中的新增功能并配置扩展(如果需要)。

  4. 单击更新扩展

重新配置已安装的扩展实例

您可以更改已安装扩展实例的用户配置参数值。这些新值将在实例的任何未来触发器中使用,但扩展创建的所有先前工件或结构元素(如存储的图像或现有存储桶)都不会更改。

  1. 转到您的Firebase Extensions dashboard ,然后在已安装的扩展实例的卡片上,单击Manage

  2. 在右上角,单击重新配置扩展

  3. 按照屏幕上的说明为您的分机重新配置参数值。

  4. 单击保存

卸载扩展实例

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

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

  • 您项目中的任何其他资源,例如数据库实例或 Cloud Storage 存储桶。即使扩展与这些其他资源交互,它们也不是特定于扩展的,因此如果卸载扩展,它们也不会被删除。

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

  1. 转到您的Firebase Extensions dashboard ,然后在已安装的扩展实例的卡片上,单击Manage

  2. 在屏幕底部,点击卸载扩展

  3. 查看将删除的内容,然后单击“卸载扩展”以确认删除。