O Cloud Storage para Firebase permite fazer upload e compartilhar conteúdo gerado pelo usuário, como imagens e vídeos, o que permite criar conteúdo rich media em seus aplicativos. Seus dados são armazenados em um bucket do Google Cloud Storage , uma solução de armazenamento de objetos em escala de exabytes com alta disponibilidade e redundância global. O Cloud Storage para Firebase permite fazer upload desses arquivos com segurança, diretamente de dispositivos móveis e navegadores da Web, lidando com redes irregulares com facilidade.
Pré-requisitos
Se ainda não o fez, instale o Firebase JS SDK e inicialize o Firebase .
Criar um intervalo padrão do Cloud Storage
No painel de navegação do console do Firebase , selecione Armazenamento e clique em Primeiros passos .
Revise as mensagens sobre como proteger seus dados do Cloud Storage usando regras de segurança. Durante o desenvolvimento, considere configurar suas regras para acesso público .
Selecione um local para seu bucket padrão do Cloud Storage.
Esta configuração de local é o local de recurso padrão do Google Cloud Platform (GCP) do seu projeto. Observe que esse local será usado para serviços do GCP no seu projeto que exigem uma configuração de local, especificamente, seu banco de dados do Cloud Firestore e seu aplicativo do App Engine (o que é necessário se você usar o Cloud Scheduler).
Se você não conseguir selecionar um local, seu projeto já terá um local de recurso padrão do GCP. Foi definido durante a criação do projeto ou durante a configuração de outro serviço que requer uma configuração de localização.
Se você estiver no plano Blaze, poderá criar vários buckets , cada um com seu próprio local .
Clique em Concluído .
Configurar o acesso público
O Cloud Storage para Firebase fornece uma linguagem de regras declarativas que permite definir como seus dados devem ser estruturados, como devem ser indexados e quando seus dados podem ser lidos e gravados. Por padrão, o acesso de leitura e gravação ao Cloud Storage é restrito para que somente usuários autenticados possam ler ou gravar dados. Para começar sem configurar a autenticação , você pode configurar suas regras para acesso público .
Isso torna o Cloud Storage aberto a qualquer pessoa, até mesmo a pessoas que não usam seu aplicativo. Portanto, restrinja seu Cloud Storage novamente ao configurar a autenticação.
Adicione o URL do seu bucket ao seu aplicativo
Se ainda não estiver incluído, você precisará adicionar o URL do bucket do Cloud Storage ao objeto de configuração do seu aplicativo Firebase .
Vá para o painel de armazenamento 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
firebaseConfigno seu aplicativo, adicione o atributostorageBucketcom o URL do seu bucket:
API modular da Web
import { initializeApp } from "firebase/app";
import { getStorage } from "firebase/storage";
// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
storageBucket: ''
};
// Initialize Firebase
const app = initializeApp(firebaseConfig);
// Initialize Cloud Storage and get a reference to the service
const storage = getStorage(app);
API com namespace da Web
import firebase from "firebase/app";
import "firebase/compat/storage";
// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
storageBucket: '[your-storage-bucket-url]'
};
// Initialize Firebase
firebase.initializeApp(firebaseConfig);
// Initialize Cloud Storage and get a reference to the service
const storage = firebase.storage();
Você está pronto para começar a usar o Cloud Storage!
Próxima Etapa? Saiba como criar uma referência do Cloud Storage .
Configuração avançada
Existem alguns casos de uso que requerem configuração adicional:
- Como usar buckets do Cloud Storage em várias regiões geográficas
- Como usar buckets do Cloud Storage em diferentes classes de armazenamento
- Usar buckets do Cloud Storage com vários usuários autenticados no mesmo aplicativo
O primeiro caso de uso é perfeito se você tiver usuários em todo o mundo e quiser armazenar seus dados perto deles. Por exemplo, você pode criar buckets nos EUA, Europa e Ásia para armazenar dados de usuários nessas regiões para reduzir a latência.
O segundo caso de uso é útil se você tiver dados com padrões de acesso diferentes. Por exemplo: você pode configurar um bucket multirregional ou regional que armazene imagens ou outro conteúdo acessado com frequência e um bucket nearline ou coldline que armazene backups de usuários ou outro conteúdo acessado com pouca frequência.
Em qualquer um desses casos de uso, convém usar vários buckets do Cloud Storage .
O terceiro caso de uso é útil se você estiver criando um aplicativo, como o Google Drive, que permite aos usuários ter várias contas conectadas (por exemplo, uma conta pessoal e uma conta de trabalho). Você pode usar uma instância personalizada do aplicativo Firebase para autenticar cada conta adicional.
Use vários buckets do Cloud Storage
Se você quiser usar um bucket do Cloud Storage diferente do padrão fornecido acima ou usar vários buckets do Cloud Storage em um único aplicativo, crie uma instância de firebase.storage que faça referência ao seu bucket personalizado:
Web modular API
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");Web namespaced API
// Get a non-default Storage bucket
var storage = firebase.app().storage("gs://my-custom-bucket");Trabalhando com buckets importados
Ao importar um bucket existente do Cloud Storage para o Firebase, você terá que conceder ao Firebase a capacidade de acessar esses arquivos usando a ferramenta gsutil , incluída no SDK do Google Cloud :
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Você pode encontrar o número do seu projeto conforme descrito na introdução aos projetos do Firebase .
Isso não afeta os buckets recém-criados, pois eles têm o controle de acesso padrão definido para permitir o Firebase. Esta é uma medida temporária e será executada automaticamente no futuro.
Use um aplicativo Firebase personalizado
Se você estiver criando um aplicativo mais complicado usando um firebase.app.App personalizado, poderá criar uma instância de firebase.storage.Storage inicializada com esse aplicativo:
Web modular API
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");Web namespaced API
// 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");Próximos passos
Prepare-se para lançar seu aplicativo:
Ative o App Check para ajudar a garantir que apenas seus aplicativos possam acessar seus buckets de armazenamento.
Configure alertas de orçamento para seu projeto no console do Google Cloud.
Monitore o painel de uso e faturamento no console do Firebase para ter uma visão geral do uso do seu projeto em vários serviços do Firebase. Você também pode visitar o painel de uso do Cloud Storage para obter informações de uso mais detalhadas.