通过 GitHub 拉取请求在实际和预览渠道中实施部署

您可以通过 GitHub 操作将部署集成到 Firebase Hosting。以下是此 GitHub 操作可以完成的任务:

  • 为 GitHub 代码库中的每个拉取请求 (PR) 创建一个新的预览渠道(及其关联的预览网址)。

  • 向 PR 添加注释并附上预览网址,这样您和每位审核者都可以在应用的“预览”版本中查看和测试 PR 的更改。

    附有预览网址的 GitHub 操作 PR 注释的图片

  • 自动在关联的预览渠道中实施部署,以便每次提交时使用所做更改来更新预览网址。该网址不会随着每次提交新内容而发生变化。

  • (可选)在合并 PR 时,将 GitHub 代码库的当前状态部署到您的实际渠道。

提醒:使用预览网址时,您的应用会与 Firebase 项目的实际后端资源进行互动。

设置“在 Firebase Hosting 中实施部署”这项 GitHub 操作

  1. 创建 GitHub 代码库(公共或专用),或使用现有代码库。您必须拥有代码库的管理员权限。

  2. 在代码库的本地版本中,使用 firebase init 命令设置 Firebase Hosting。

    • 如果您尚未设置 Hosting,请从本地目录的根目录运行此版本的命令:

      firebase init hosting
    • 如果您已设置 Hosting,则需要设置 Hosting 的 GitHub 操作部分。从本地目录的根目录运行此版本的命令:

      firebase init hosting:github
  3. 按照 CLI 提示进行操作,该命令会自动完成 GitHub 操作的设置:

    • 在您的 Firebase 项目中创建有权在 Firebase Hosting 中实施部署的服务账号。

    • 加密该服务账号的 JSON 密钥,并将其作为 GitHub 密钥上传到指定的 GitHub 代码库。

    • 写入 GitHub 工作流 yaml 配置文件,这些文件引用的是新创建的密钥。这些文件用于配置可在 Firebase Hosting 中实施部署的 GitHub 操作。

  4. 在 GitHub 中,创建一个新分支并提交 CLI 创建的工作流 yaml 文件。

  5. 将该分支发布到 GitHub 代码库。

  6. 合并该分支。

大功告成!此 GitHub 代码库中的任何后续 PR 都将自动获得相应的“预览网址”!

详细了解 GitHub 操作

  • Firebase 将“在 Firebase Hosting 中实施部署”这项 GitHub 操作作为开源项目维护。查看源代码。

  • “在 Firebase Hosting 中实施部署”这项 GitHub 操作支持进一步配置,例如自定义预览渠道的失效日期,或设置在合并 PR 时要在其中实施部署的非实际渠道。了解可用的配置选项

  • 从总体上详细了解 GitHub 操作