O Firebase Hosting fornece ferramentas por meio do console do Firebase e da CLI do Firebase para gerenciar os canais, lançamentos e versões do seu site do Hosting.
Visão geral da infraestrutura de hospedagem
Compreender a infraestrutura de hospedagem ajuda você a entender as opções de gerenciamento descritas nesta página.
Todo projeto Firebase possui um site Hosting padrão com acesso a todos os recursos do projeto (bancos de dados, autenticação, funções, etc.). Um site contém um ou mais canais , onde cada canal está associado a uma URL que veicula conteúdo específico e uma configuração de hospedagem.
Cada site de hospedagem tem um canal "ao vivo" que veicula conteúdo e uma configuração de hospedagem em (1) os subdomínios provisionados pelo Firebase do site ( SITE_ID .web.app
e SITE_ID .firebaseapp.com
) e (2) quaisquer domínios personalizados conectados. Opcionalmente, você também pode criar canais de "visualização" que veiculam seu próprio conteúdo e configuração em "URLs de visualização" temporários e compartilháveis (SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app
).
Gerenciar as configurações de um canal
Limite o número de lançamentos a serem mantidos
Por que a Hosting mantém as versões anteriores?
Para o seu canal ao vivo, manter as versões anteriores permite reverter para uma versão anterior do seu site, se necessário. Para seus canais de visualização, a reversão ainda não está disponível.Por que limitar o número de lançamentos a serem mantidos?
Este recurso pode ajudá-lo a controlar o nível de uso do armazenamento do Hosting do seu projeto , já que o conteúdo das versões anteriores é mantido neste armazenamento. Você pode monitorar o armazenamento do Hosting na guia Armazenamento no console.O que acontece quando você limita os lançamentos a serem mantidos?
Quando você define um limite de lançamentos a serem mantidos, o conteúdo de todos os lançamentos acima do limite definido é agendado para exclusão, começando primeiro pelos lançamentos mais antigos .
No console do Firebase , acesse a caixa de diálogo de configuração de armazenamento de lançamento: Para o seu canal ao vivo
Na tabela Histórico de versões do seu site, clique em e selecione Liberar configurações de armazenamento .Para qualquer canal de visualização
Na linha do canal de visualização, clique em e selecione Configurações do canal .
Insira o número de versões que você deseja manter e clique em Salvar .
Definir a expiração de um canal de visualização
Console do Firebase
Na linha do canal de visualização, clique em e selecione Configurações do canal . Insira a data e hora de expiração.CLI do Firebase
Ao implantar em seu canal de visualização, passe o sinalizador--expires DURATION
, por exemplo:firebase hosting:channel:deploy new-awesome-feature --expires 7d A expiração pode ser de até 30 dias a partir da data de implantação. Use h
para horas,d
para dias ew
para semanas (por exemplo,12h
,7d
,2w
, respectivamente).
Clonar uma versão de um canal para outro
Clone de um canal de visualização de "QA" para o canal ao vivo do seu site (ao vivo!) Clone do canal ativo do seu site para um canal de visualização de "depuração" (como antes de uma reversão) Clone de um canal no seu projeto "teste" do Firebase para um canal de visualização no seu projeto "prod" do Firebase
firebase hosting:clone SOURCE_SITE_ID :SOURCE_CHANNEL_ID TARGET_SITE_ID :TARGET_CHANNEL_ID
SOURCE_SITE_ID e TARGET_SITE_ID : Estes são os IDs dos sites de hospedagem que contêm os canais. Para seu site de hospedagem padrão, use o ID do projeto do Firebase. Você pode especificar sites de hospedagem que estão no mesmo projeto do Firebase ou até mesmo em projetos diferentes do Firebase.
SOURCE_CHANNEL_ID e TARGET_CHANNEL_ID : estes são os identificadores dos canais. Para um canal ao vivo, use live
como ID do canal.Se o canal "destino" especificado ainda não existir, este comando cria o canal antes de implantá-lo.
Quando você clona uma versão de um canal para outro no mesmo site do Hosting , o Firebase cria um novo objeto de lançamento que aponta exatamente para a mesma versão . Você verá duas versões em seu site de hospedagem que apontam para a mesma versão (conforme identificado pelo ID da versão).
No entanto, se você clonar uma versão para um canal em um site de hospedagem diferente (ou em um projeto diferente do Firebase), o Firebase criará uma nova versão e uma nova versão (conforme identificado por um ID de versão diferente).
Reverter para uma versão anterior do seu site
No console do Firebase , na tabela Histórico de versões do seu site, passe o mouse sobre a entrada da versão anterior para a qual você deseja reverter. Clique em e selecione Reverter .
Excluir manualmente uma versão
No console do Firebase , na tabela Histórico de versões do seu site, passe o mouse sobre a entrada da versão anterior que você deseja excluir. Clique em e selecione Excluir .
Excluir manualmente um canal de visualização
Console do Firebase
Na linha do canal de visualização, clique em e selecione Excluir canal . Confirme a exclusão.CLI do Firebase
Execute o seguinte comando em qualquer diretório:firebase hosting:channel:delete CHANNEL_ID
Comandos CLI para visualização de canais e clonagem
Comandos para visualização de canais
Comando | Descrição |
---|---|
firebase hosting:channel:create CHANNEL_ID | Cria um novo canal de visualização no site de hospedagem padrão usando o Este comando não é implementado no canal. |
firebase hosting:channel:delete CHANNEL_ID | Exclui o canal de visualização especificado Você não pode excluir o canal ativo de um site. |
firebase hosting:channel:deploy CHANNEL_ID | Implanta seu conteúdo e configuração do Hosting no canal de visualização especificado Se o canal de visualização ainda não existir, este comando cria o canal no site de hospedagem padrão antes de implantar no canal. |
firebase hosting:channel:list | Lista todos os canais (incluindo o canal "ao vivo") no site de hospedagem padrão |
firebase hosting:channel:open CHANNEL_ID | Abre um navegador para o URL do canal especificado ou retorna o URL se não for possível abrir em um navegador |
Comandos para clonagem de versão
Comando | Descrição |
---|---|
firebase hosting:clone \ | Clona a versão implantada mais recentemente no canal "origem" especificado para o canal "destino" especificado Este comando também é implementado no canal "destino" especificado. Se o canal "destino" ainda não existir, este comando cria um novo canal de visualização no site de hospedagem "destino" antes de implantar no canal. |
firebase hosting:clone \ | Clona a versão especificada para o canal "destino" especificado Este comando também é implementado no canal "destino" especificado. Se o canal "destino" ainda não existir, este comando cria um novo canal de visualização no site de hospedagem "destino" antes de implantar no canal. Você pode encontrar o |