Comience con el almacenamiento en la nube en la web

Cloud Storage para Firebase te permite cargar y compartir contenido generado por el usuario, como imágenes y videos, lo que te permite crear contenido multimedia enriquecido en tus aplicaciones. Sus datos se almacenan en un depósito de Google Cloud Storage , una solución de almacenamiento de objetos a escala de exabytes con alta disponibilidad y redundancia global. Cloud Storage para Firebase le permite cargar estos archivos de forma segura directamente desde dispositivos móviles y navegadores web, manejando redes irregulares con facilidad.

Requisitos previos

Si aún no lo has hecho, instala el SDK de Firebase JS e inicializa Firebase .

Crear un depósito de Cloud Storage predeterminado

  1. En el panel de navegación de Firebase console , selecciona Almacenamiento y luego haz clic en Comenzar .

  2. Revise los mensajes sobre cómo proteger sus datos de Cloud Storage mediante reglas de seguridad. Durante el desarrollo, considere configurar sus reglas para el acceso público .

  3. Seleccione una ubicación para su depósito predeterminado de Cloud Storage.

    • Esta configuración de ubicación es la ubicación de recursos predeterminada de Google Cloud Platform (GCP) de su proyecto. Tenga en cuenta que esta ubicación se usará para los servicios de GCP en su proyecto que requieren una configuración de ubicación, específicamente, su base de datos de Cloud Firestore y su aplicación App Engine (que es necesaria si usa Cloud Scheduler).

    • Si no puedes seleccionar una ubicación, entonces tu proyecto ya tiene una ubicación de recursos de GCP predeterminada. Se configuró durante la creación del proyecto o al configurar otro servicio que requiere una configuración de ubicación.

    Si tiene el plan Blaze, puede crear varios depósitos , cada uno con su propia ubicación .

  4. Haga clic en Listo.

Configurar el acceso público

Cloud Storage para Firebase proporciona un lenguaje de reglas declarativas que le permite definir cómo se deben estructurar los datos, cómo se deben indexar y cuándo se pueden leer y escribir los datos. De forma predeterminada, el acceso de lectura y escritura a Cloud Storage está restringido, por lo que solo los usuarios autenticados pueden leer o escribir datos. Para comenzar sin configurar la autenticación , puede configurar sus reglas para el acceso público .

Esto hace que Cloud Storage esté abierto a cualquier persona, incluso a personas que no usan su aplicación, así que asegúrese de restringir su Cloud Storage nuevamente cuando configure la autenticación.

Agregue la URL de su depósito a su aplicación

Si aún no está incluido, debes agregar la URL de tu depósito de Cloud Storage al objeto de configuración de tu aplicación Firebase .

  1. Vaya a su panel de Almacenamiento en Firebase console .

  2. Haga clic en la pestaña Archivos y luego busque en el encabezado del visor de archivos.

  3. Copie la URL a su portapapeles. Por lo general, tiene el formato project-id .appspot.com .

  4. A su objeto firebaseConfig en su aplicación, agregue el atributo storageBucket con la URL de su depósito:

API modular 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 con espacio de nombres 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();

¡Estás listo para comenzar a usar Cloud Storage!

¿Próximo paso? Aprenda a crear una referencia de Cloud Storage .

Configuración avanzada

Hay algunos casos de uso que requieren configuración adicional:

El primer caso de uso es perfecto si tiene usuarios en todo el mundo y desea almacenar sus datos cerca de ellos. Por ejemplo, puede crear depósitos en EE. UU., Europa y Asia para almacenar datos para los usuarios de esas regiones y reducir la latencia.

El segundo caso de uso es útil si tiene datos con diferentes patrones de acceso. Por ejemplo: puede configurar un depósito multirregional o regional que almacene imágenes u otro contenido al que se accede con frecuencia, y un depósito nearline o coldline que almacene copias de seguridad de los usuarios u otro contenido al que se acceda con poca frecuencia.

En cualquiera de estos casos de uso, querrás utilizar varios depósitos de Cloud Storage .

El tercer caso de uso es útil si está creando una aplicación, como Google Drive, que permite a los usuarios tener varias cuentas iniciadas (por ejemplo, una cuenta personal y una cuenta de trabajo). Puedes usar una instancia personalizada de la aplicación Firebase para autenticar cada cuenta adicional.

Utilice varios depósitos de Cloud Storage

Si deseas usar un depósito de Cloud Storage distinto al predeterminado proporcionado anteriormente, o usar varios depósitos de Cloud Storage en una sola aplicación, puedes crear una instancia de firebase.storage que haga referencia a tu depósito 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");
storage_multiple_buckets.js

Web namespaced API

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

Trabajar con cubos importados

Al importar un depósito de Cloud Storage existente a Firebase, deberá otorgarle a Firebase la capacidad de acceder a estos archivos mediante la herramienta gsutil , incluida en el SDK de Google Cloud :

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

Puede encontrar el número de su proyecto como se describe en la introducción a los proyectos de Firebase .

Esto no afecta a los depósitos recién creados, ya que tienen el control de acceso predeterminado configurado para permitir Firebase. Esta es una medida temporal y se realizará automáticamente en el futuro.

Utilice una aplicación Firebase personalizada

Si estás creando una aplicación más complicada usando una firebase.app.App personalizada, puedes crear una instancia de firebase.storage.Storage inicializada con esa aplicación:

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");
storage_custom_app.js

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");
index.js

Próximos pasos