Primeiros passos com o Cloud Storage na Web

Com o Cloud Storage para Firebase, é possível fazer upload e compartilhar conteúdo gerado por usuários, como imagens e vídeos. Com isso, você tem os recursos para criar conteúdo de rich media nos apps. Seus dados são armazenados em um bucket do Google Cloud Storage, uma solução de armazenamento de objetos com capacidade que chega aos exabytes, além de alta disponibilidade e redundância global. Com o Cloud Storage para Firebase, o upload dos arquivos é feito com segurança e facilidade diretamente de dispositivos móveis e navegadores da Web, mesmo em redes intermitentes.

Pré-requisitos

Adicione e configure o SDK do Firebase no seu app.

Criar um bucket padrão do Cloud Storage

No painel de navegação do Console do Firebase, selecione Storage e clique em Primeiros passos.
Leia as mensagens sobre como proteger seus dados do Cloud Storage usando regras de segurança. Durante o desenvolvimento, avalie a possibilidade de configurar suas regras para acesso público.
Selecione um local para o bucket padrão do Cloud Storage.
- Essa configuração de localização é o local padrão dos recursos do Google Cloud Platform (GCP) no seu projeto. Esse local será usado por serviços do GCP no projeto que exigem uma configuração de localização, especificamente o banco de dados do Cloud Firestore e o aplicativo do App Engine, que é necessário se você usa o Cloud Scheduler.
- Se não é possível selecionar um local, então seu projeto já tem um local padrão dos recursos do GCP. Ele foi definido durante a criação do projeto ou ao configurar outro serviço que requer uma configuração de local.
Se você estiver no plano Blaze, poderá criar vários buckets, cada um com o próprio local.

Aviso: depois de definir o local padrão dos recursos do GCP no projeto, não será possível alterá-lo.
Clique em Concluído.

Configurar acesso público

Com o Cloud Storage para Firebase, você tem uma linguagem de regras declarativas para definir como os dados são estruturados, indexados e quando podem ser lidos e gravados. Por padrão, o acesso de leitura e gravação do Cloud Storage é restrito aos usuários autenticados. Para iniciar sem configurar o Authentication, defina as regras para acesso público.

Fazer isso tornará o Cloud Storage disponível para todos, até para os que não usam o app. Por isso, restrinja o Cloud Storage novamente quando for configurar a autenticação.

Adicionar o URL do seu intervalo ao seu app

Se o URL do intervalo do Cloud Storage ainda não estiver incluído, será necessário adicioná-lo ao objeto de configuração do app Firebase.

Acesse o painel do Storage no Console do Firebase.
Clique na guia Arquivos e procure no cabeçalho do visualizador de arquivos.
Copie o URL para sua área de transferência. Geralmente, está no formato project-id.appspot.com.

Ao objeto firebaseConfig do app, adicione o atributo storageBucket com o URL do bucket:

Versão 9 para a Web

import { initializeApp } from "firebase/app";
import { getStorage } from "firebase/storage";

// Set the configuration for your app
// TODO: Replace with your app's config object
const firebaseConfig = {
  apiKey: '<your-api-key>',
  authDomain: '<your-auth-domain>',
  databaseURL: '<your-database-url>',
  storageBucket: '<your-storage-bucket-url>'
};
const firebaseApp = initializeApp(firebaseConfig);

// Get a reference to the storage service, which is used to create references in your storage bucket
const storage = getStorage(firebaseApp);storage_initialize.js

Versão 8 para a Web

// Set the configuration for your app
// TODO: Replace with your app's config object
var firebaseConfig = {
  apiKey: '<your-api-key>',
  authDomain: '<your-auth-domain>',
  databaseURL: '<your-database-url>',
  storageBucket: '<your-storage-bucket-url>'
};
firebase.initializeApp(firebaseConfig);

// Get a reference to the storage service, which is used to create references in your storage bucket
var storage = firebase.storage();index.js

Tudo pronto para usar o Cloud Storage.

Próxima etapa? Aprenda a criar uma referência do Cloud Storage.

Configuração avançada

Há alguns casos de uso que exigem configuração adicional:

Usar buckets do Cloud Storage em várias regiões geográficas
Utilizar buckets do Cloud Storage em diferentes classes de armazenamento
Usar buckets do Cloud Storage com vários usuários autenticados no mesmo app

O primeiro caso de uso é perfeito para quem tem usuários em todo o mundo e quer armazenar os dados perto deles. Por exemplo, para armazenar os dados dos usuários dos EUA, da Europa e da Ásia, crie buckets nessas regiões para reduzir a latência.

O segundo caso de uso é útil quando você tem dados com diferentes padrões de acesso. Por exemplo, configure um bucket multirregional ou local que armazene imagens ou outros conteúdos acessados frequentemente e um bucket nearline ou coldline que armazene backups de usuários ou outros conteúdos pouco acessados.

Em qualquer um desses casos de uso, você precisará usar vários buckets do Cloud Storage.

O terceiro caso de uso é útil ao criar um app, como o Google Drive, em que os usuários têm diversas contas conectadas. Por exemplo, uma conta pessoal e uma conta corporativa. Para autenticar cada conta adicional, é possível usar uma instância personalizada do app do Firebase.

Usar vários buckets do Cloud Storage

Para usar um bucket do Cloud Storage diferente do padrão fornecido acima ou vários buckets em um único app, crie uma instância de firebase.storage que faça referência ao seu bucket personalizado:

Versão 9 para a Web

import { getApp } from "firebase/app";
import { getStorage } from "firebase/storage";

// Get a non-default Storage bucket
const firebaseApp = getApp();
const storage = getStorage(firebaseApp, "gs://my-custom-bucket");storage_multiple_buckets.js

Versão 8 para a Web

// Get a non-default Storage bucket
var storage = firebase.app().storage("gs://my-custom-bucket");index.js

Trabalhar com buckets importados

Ao importar um bucket do Cloud Storage para o Firebase, é preciso conceder ao Firebase acesso a esses arquivos com a ferramenta gsutil inclusa no SDK Google Cloud:

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Você encontra o número do projeto conforme descrito na introdução a projetos do Firebase.

Isso não afeta os buckets recém-criados, porque eles têm o controle de acesso padrão, que autoriza o Firebase. Essa é uma medida temporária e será realizada automaticamente no futuro.

Usar um app personalizado do Firebase

Para desenvolver um app mais complexo usando um firebase.app.App personalizado, crie uma instância de firebase.storage.Storage inicializada com esse app:

Versão 9 para a Web

import { getStorage } from "firebase/storage";

// Get the default bucket from a custom firebase.app.App
const storage1 = getStorage(customApp);

// Get a non-default bucket from a custom firebase.app.App
const storage2 = getStorage(customApp, "gs://my-custom-bucket");storage_custom_app.js

Versão 8 para a Web

// Get the default bucket from a custom firebase.app.App
var storage = customApp.storage();

// Get a non-default bucket from a custom firebase.app.App
var storage = customApp.storage("gs://my-custom-bucket");index.js

Próximas etapas

Prepare-se para lançar seu aplicativo:
- Ative o App Check para garantir que apenas seus apps possam acessar os buckets de armazenamento.
- Configure alertas de orçamento para o projeto no Console do Google Cloud.
- Monitore o painel Uso e faturamento no Console do Firebase para ter uma visão geral do uso do projeto em vários serviços do Firebase. Também é possível acessar o painel Uso do Cloud Storage para ver informações de uso mais detalhadas.
- Consulte a lista de verificação de lançamento do Firebase.