Catch up on highlights from Firebase at Google I/O 2023. Learn more

Zacznij korzystać z Cloud Storage w sieci

Cloud Storage dla Firebase umożliwia przesyłanie i udostępnianie treści tworzonych przez użytkowników, takich jak obrazy i wideo, co pozwala na wbudowanie treści multimedialnych do aplikacji. Twoje dane są przechowywane w zasobniku Google Cloud Storage — rozwiązaniu obiektowej pamięci masowej o skali eksabajtów, charakteryzującym się wysoką dostępnością i globalną redundancją. Cloud Storage dla Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, z łatwością obsługując nieregularne sieci.

Wymagania wstępne

Jeśli jeszcze tego nie zrobiłeś, zainstaluj Firebase JS SDK i zainicjuj Firebase .

Utwórz domyślny zasobnik Cloud Storage

  1. W panelu nawigacyjnym konsoli Firebase wybierz Pamięć , a następnie kliknij Rozpocznij .

  2. Zapoznaj się z komunikatem dotyczącym zabezpieczania danych Cloud Storage przy użyciu reguł bezpieczeństwa. Podczas opracowywania rozważ skonfigurowanie reguł publicznego dostępu .

  3. Wybierz lokalizację domyślnego zasobnika Cloud Storage.

    • To ustawienie lokalizacji jest domyślną lokalizacją zasobu Google Cloud Platform (GCP) Twojego projektu . Pamiętaj, że ta lokalizacja będzie używana w usługach GCP w Twoim projekcie, które wymagają ustawienia lokalizacji, w szczególności w bazie danych Cloud Firestore i aplikacji App Engine (która jest wymagana, jeśli korzystasz z Cloud Scheduler).

    • Jeśli nie możesz wybrać lokalizacji, Twój projekt ma już domyślną lokalizację zasobów GCP. Została ustawiona podczas tworzenia projektu lub podczas konfigurowania innej usługi, która wymaga ustawienia lokalizacji.

    Jeśli korzystasz z planu Blaze, możesz utworzyć wiele zasobników , każdy z własną lokalizacją .

  4. Kliknij Gotowe .

Skonfiguruj dostęp publiczny

Cloud Storage for Firebase udostępnia język reguł deklaratywnych, który pozwala określić strukturę danych, sposób ich indeksowania oraz kiedy dane mogą być odczytywane i zapisywane. Domyślnie dostęp do odczytu i zapisu w Cloud Storage jest ograniczony, więc tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać dane. Aby rozpocząć bez konfigurowania uwierzytelniania , możesz skonfigurować reguły dostępu publicznego .

To sprawia, że ​​Cloud Storage jest otwarty dla każdego, nawet dla osób, które nie korzystają z Twojej aplikacji, więc pamiętaj o ponownym ograniczeniu Cloud Storage podczas konfigurowania uwierzytelniania.

Dodaj adres URL zasobnika do swojej aplikacji

Jeśli nie zostało to jeszcze uwzględnione, musisz dodać adres URL zasobnika Cloud Storage do obiektu konfiguracyjnego aplikacji Firebase .

  1. Przejdź do pulpitu nawigacyjnego Storage w konsoli Firebase .

  2. Kliknij kartę Pliki , a następnie zajrzyj do nagłówka przeglądarki plików.

  3. Skopiuj adres URL do schowka. Zwykle ma postać project-id .appspot.com .

  4. Do obiektu firebaseConfig w aplikacji dodaj atrybut storageBucket z adresem URL zasobnika:

Modułowy interfejs API sieci 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);

Internetowy interfejs API z przestrzenią nazw

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

Możesz zacząć korzystać z Cloud Storage!

Następny krok? Dowiedz się, jak utworzyć referencję Cloud Storage .

Ustawienia zaawansowane

Istnieje kilka przypadków użycia, które wymagają dodatkowej konfiguracji:

Pierwszy przypadek użycia jest idealny, jeśli masz użytkowników na całym świecie i chcesz przechowywać ich dane w ich pobliżu. Na przykład możesz tworzyć zasobniki w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników w tych regionach, aby zmniejszyć opóźnienia.

Drugi przypadek użycia jest przydatny, jeśli masz dane o różnych wzorcach dostępu. Na przykład: możesz skonfigurować wieloregionalny lub regionalny zasobnik, w którym są przechowywane obrazy lub inne często używane treści, oraz zasobnik typu nearline lub coldline, w którym są przechowywane kopie zapasowe użytkowników lub inne rzadko używane treści.

W każdym z tych przypadków będziesz chciał użyć wielu zasobników Cloud Storage .

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która pozwala użytkownikom mieć wiele zalogowanych kont (na przykład konto osobiste i konto służbowe). Możesz użyć niestandardowej instancji aplikacji Firebase do uwierzytelnienia każdego dodatkowego konta.

Używaj wielu zasobników Cloud Storage

Jeśli chcesz używać zasobnika Cloud Storage innego niż domyślny zasobnik podany powyżej lub użyć wielu zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję firebase.storage , która odwołuje się do zasobnika niestandardowego:

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

Praca z importowanymi zasobnikami

Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz zezwolić Firebase na dostęp do tych plików za pomocą narzędzia gsutil zawartego w pakiecie Google Cloud SDK :

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

Numer projektu znajdziesz w sposób opisany we wstępie do projektów Firebase .

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślną kontrolę dostępu ustawioną na zezwalanie na Firebase. Jest to środek tymczasowy i zostanie wykonany automatycznie w przyszłości.

Użyj niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację za pomocą niestandardowej firebase.app.App , możesz utworzyć instancję firebase.storage.Storage zainicjowaną z tą aplikacją:

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

Następne kroki