Usar monorepos com o App Hosting

Com os monorepos, é possível organizar e gerenciar vários projetos em um único diretório. Este guia descreve como começar a implantar apps baseados em Turborepo ou Nx com App Hosting.

Implantar monorepos com o console Firebase

O suporte a monorepos está integrado ao fluxo de configuração gráfica do back-end no Firebase console. Quando solicitado um "Diretório raiz" em "Configurações de implantação", especifique o caminho para o aplicativo que você quer implantar no monorepo:

Implantar monorepos com a CLI Firebase

O suporte a monorepos está integrado ao fluxo de configuração do back-end invocado pelo Firebase comando da CLI apphosting:backends:create. Depois de inserir esse fluxo e especificar o repositório do GitHub escolhido, você vai receber uma solicitação para especificar o diretório raiz do app em relação ao repositório. Nesse momento, transmita o caminho para o aplicativo que você quer implantar no 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

Por exemplo, estes são os recursos que seriam implantados considerando a seguinte estrutura de projeto e "target-app" como o aplicativo que você quer criar e implantar:

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

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

O diretório raiz do app em relação ao repositório é apps/target-app.

Solução de problemas de implantação de monorepo

• Se você não especificar o campo "diretório raiz" para o Nx, o build vai falhar e mostrar uma mensagem informando que App Hosting não consegue encontrar um projeto de destino no monorepo do Nx. Da mesma forma, os usuários do Turborepo precisam especificar um diretório de app de destino porque não há um conceito de projeto padrão no Turborepo.
• Para aplicativos Nx + Angular, use o criador de aplicativos Angular builder para criar o aplicativo. O criador de aplicativos Angular é especificado em project.json.