O App Hosting processa uma série complexa de tarefas em segundo plano para simplificar a implantação do app. Esta página descreve as principais partes desse fluxo de tarefas, fornecendo informações sobre os pontos em que você pode querer personalizar o fluxo de acordo com as necessidades do app.
Suporte do framework
App Hosting fornece suporte de criação e implantação sem necessidade de configuração para apps da Web desenvolvidos nestes frameworks:
- Next.js 13 ou mais recente
- Angular 17.2 ou mais recente
App Hosting identifica qual framework você está usando inspecionando o
arquivo package-lock.json ou outro arquivo de bloqueio no repositório. Se você tentar
implantar um app Node.js que não tem um arquivo de bloqueio, o App Hosting não vai conseguir
criar e executar o app. É possível criar package-lock.json executando npm
install no diretório raiz.
Os adaptadores de framework App Hosting têm dois papéis principais:
- Eles analisam o código-fonte e todos os arquivos de configuração específicos do framework (como
next.config.js) para entender o comportamento configurado do app. - Elas executam o comando de build do app para gerar recursos estáticos e criar uma versão otimizada para produção.
Os adaptadores de framework criam seu app Node.js com npm run build, funcionando melhor com os scripts de build padrão para cada framework: next build para Next.js e ng build para Angular. O App Hosting vai tentar criar builds com comandos de build
personalizados, mas não pode garantir o sucesso.
Como funciona a integração do repositório App Hosting
A conexão importante entre o repositório do GitHub e o back-end App Hosting é processada pelo Developer Connect, a plataforma de conectividade do Google Cloud para ferramentas externas de DevOps. Durante a criação de um back-end App Hosting, o fluxo de trabalho da interface do Developer Connect orienta você na instalação do app GitHub do Firebase. As principais etapas desse processo são:
- Você concede ao Developer Connect o papel de Administrador do Secret Manager. Isso permite que o sistema armazene credenciais com segurança como "secrets" no Cloud Secret Manager.
- Você autoriza o app GitHub do Firebase a acessar seu repositório do GitHub.
- O Developer Connect armazena um token de autorização dedicado do GitHub no repositório do Secret Manager do projeto. Não modifique nem exclua esse token.
Além disso, o App Hosting se integra à API de verificações do GitHub para oferecer uma verificação de lançamentos. Essa verificação permite que você confira o status do seu lançamento no GitHub e depure o processo de implantação em caso de erros.
Integração com o Firebase e outros serviços do Google
App Hosting configura seus ambientes de criação e ambiente de execução para que você possa inicializar o SDK Admin do Firebase com o Google Application Default Credentials. Dessa forma, seu back-end poderá se comunicar com outros produtos do Firebase durante a criação e a implantação.
App Hosting locais
A implantação App Hosting cria os recursos de back-end em um local específico. Essa flexibilidade de local do app da Web tem vantagens importantes:
- Melhor desempenho e latência reduzida, trazendo os dados geograficamente mais próximos dos usuários.
- Uma falha catastrófica para App Hosting em uma região não afeta os apps da Web implantados em outras regiões.
Você pode escolher qualquer uma dessas regiões ao criar um back-end App Hosting no console ou na CLI Firebase:
us-central1(Iowa)asia-east1(Taiwan)