Compartilhar recursos do projeto em vários sites

É possível configurar um ou mais sites do Firebase Hosting em um único projeto do Firebase. Como todos os sites estão no mesmo projeto, eles podem acessar os outros recursos do Firebase do projeto.

• Cada site tem a própria configuração de hospedagem.
• Cada site hospeda o próprio conjunto de conteúdo.
• Cada site pode ter um ou mais domínios associados.

Ao definir vários sites do Hosting no mesmo projeto do Firebase, você facilita o compartilhamento dos recursos dele entre sites e aplicativos relacionados. Por exemplo, se você configurar seu blog, painel de administração e app público como sites individuais no mesmo projeto, todos eles poderão compartilhar o mesmo banco de dados de usuários do Firebase Authentication, além de ter os próprios domínios ou conteúdo.

Importante: para refletir seus ambientes de fluxo de trabalho (por exemplo, Dev, Q1, Q2 e Prod), recomendamos que você crie um projeto do Firebase separado para cada ambiente, em vez de criar vários sites em um único. Geralmente, não é vantajoso usar recursos do Firebase do ambiente de produção (como dados de clientes em um Realtime Database) em um ambiente de desenvolvimento. Use a configuração automática do SDK para refletir vários ambientes por meio de uma única base de código.

O recurso de vários sites é compatível com no máximo 36 sites por projeto do Firebase.

Etapa 1: atualizar sua versão da CLI do Firebase

Acesse os recursos mais recentes do Firebase Hosting ao atualizar para a versão mais recente da Firebase CLI.

Etapa 2: adicionar outros sites

Adicione outros sites a um projeto do Firebase usando um dos seguintes métodos:

• Use o fluxo de trabalho na página Hosting do console do Firebase

• Use o comando da CLI do Firebase: firebase hosting:sites:create SITE_ID

• Use a API REST do Hosting: projects.sites.create

Para cada um desses métodos, você especificará um SITE_ID usado para construir os subdomínios padrão provisionados pelo Firebase para o site:

• SITE_ID.web.app
• SITE_ID.firebaseapp.com

Como o SITE_ID é usada para esses URLs, o ID do site tem os seguintes requisitos:

• Precisa ser um rótulo de nome de host válido, o que significa que não pode conter ., _ etc.
• Precisa ter 30 caracteres ou menos.
• Precisa ser globalmente exclusivo no Firebase.

Para cada site, também é possível adicionar domínios personalizados para exibir o mesmo conteúdo e configuração em vários URLs.

Observação: se você criou várias instâncias do Firebase Realtime Database no seu projeto antes de agosto de 2018, o Firebase fez o provisionamento automático de um site correspondente para cada instância de banco de dados. Se você não precisar desses sites, poderá excluí-los sem afetar suas instâncias de banco de dados.

Excluir um site secundário

Exclua sites indesejados de um projeto do Firebase usando um dos seguintes métodos:

• Use o fluxo de trabalho na página Hosting do console do Firebase

• Use o comando da CLI do Firebase: firebase hosting:sites:delete SITE_ID

• Use a API REST do Hosting: projects.sites.delete

Não é possível excluir o site padrão, que tem o mesmo SITE_ID que o ID do projeto do Firebase.

Cuidado: a exclusão de um site é uma ação permanente. Se você fizer isso, o Firebase não manterá registros de arquivos implantados ou o histórico de implantação. Além disso, nem você nem qualquer outra pessoa poderá reativar o SITE_ID.

Etapa 3: configurar destinos de implantação para seus sites

Quando você tem vários sites e executa os comandos de implantação da CLI do Firebase, a interface da linha de comando precisa saber como informar quais configurações precisam ser implantadas em cada site. Com os destinos de implantação é possível identificar de forma exclusiva um site específico com um TARGET_NAME no seu firebase.json arquivo de configuração e comandos da CLI do Firebase para testar ou implantar sites.

Importante: o uso de destinos de implantação é a maneira recomendada de configurar implantações para vários sites do Hosting.
Se você configurou o arquivo firebase.json anteriormente fazendo referência explícita ao SITE_ID, edite a configuração firebase.json e os comandos da CLI para usar destinos de implantação.

