Gerenciar lançamentos e versões

Se você tiver os lançamentos automáticos ativados, sempre que enviar uma nova confirmação para o branch ativo no repositório do GitHub, o App Hosting vai lançar automaticamente uma nova versão do app. É possível verificar o status do lançamento no console Firebase ou na verificação App Hosting do GitHub.

Além disso, o App Hosting oferece suporte a lançamentos acionados manualmente para integração de CI/CD ou qualquer outro caso em que você queira forçar um lançamento.

Conferir lançamentos

O console Firebase oferece acesso a informações detalhadas sobre todos os lançamentos do app. Na guia App Hosting, selecione Ver painel para o back-end cujos lançamentos você quer conferir. O painel mostra informações sobre o lançamento atual, além de uma tabela com o histórico de todos os lançamentos para esse back-end.

Captura de tela da visualização de lançamentos do console

Cada lançamento contém uma confirmação do Git, um job Cloud Build e uma revisão Cloud Run.

  • O commit do Git é o snapshot do seu repositório no momento em que o lançamento é criado.
  • O job Cloud Build é o ambiente de build em que o App Hosting executa o comando de build do app. Para acessar os registros do Cloud Build, clique no ID do build no console do Firebase.
  • A revisão Cloud Run é o ambiente de execução do seu app da Web. Para saber mais sobre a configuração de execução de um lançamento (como limites de CPU e memória e variáveis de ambiente), clique no menu de três pontos e selecione Ver revisão Cloud Run.

Acionar manualmente um lançamento

Se você quiser acionar manualmente um lançamento da sua origem do GitHub sem enviar um novo commit, crie um lançamento no console Firebase ou na CLI Firebase. Isso é útil para casos como:

  • Forçar a regeneração de conteúdo estático.
  • Permitir que um sistema de CI/CD acione os lançamentos.
  • Limitar os lançamentos de produção a datas ou horários específicos.

Para acionar um lançamento no console do Firebase:

  1. Na guia App Hosting, selecione Visualizar painel para o back-end em que você quer criar um lançamento.
  2. No painel de back-end, selecione Criar lançamento.
  3. Selecione a ramificação a ser implantada.
  4. Selecione a confirmação a ser implantada, seja a mais recente ou uma anterior especificada pelo ID da confirmação.
  5. Selecione Criar. O status e um número de build para o lançamento são exibidos na tabela de histórico de lançamento. Quando o processo de lançamento for concluído, ele será exibido como o lançamento atual.

Para acionar um lançamento na CLI Firebase, execute o comando a seguir e selecione a ramificação para o lançamento quando solicitado:

firebase apphosting:rollouts:create BACKEND_ID

Como alternativa, você pode iniciar um lançamento para a confirmação mais recente de uma ramificação específica usando a opção --git-branch:

firebase apphosting:rollouts:create BACKEND_ID
--git_branch BRANCH_NAME

Também é possível criar um lançamento com um commit específico usando a opção --git-commit:

firebase apphosting:rollouts:create BACKEND_ID
--git_commit COMMIT_ID

Mudar as configurações de lançamento

É possível mudar a ramificação ativa para lançamentos e desativar ou ativar lançamentos automáticos usando controles na visualização Configurações > Implantação no painel de um back-end.

  1. Na guia App Hosting, selecione Visualizar painel para o back-end em que você quer atualizar as configurações de lançamento.
  2. No painel de back-end, selecione Configurações. A visualização padrão mostra informações sobre domínios e domínios personalizados.
  3. Selecione a visualização Deployment. Nessa visualização, é possível mudar a versão ativa para lançamentos e desativar ou ativar os lançamentos automáticos. Além disso, há opções para definir o diretório raiz do app e o ambiente para o back-end (consulte Implantar em vários ambientes).