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, App Hosting é compatível com 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 de lançamentos que 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 git é o snapshot do 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. Você pode acessar os registros Cloud Build clicando 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 uma implantação

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 nos seguintes casos:

  • Forçando a nova geraçã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 do back-end, selecione Criar lançamento.
  3. Selecione a ramificação a ser implantada.
  4. Selecione a confirmação a ser implantada: a mais recente ou uma anterior especificada pelo código do commit.
  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, é possível iniciar um lançamento para o commit 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.