Para criar um destino de implantação e aplicar um TARGET_NAME a um site do Hosting, execute o seguinte comando da CLI usando a raiz do diretório do seu projeto:

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

Em que os parâmetros são:

• TARGET_NAME: um nome exclusivo (definido por você) para o site do Hosting em que as implantações serão realizadas

• RESOURCE_IDENTIFIER: o SITE_ID do site do Hosting conforme listado no seu projeto do Firebase

Por exemplo, se você criou dois sites (myapp-blog e myapp-app) no seu projeto do Firebase, você pode aplicar um TARGET_NAME exclusivo (blog e app, respectivamente) para cada site executando os seguintes comandos:

firebase target:apply hosting blog myapp-blog

firebase target:apply hosting app myapp-app

As configurações dos destinos de implantação são armazenadas no arquivo .firebaserc no diretório do projeto. Portanto, você só precisa configurar os destinos de implantação uma vez por projeto.

Etapa 4: definir a configuração de hospedagem para cada site

Use TARGET_NAME aplicado a um site ao definir a configuração de hospedagem no arquivo firebase.json.

• Se o arquivo firebase.json definir a configuração de vários sites, use um formato de matriz:

  {
    "hosting": [ {
        "target": "blog",  // "blog" is the applied TARGET_NAME for the Hosting site "myapp-blog"
        "public": "blog/dist",  // contents of this folder are deployed to the site "myapp-blog"
  
        // ...
      },
      {
        "target": "app",  // "app" is the applied TARGET_NAME for the Hosting site "myapp-app"
        "public": "app/dist",  // contents of this folder are deployed to the site "myapp-app"
  
        // ...
  
        "rewrites": [...]  // You can define specific Hosting configurations for each site
      }
    ]
  }
  

• Se o arquivo firebase.json definir a configuração de apenas um site, não será necessário usar um formato de matriz:

  {
    "hosting": {
        "target": "blog",
        "public": "dist",
  
        // ...
  
        "rewrites": [...]
    }
  }
  

Etapa 5: testar localmente, visualizar alterações e implantar nos seus sites

Execute qualquer um dos seguintes comandos da raiz do diretório local do seu projeto.

Comando	Descrição
firebase emulators:start --only hosting	Emula o conteúdo e a configuração do Hosting do site do padrão em um URL hospedado localmente
firebase emulators:start --only hosting:TARGET_NAME	Emula o conteúdo e a configuração do Hosting do site especificado do Hosting em um URL hospedado localmente
firebase hosting:channel:deploy \ CHANNEL_ID	Implanta o conteúdo e a configuração do Hosting do site do padrão em um URL de visualização
firebase hosting:channel:deploy \ CHANNEL_ID --only TARGET_NAME	Implanta o conteúdo e a configuração do Hosting do site especificado do Hosting em um URL de visualização
firebase deploy --only hosting	Implanta o conteúdo e a configuração do Hosting no canal ativo de todos os sites do Hosting configurados em firebase.json
firebase deploy --only hosting:TARGET_NAME	Implanta o conteúdo e a configuração do Hosting no canal ativo do site do Hosting especificado

Comando	Descrição
(não recomendado; use emulators:start) firebase serve --only hosting	Veicula o conteúdo e a configuração do Hosting do site do padrão em um URL hospedado localmente
(não recomendado; use emulators:start) firebase serve --only hosting:TARGET_NAME	Exibe o conteúdo e a configuração do Hosting do site especificado do Hosting em um URL hospedado localmente

Observação: ao executar comandos com a sinalização --only hosting, você está apenas reproduzindo ou implantando o conteúdo e a configuração do Hosting. Se você também quiser emular ou implantar outros recursos ou configurações do projeto, como funções ou regras de banco de dados, execute comandos com uma lista separada por vírgulas na sinalização (por exemplo, --only hosting,functions).

Para implantações em canais de visualização, não especifique hosting na sinalização --only porque esses comandos só podem implantar seu conteúdo e a configuração do Hosting.