O Firebase App Hosting usa o Cloud Build para transformar o código-fonte do aplicativo em um formato em contêineres adequado para implantação no Cloud Run.
O processo de build opera nas seguintes etapas principais:
Ingestão: coleta o código-fonte e a configuração do aplicativo.
Build: instala dependências e cria o aplicativo.
Transferência: finaliza o contêiner Cloud Run de produção.
Essas três etapas correspondem diretamente às etapas de build 1, 2 e 3, conforme exibido em Cloud Build no console do Google Cloud:
Fase de ingestão
Essa etapa é responsável por processar a lógica de pré-build. Ele lê, higieniza e
grava variáveis de ambiente definidas pelo usuário. Ele também desreferencia e fixa todos os
secrets especificados no arquivo apphosting.yaml.
Etapa de build
Essa é a parte principal do processo de build, responsável por gerar uma imagem de contêiner executável e um arquivo bundle.yaml que define a configuração do build.
Ele usa Buildpacks nativos da nuvem
para empacotar o
aplicativo de maneira eficiente. Mais informações sobre o arquivo bundle.yaml podem ser encontradas no github.
Os buildpacks são responsáveis por transformar o código-fonte do aplicativo em imagens de contêiner prontas para produção. O Firebase App Hosting encadeia vários buildpacks para concluir o processo de build:
- Buildpack de ambiente de execução: garante que todos os componentes necessários para executar um aplicativo Node.js básico sejam incluídos e que as dependências sejam instaladas.
- Buildpack do monorepo: configura buildpacks subsequentes para processar diferentes cenários de monorepo.
Pacote de build do framework: instala o adaptador de framework correto (como Angular ou Next.js) e prepara os pacotes de build subsequentes.
Os adaptadores de framework são responsáveis por executar o comando de build de produção e mapear todos os valores de configuração relevantes específicos do framework para um formato padrão legível pelo App Hosting.
Buildpack do gerenciador de pacotes: executa a instalação de dependências e cria o app usando npm, yarn ou pnpm.
Buildpack do pacote de saída: define o comando de execução e prepara o pacote de saída para execução.
Etapa de transferência
Essa etapa final empacota todas as informações extraídas do código-fonte do aplicativo, além da imagem do contêiner de build, e as envia para o back-end App Hosting. O back-end App Hosting usa essas informações para configurar o Cloud Run com as configurações adequadas.
Saiba mais
Todo o processo de build do App Hosting é de código aberto.
- O código do buildpack está no repositório de buildpacks do Google Cloud.
- O código dos adaptadores de framework está no repositório firebase-framework-tools.
- Saiba mais sobre buildpacks nativos da nuvem e o Cloud Build.