Как использовать монорепозитории с App Hosting

Монорепозитории позволяют упорядочивать несколько проектов и управлять ими в одном каталоге. В этом руководстве рассказывается, как начать развертывание приложений на основе Turborepo или Nx с помощью App Hosting.

Как развертывать монорепозитории с помощью консоли Firebase

Поддержка монорепозиториев встроена в графический интерфейс настройки бэкенда в консоли Firebase. Когда в разделе Deployment settings (Настройки развертывания) появится запрос Root directory (Корневой каталог), укажите путь к приложению, которое вы хотите развернуть в монорепозитории:

Скриншот, на котором показано, как создать серверную часть в консоли

Как развертывать монорепозитории с помощью Firebase CLI

Поддержка монорепозитория встроена в процесс настройки серверной части, который вызывается командой CLI Firebaseapphosting:backends:create. После того как вы укажете репозиторий GitHub, вам будет предложено указать корневой каталог приложения относительно репозитория. Введите путь к приложению, которое вы хотите развернуть в монорепозитории:

$ 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

Например, вот объекты, которые будут развернуты при следующей структуре проекта и target-app в качестве приложения, которое вы хотите создать и развернуть:

Nx

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

Turborepo

.
    ├── packages
    ├── apps
    │   └── target-app
    │       ├── package.json
    │       └── src
    │           └── ...
    ├── turbo.json
    ├── package.json
    └── package-lock.json

Корневой каталог приложения относительно вашего хранилища – apps/target-app.

Устранение неполадок при развертывании монорепозитория

  • Если вы не укажете поле корневого каталога для Nx, сборка завершится ошибкой и появится сообщение о том, что App Hosting не может найти целевой проект в монорепозитории Nx. Пользователям Turborepo также необходимо указать целевой каталог приложения, поскольку в Turborepo нет концепции проекта по умолчанию.
  • Для приложений Nx + Angular необходимо использовать систему сборки приложений Angular. Конструктор приложений Angular указан в файле project.json.