管理已安装的 Firebase 扩展程序

若要安装或管理扩展程序，您必须拥有以下某个角色：Owner 或 Editor或 Firebase Admin。

Firebase 控制台 Firebase CLI

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

您可以列出已安装的扩展程序的每个实例。

运行 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

查看扩展程序创建的 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 信息中心的“运行状况”标签页中，您可以简要了解项目中所有函数的错误和性能信息。

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 文件），请输入配置值以自定义项目的扩展程序。

   注意：所有提示默认采用已安装扩展程序的当前值，而不是在初始安装过程中提供的默认值（extension.yaml 文件中列出的默认值）。

注意：系统可能需要 3-5 分钟才能保存对扩展程序所做的更改。

卸载扩展程序实例

您可以从 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