Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Compartilhe recursos do projeto em vários sites

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Você pode configurar um ou mais sites do Firebase Hosting em um único projeto do Firebase. Como os sites estão todos no mesmo projeto do Firebase, todos os sites podem acessar os outros recursos do Firebase do projeto.

Ao configurar vários sites de hospedagem no mesmo projeto do Firebase, você pode compartilhar recursos do Firebase com mais facilidade entre sites e aplicativos relacionados. Por exemplo, se você configurar seu blog, painel de administração e aplicativo público como sites individuais no mesmo projeto do Firebase, todos eles poderão compartilhar o mesmo banco de dados de usuários do Firebase Authentication, além de ter seus próprios domínios ou conteúdo exclusivos.

Etapa 1 : atualize sua versão do Firebase CLI

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

Etapa 2 : adicionar sites adicionais

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

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

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

  • Use a API REST de hospedagem: projects.sites.create

Para cada um desses métodos, você especificará um SITE_ID que é 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 é usado para esses URLs, o ID do site tem os seguintes requisitos:

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

Para cada site, você também pode opcionalmente adicionar domínios personalizados para servir o mesmo conteúdo e configuração para vários URLs.

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 Firebase console

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

  • Use a API REST de hospedagem: projects.sites.delete

Observe que você não pode excluir o site padrão, que tem o mesmo SITE_ID do ID do projeto Firebase.

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

Quando você tem vários sites e executa comandos de implantação da Firebase CLI, a CLI precisa de uma maneira de comunicar quais configurações devem ser implantadas em cada site. Com destinos de implantação, você pode identificar exclusivamente um site específico com um TARGET_NAME em seu arquivo de firebase.json firebase.json e em seus comandos Firebase CLI para teste ou implantação em seus sites.

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

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

Onde os parâmetros são:

  • TARGET_NAME — um nome exclusivo (definido por você mesmo) para o site de hospedagem no qual você está implantando

  • RESOURCE_IDENTIFIER — o SITE_ID do site de hospedagem conforme listado em seu projeto Firebase

Por exemplo, se você criou dois sites ( myapp-blog e myapp-app ) em seu projeto Firebase, pode aplicar um TARGET_NAME exclusivo ( blog e app , respectivamente) a 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 seu projeto, portanto, você só precisa configurar os destinos de implantação uma vez por projeto.

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

Use o TARGET_NAME aplicado de um site ao definir sua configuração de hospedagem em seu arquivo firebase.json .

  • Se seu arquivo firebase.json definir a configuração para 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 seu arquivo firebase.json definir a configuração para apenas um site, não é necessário usar um formato de array:

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

Etapa 5 : teste localmente, visualize as alterações e implante em seus sites

Execute qualquer um dos comandos a seguir na raiz do diretório local do projeto.

Comando Descrição
firebase emulators:start --only hosting Emula o conteúdo e a configuração do Hosting do site padrão do Hosting em uma URL hospedada localmente
firebase emulators:start --only hosting: TARGET_NAME Emula o conteúdo e a configuração do Hosting do site do Hosting especificado em uma URL hospedada localmente
firebase hosting:channel:deploy \
CHANNEL_ID
Implanta o conteúdo e a configuração do Hosting do site padrão do Hosting 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 do Hosting especificado em um URL de visualização
firebase deploy --only hosting Implanta o conteúdo e a configuração do Hosting no canal ao vivo 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 ao vivo do site do Hosting especificado
Comando Descrição
(não recomendado; use emulators:start )
firebase serve --only hosting
Exibe o conteúdo e a configuração do Hosting do site padrão do Hosting em uma URL hospedada 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 do Hosting especificado em uma URL hospedada localmente