Catch up on everthing we announced at this year's Firebase Summit. Learn more

Gerenciar canais ao vivo e de visualização, lançamentos e versões para seu site

O Firebase Hosting fornece ferramentas por meio do console do Firebase e da Firebase CLI 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.

Projeto de cada Firebase tem um site de hospedagem padrão com acesso a todos os recursos do projeto (bancos de dados, autenticação, funções, etc.). Um local contém um ou mais canais, em que cada canal está associado com um URL que serve conteúdo específico e uma configuração de hospedagem.

uma imagem da hierarquia do Firebase Hosting

Cada site de hospedagem tem um canal "ao vivo" que serve conteúdo e uma configuração hospeda em (1) subdomínios Firebase-provisionados do site ( SITE_ID .web.app e SITE_ID .firebaseapp.com ) e (2) qualquer conectados domínios personalizados . Você também pode criar opcionalmente canais "preview" que servem os seus próprios conteúdos e configuração em, compartilháveis "URLs de visualização" temporários ( SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app ).

O conteúdo e a configuração servida por cada canal é empacotado em um objeto versão que tem um identificador único. Ao implantar a seu local, Firebase cria um objeto de lançamento que aponta para uma versão específica. Uma versão contém metadados sobre a implantação, como quem implantou e quando foi implantado.

A partir do seu projeto Firebase painel de hospedagem , você pode ver um histórico completo de lançamentos de seu canal ao vivo em uma tabela de histórico Release. Se você tem vários sites de hospedagem , clique em Exibir para o site desejado para ver sua história de lançamento. Se você tiver canais de visualização, eles também serão exibidos no painel do Hosting.

Gerenciar as configurações de um canal

Para cada canal do seu site, você pode controlar suas configurações. Algumas configurações, como expiração de canal, são aplicáveis ​​apenas para canais de visualização.

Limite o número de lançamentos para manter

Cada vez que você implanta em um canal (e cria uma versão), o Hosting mantém a versão associada à versão anterior no armazenamento do Hosting do seu projeto. Você pode definir o número de lançamentos para manter para cada canal em seu projeto, ambos os canais ao vivo e visualização.

  • Por que o Hosting mantém as versões anteriores?
    Para o seu canal ao vivo, mantendo versões anteriores permite-lhe reverter para uma versão anterior de 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?
    Esse recurso pode ajudar a controlar o nível de uso de seu armazenamento de hospedagem do projeto , como o conteúdo de versões anteriores é mantida neste armazenamento. Você pode monitorar o seu armazenamento de hospedagem da guia Armazenamento no console.

  • O que acontece quando você limita os lançamentos a serem mantidos?
    Quando você definir um limite para lançamentos de manter, pelo conteúdo de quaisquer lançamentos ao longo do seu limite definido está marcado para deleção, começando com os mais antigos lançamentos primeiros.

Veja como definir o limite de armazenamento de liberação para um canal:

  1. Na consola Firebase , o acesso a janela de configuração de armazenamento de lançamento:

    • Para o seu canal ao vivo
      Na tabela de História lançamento para o seu site, clique , em seguida, selecione as configurações de armazenamento de versão.

    • Para qualquer canal de visualização
      Na linha para o canal de visualização, clique , em seguida, selecione Configurações do canal.

  2. Digite o número de lançamentos que você gostaria de manter, em seguida, clique em Salvar.

Defina a expiração de um canal de visualização

Por padrão, um canal de visualização expira 7 dias a partir da data de criação, mas o canal ao vivo do seu site nunca expira.

Quando um canal de visualização expira, o canal, junto com seus lançamentos e versões associadas, são programados para exclusão em 24 horas. O URL de visualização associado também é desativado. Uma exceção a esta versão de exclusão é se uma versão está associada a outra versão (isso acontece, por exemplo, se você clonar uma versão de um canal para outro dentro do mesmo site).

A hospedagem oferece suporte a duas maneiras diferentes de controlar a expiração de um canal:

  • Console do Firebase
    Na linha para o canal de visualização, clique , em seguida, selecione Configurações do canal. Insira a data e a hora de expiração.

  • Firebase CLI
    Quando você implanta o seu canal de visualização, passe o --expires DURATION bandeira, 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. Uso h durante horas, d dias, e w por semana (por exemplo, 12h , 7d , 2w , respectivamente).

Clone uma versão de um canal para outro

Você pode clonar uma versão implantada de um canal para um canal diferente. Você pode clonar em canais ao vivo ou de visualização, em sites de hospedagem ou até mesmo em projetos do Firebase.

O comando clone também implanta ao canal "target" para que a hospedagem de conteúdo clonado e de configuração são automaticamente servido no URL associado do canal "alvo".

Este recurso é útil para a versão de rastreamento ou se você quer a confiança que você está implantando o conteúdo exato que você já visualizou e / ou testado em outro canal. aqui estão alguns exemplos:

  • Clone de um canal de visualização "QA" para o canal ao vivo do seu site (indo ao vivo!)

  • Clone do canal ao vivo do seu site para um canal de visualização de "depuração" (como antes de uma reversão)

  • Clone de um canal em seu projeto de "teste" do Firebase para um canal de visualização em seu projeto de "produção" do Firebase

