Comienza a usar Cloud Storage en la Web

Cloud Storage for Firebase te permite subir y compartir contenido generado por usuarios, como imágenes y videos, lo que te permite integrar contenido de rich media en tus apps. Los datos se almacenan en un bucket de Google Cloud Storage, una solución de almacenamiento de objetos a escala de exabytes con alta disponibilidad y redundancia global. Cloud Storage for Firebase te permite subir de forma segura estos archivos directamente desde dispositivos móviles y navegadores web, además de administrar las redes irregulares con facilidad.

Requisitos previos

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

Crea un bucket predeterminado de Cloud Storage

En el panel de navegación de la consola de Firebase, selecciona Storage y, luego, haz clic en Comenzar.
Revisa el mensaje sobre proteger tus datos de Cloud Storage con reglas de seguridad. Durante el desarrollo, te recomendamos que configures reglas para el acceso público.
Selecciona una ubicación para el bucket predeterminado de Cloud Storage.
- Esta configuración es la ubicación predeterminada de los recursos de Google Cloud Platform (GCP) del proyecto. Ten en cuenta que esta ubicación se usará para los servicios de GCP en tu proyecto, que requieran una configuración de ubicación, específicamente tu base de datos Cloud Firestore base de datos de y tu app de App Engine (obligatorio si usas Cloud Scheduler).
- Si no puedes seleccionar una ubicación, el proyecto ya tiene una ubicación predeterminada para los recursos de GCP. Esta se definió durante la creación del proyecto o cuando configuraste otro servicio que requería una configuración de ubicación.
Si usas el plan Blaze, puedes crear varios buckets, cada uno con su propia ubicación.
Advertencia: Una vez que configures la ubicación predeterminada de los recursos de GCP del proyecto, no podrás cambiarla.
Haz clic en Listo.

Configura el acceso público

Cloud Storage for Firebase proporciona un lenguaje de reglas declarativas que te permite definir cómo se deben estructurar los datos, cómo se deben indexar y cuándo se pueden leer y escribir. Según la configuración predeterminada, se restringe el acceso de lectura y escritura a Cloud Storage, por lo que solo los usuarios autenticados pueden leer o escribir datos. Para comenzar sin configurar Authentication , puedes configurar tus reglas para el acceso público.

Esto hace que Cloud Storage esté abierto para todo el mundo, incluso las personas que no usan tu app, por lo que asegúrate de restringir nuevamente tu Cloud Storage cuando configures la autenticación.

Agrega la URL del bucket a tu app

Si aún no está incluida, debes agregar la URL del bucket de Cloud Storage al tu objeto de configuración de la app de Firebase.

Ve a tu panel de Storage en la consola de Firebase.
Haz clic en la pestaña Archivos y, luego, busca en el encabezado del visor de archivos.
Copia la URL al portapapeles. Por lo general, tiene el formato project-id.appspot.com.
Agrega el atributo storageBucket con la URL del bucket al objeto firebaseConfig de tu app de la siguiente manera:

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);

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();

Ya puedes comenzar a usar Cloud Storage

Paso siguiente: Más información para crear una referencia de Cloud Storage.

Configuración avanzada

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

Usar buckets de Cloud Storage en varias regiones geográficas
Usar buckets de Cloud Storage en diferentes clases de almacenamiento
Usar buckets de Cloud Storage con varios usuarios autenticados en la misma app

El primer caso de uso es perfecto si tienes usuarios en todo el mundo y quieres almacenar sus datos cerca de ellos. Por ejemplo, puedes crear buckets en EE.UU., Europa y Asia para almacenar datos de usuarios de esas regiones, a fin de reducir la latencia.

El segundo caso de uso es útil si tienes datos con diferentes patrones de acceso. Por ejemplo, puedes configurar un bucket regional o multirregional que almacene fotos o cualquier tipo de contenido al que se accede con frecuencia y, por otro lado, un bucket de Nearline o Coldline que almacene copias de seguridad de usuarios y otros tipos de contenido a los que se accede con poca frecuencia.

En ambos casos, te recomendamos usar varios buckets de Cloud Storage.

El tercer caso práctico es útil si estás creando una app, como Google Drive, que permite a los usuarios acceder con varias cuentas (por ejemplo, una cuenta personal y una de trabajo). Puedes usar una instancia de app de Firebase personalizada para autenticar cada cuenta adicional.

Usar varios buckets de Cloud Storage

Si quieres usar un bucket de Cloud Storage distinto del predeterminado que se describió anteriormente, o usas varios buckets de Cloud Storage en una sola app, puedes crear una instancia de firebase.storage que hace referencia a tu bucket personalizado:

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

Web

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

Trabaja con buckets importados

Cuando importes un bucket existente de Cloud Storage a Firebase, deberás permitir que Firebase acceda a estos archivos con la herramienta gsutil que se incluye 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>

Para encontrar el número de tu proyecto, sigue las instrucciones que se describen en la introducción a los proyectos de Firebase.

Esta acción no influye en los buckets creados recientemente, ya que el control de acceso predeterminado permite el acceso de Firebase. Esta es una medida temporal y se ejecutará de forma automática en el futuro.

Usa una app de Firebase personalizada

Si estás creando una app más compleja con una firebase.app.App personalizada, puedes crear una instancia de firebase.storage.Storage que se inicialice con la app:

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

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óximos pasos

Prepárate para iniciar tu app:
- Habilita App Check para garantizar que solo tus apps pueden acceder a los buckets de almacenamiento.
- Establece alertas de presupuesto para tu proyecto en la consola de Google Cloud.
- Supervisa el panel Uso y facturación en la consola de Firebase para obtener un panorama general del uso de tu proyecto en varios servicios de Firebase. También puedes visitar el panel Uso de Cloud Storage para obtener información de uso más detallada.
- Revisa la Lista de tareas para el lanzamiento de Firebase.