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.
- Cada site tem sua própria configuração de hospedagem .
- Cada site hospeda sua própria coleção de conteúdo.
- Cada site pode ter um ou mais domínios associados .
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 \ | 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 \ | 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 |