Para clonar uma versão, execute o seguinte comando em qualquer diretório:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

Substitua cada espaço reservado pelo seguinte:

  • SOURCE_SITE_ID e TARGET_SITE_ID : Estes são os IDs dos sites de hospedagem que contêm os canais.

    • Para o seu site de hospedagem padrão, use o seu project ID do Firebase.
    • Você pode especificar sites de hospedagem que estão no mesmo projeto Firebase ou até mesmo em projetos Firebase diferentes.
  • SOURCE_CHANNEL_ID e TARGET_CHANNEL_ID : Estes são os identifers para os canais.

    • Para um canal ao vivo, use live como o ID do canal.
    • Se o canal "alvo" especificado ainda não existe, este comando cria o canal antes de implantar nele.

Reverta para uma versão anterior do seu site

Você pode reverter para veicular uma versão anterior do canal ao vivo de seu site. Esta ação é útil se sua versão atual tiver um problema e você quiser reverter para servir uma versão funcional conhecida de seu site. Ou talvez seu site tenha servido conteúdo temporário para um feriado ou evento especial, mas agora você deseja reverter para veicular seu conteúdo "normal".

Ao reverter, você cria uma nova versão que oferece a mesma versão de conteúdo de uma versão anterior. Em sua mesa de história Release, ambos os lançamentos irá listar o mesmo identificador de versão.

Veja como reverter:

  1. Na consola Firebase , na tabela Histórico de Lançamentos para o seu site, pairar sobre a entrada de versão anterior que deseja reverter para.

  2. Clique , em seguida, selecione Reverter.

Excluir manualmente uma versão

Talvez seja necessário excluir manualmente um lançamento do seu canal ao vivo para liberar hospedagem de armazenamento para o seu projeto. Você só pode excluir versões anteriores, não a versão que está sendo veiculada em seu site ativo.

Quando você exclui um lançamento, está na verdade excluindo seu conteúdo, que está programado para exclusão em 24 horas. O próprio objeto de liberação é mantido para que você ainda possa ver seus metadados (quem foi implantado e quando foi implantado).

Veja como excluir uma versão:

  1. Na consola Firebase , na tabela Histórico de Lançamentos para o seu site, pairar sobre a entrada de versão anterior que você deseja excluir.

  2. Clique , em seguida, selecione Delete.

Exclua manualmente um canal de visualização

Você pode excluir um canal de visualização, mas não pode excluir o canal ao vivo do seu site.

Quando você exclui um canal de visualização, o canal, junto com seus lançamentos e versões associadas, são programados para exclusão em 24 horas. O URL de visualização associado também é desativado. Uma exceção à versão de exclusão é se uma versão está associada a outra versão (isso acontece, por exemplo, se você clonar uma versão de um canal para outro dentro do mesmo site).

O Hosting oferece suporte a duas maneiras diferentes de excluir um canal de visualização:

  • Console do Firebase
    Na linha para o canal de visualização, clique , em seguida, selecionar o canal Delete. Confirme a exclusão.

  • Firebase CLI
    Execute o seguinte comando em qualquer diretório:

    firebase hosting:channel:delete CHANNEL_ID

Comandos CLI para canais de visualização e clonagem

Comandos para canais de visualização

Todos os comandos para os canais de visualização apoiar alvos Implantar se você tem vários sites de hospedagem .

Comando Descrição
firebase hosting:channel:create CHANNEL_ID

Cria um novo canal de visualização no padrão site de hospedagem usando o especificado CHANNEL_ID

Este comando não implanta no canal.

firebase hosting:channel:delete CHANNEL_ID

Exclui o canal de visualização especificado

Você não pode excluir o canal ao vivo de um site.

firebase hosting:channel:deploy CHANNEL_ID

Implanta seu conteúdo e configuração do Hosting para o canal de visualização especificado

Se o canal de visualização ainda não existe, este comando cria o canal no padrão site de hospedagem antes de implantar o canal.

firebase hosting:channel:list Lista todos os canais (incluindo o canal "ao vivo") no padrão site de hospedagem
firebase hosting:channel:open CHANNEL_ID Abre um navegador no 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 \
SOURCE_SITE_ID : SOURCE_CHANNEL_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

Clona a versão implementada mais recentemente no canal "fonte" especificado para o canal "destino" especificado

Este comando também é implantado no canal de "destino" especificado. Se o canal "alvo" ainda não existe, este comando cria um novo canal de visualização no site de hospedagem "alvo" antes de implantar no canal.

firebase hosting:clone \
SOURCE_SITE_ID :@ VERSION_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

Clona a versão especificada para o canal "alvo" especificado

Este comando também é implantado no canal de "destino" especificado. Se o canal "alvo" ainda não existe, este comando cria um novo canal de visualização no site de Hospedagem "alvo" antes de implantar no canal.

Você pode encontrar o VERSION_ID no painel de hospedagem do console Firebase.