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 partes principais desse fluxo de tarefas, fornecendo informações sobre pontos em que você pode personalizar o fluxo dependendo das necessidades do app.
Suporte ao framework
O App Hosting oferece suporte de build 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
O App Hosting identifica qual framework você está usando ao inspecionar 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 duas funções 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. - Eles executam o comando de build do app para gerar recursos estáticos e criar uma versão otimizada do app 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 de cada framework: next build para Next.js e
ng build para Angular. App Hosting vai tentar builds com comandos de build personalizados, mas não pode garantir o sucesso de forma confiável.
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 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 visualizar o status do lançamento no GitHub e depurar o processo de implantação em caso de erros.
Integração com o Firebase e outros serviços do Google
App Hosting configura os ambientes de build e de execução para que você possa inicializar o SDK Admin do Firebase com as Application Default Credentials do Google. Dessa forma, o back-end pode se comunicar com outros produtos do Firebase durante a criação e o deploy.
App Hosting locais
A implantação App Hosting cria os recursos de back-end em um local específico. Essa flexibilidade no 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 de App Hosting em uma região não afetaria apps da Web implantados em outras regiões.
É possível 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)europe-west4(Países Baixos)
A conta de serviço de back-end App Hosting
Durante a criação e no ambiente de execução, seu back-end App Hosting se autentica em outros serviços do Google com uma conta de serviço. Uma conta de serviço padrão para esses fins é criada na primeira vez que você ativa App Hosting em um projeto do Firebase:
firebase-app-hosting-compute@PROJECT ID.iam.gserviceaccount.com
Essa conta de serviço se aplica a todos os back-ends por padrão e tem um conjunto mínimo de permissões para permitir que você crie, execute e monitore seu app. Ela também tem permissão para autenticar o SDK Admin com as credenciais padrão do aplicativo para realizar operações como o carregamento de dados de Cloud Firestore. Consulte Papéis do App Hosting do Firebase.
Caso seu app precise interagir com outros serviços do Google no tempo de build
ou em um back-end em execução, personalize a conta de serviço padrão
adicionando papéis. Por exemplo, se o app exigir permissões para a Vertex AI, talvez
seja necessário adicionar
roles/aiplatform.user
ou algum papel relacionado.
Principais termos e definições
- Back-end: a coleção de recursos gerenciados que o App Hosting cria para desenvolver e executar seu app da Web.
- Implementação: uma versão específica do app em produção, vinculada a um commit do Git.
- Ramificação ativa: a ramificação do repositório do GitHub que é implantada no URL ativo. Geralmente, é a ramificação em que as ramificações de recursos ou de desenvolvimento são mescladas.
Limitações e problemas conhecidos
A visualização de App Hosting tem algumas limitações conhecidas:
- Em alguns casos, um back-end App Hosting pode retornar
mensagens
Intermittent connection errorno URL do app. Uma correção vai estar disponível em uma versão futura. - Os cabeçalhos Cache-Control são modificados para limitar os caches do CDN a 60 segundos. No futuro, quando o App Hosting puder limpar rapidamente o cache na implantação, esse limite será removido.
- A otimização de imagens é feita em Cloud Run por padrão, e as imagens otimizadas não são mantidas. Recomendamos desativar a otimização de imagens ou especificar manualmente um carregador até que uma solução melhor esteja disponível.
- Os arquivos estáticos sem cache são exibidos fora de Cloud Run. Em uma versão posterior, eles serão armazenados e exibidos da origem App Hosting para melhor desempenho.
- Os SKUs do App Hosting podem não aparecer na página de uso do back-end no console Firebase. Eles vão estar disponíveis em uma versão futura.
- O console Firebase pode mostrar intermitentemente um erro "build não encontrado e inválido" na criação do back-end.
- Atualmente, todos os back-ends no mesmo projeto compartilham uma organização/conta do GitHub. Eles podem ser conectados a diferentes repositórios nessa organização/conta. Para criar back-ends conectados a diferentes contas do GitHub, coloque-os em projetos separados.
- Os middlewares, as reescritas e os redirecionamentos do Next.js são executados em Cloud Run, atrás do CDN. Como elas não protegem as respostas em cache, defina diretivas de controle adequadas para o conteúdo que você está renderizando.