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 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 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.
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:
- Na guia App Hosting, selecione Visualizar painel para o back-end em que você quer criar um lançamento.
- No painel de back-end, selecione Criar lançamento.
- Selecione a ramificação a ser implantada.
- Selecione a confirmação a ser implantada, seja a mais recente ou uma anterior especificada pelo ID.
- 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
Restaurar um lançamento anterior
O App Hosting oferece duas opções para restaurar um lançamento anterior:
- Desfazer alterações instantaneamente sem precisar reconstruir
- Reconstruir e reverter para uma versão anterior
Criar uma reversão instantânea
Às vezes, talvez seja necessário reverter rapidamente para uma versão mais antiga do app, por exemplo, se você descobrir um bug crítico em um lançamento recém-implantado ou se estiver enfrentando um build instável que está bloqueando novos lançamentos. Nesses casos, é possível restaurar uma imagem de contêiner de sua escolha de uma versão anterior. Essa imagem não é recriada, mas usa a configuração de código e ambiente de quando foi criada pela primeira vez.
Para criar uma reversão instantânea:
- Na guia Hospedagem de apps, selecione Visualizar painel para o back-end em que você quer criar uma reversão.
- Na tabela Histórico de lançamento do back-end, selecione o menu de três pontos para um build anterior.
- Selecione Reverter para este build e confirme.
Recriar e reverter
Se você quiser reverter para uma versão mais antiga do app, mas manter a configuração atual, é possível recriar o app como parte do processo de reversão. Por exemplo, se a versão mais recente atualizou um valor de chave de API no Secret Manager, a recriação pode garantir que a nova chave seja usada no app após a reversão.
Para recriar e reverter:
- Na guia Hospedagem de apps, selecione Visualizar painel para o back-end em que você quer criar uma reversão.
- Selecione Criar lançamento.
- Na caixa de diálogo Criar um lançamento, marque Commit anterior e insira o ID do commit da versão que você quer recriar e reverter. O ID de confirmação faz parte dos "Detalhes da alteração" de cada lançamento listado no Histórico de lançamento,contido entre parênteses no rótulo.
- Selecione Criar para iniciar a reversão.
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.
- Na guia App Hosting, selecione Visualizar painel para o back-end em que você quer atualizar as configurações de lançamento.
- No painel de back-end, selecione Configurações. A visualização padrão mostra informações sobre domínios e domínios personalizados.
- 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).