将 monorepo 与 App Hosting 搭配使用

借助单体代码库，您可以在单个目录中组织和管理多个项目。本指南介绍了如何开始使用 App Hosting 部署基于 Nx 的应用。

使用 Firebase 控制台部署单体代码库

Firebase 控制台中的图形化后端设置流程内置了对 Monorepo 的支持。当系统在“部署设置”下提示您输入“根目录”时，请指定要部署的 monorepo 内应用的路径：

控制台后端创建视图的屏幕截图

使用 Firebase CLI 部署单体代码库

单代码库支持已内置到由 Firebase CLI 命令 apphosting:backends:create 调用的后端设置流程中。进入此流程并指定所选的 GitHub 代码库后，系统会提示您指定应用的根目录（相对于代码库）；在此提示中，传递要部署在 monorepo 中的应用的路径：

$ firebase apphosting:backends:create --project [project-name]
i  === Import a GitHub repository
✔  Connected with GitHub successfully

? Which GitHub repo do you want to deploy? gh-username/nx-monorepo
? Specify your app's root directory relative to your repository path/to/app

例如，假设 Nx 项目结构如下，并且您要构建和部署的应用为“target-app”，那么系统会部署以下资源：

.
    ├── lib
    ├── apps
    │   └── target-app
    │       ├── project.json
    │       └── src
    │           └── ...
    ├── nx.json
    ├── package-lock.json
    └── package.json

相对于代码库的应用根目录为 apps/target-app。

排查 monorepo 部署问题

  • 如果您未指定“根目录”字段，则 build 将失败，并显示一条消息，指出 App Hosting 无法在 Nx monorepo 中找到要定位的项目。
  • 对于 Nx + Angular 应用，您必须使用 Angular 应用构建器来构建应用。Angular 应用构建器在 project.json 中指定