Wprowadzenie do Cloud Storage w internecie

Cloud Storage for Firebase umożliwia przesyłanie i udostępnianie treści generowanych przez użytkowników, takich jak obrazy i filmy, co pozwala na tworzenie w aplikacjach treści multimedialnych. Twoje dane są przechowywane w zasobniku Google Cloud Storage – rozwiązaniu do przechowywania obiektów o rozmiarze exabajtów z wysoką dostępnością i globalną redundancją. Cloud Storage for Firebase umożliwia bezpieczne przesyłanie tych plików bezpośrednio z urządzeń mobilnych i przeglądarek internetowych, a także sprawne działanie w przypadku niestabilnych sieci.

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobisz, zapoznaj się z przewodnikiem po aplikacjach internetowych. Obejmuje to m.in.:

    • Tworzenie projektu Firebase.

    • Zarejestruj aplikację internetową w projekcie i połącz ją z Firebase, dodając do niej pakiet SDK Firebase JS i obiekt konfiguracji Firebase.

  2. Upewnij się, że Twój projekt Firebase jest objęty abonamentem Blaze (płatność według wykorzystania). Jeśli dopiero zaczynasz korzystać z Firebase i Google Cloud, sprawdź, czy kwalifikujesz się do otrzymania 300 USD w postaci środków.

Tworzenie domyślnego zasobnika Cloud Storage

  1. W panelu nawigacji konsoli Firebase wybierz Miejsce na dane.

    Jeśli Twój projekt nie jest jeszcze objęty cennikiem Blaze, pojawi się prośba o zaktualizowanie projektu.

  2. Kliknij Rozpocznij.

  3. Wybierz lokalizację domyślnego zasobnika.

  4. Skonfiguruj Firebase Security Rules dla zasobnika domyślnego. W trakcie programowania rozważ skonfigurowanie reguł dostępu publicznego.

  5. Kliknij Gotowe.

Możesz teraz wyświetlić zasobnik na karcie Cloud Storage Pliki w konsoli Firebase. Domyślny format nazwy zasobnika to PROJECT_ID.firebasestorage.app.

Konfigurowanie dostępu publicznego

Cloud Storage for Firebase udostępnia język deklaratywny, który pozwala określić, jak dane powinny być ustrukturyzowane, jak powinny być indeksowane oraz kiedy można je odczytywać i zapisywać. Domyślnie dostęp do odczytu i zapisu do Cloud Storage jest ograniczony, więc tylko uwierzytelnieni użytkownicy mogą odczytywać i zapisywać dane. Aby rozpocząć bez konfigurowania Authentication, możesz skonfigurować reguły dostępu publicznego.

W ten sposób Cloud Storage będzie dostępne dla wszystkich, nawet dla osób, które nie korzystają z Twojej aplikacji. Pamiętaj, aby po skonfigurowaniu uwierzytelniania ponownie ograniczyć dostęp do Cloud Storage.

Dodaj pakiet JS SDK Cloud Storage i inicjuj Cloud Storage

Podczas inicjowania pakietu JavaScript SDK musisz podać nazwę zasobnika Cloud Storage.

Nazwa zasobnika Cloud Storage znajduje się na karcie Cloud Storage Pliki konsoli Firebase. W zależności od tego, kiedy utworzono domyślny zasób, jego nazwa będzie miała jeden z tych formatów:

  • PROJECT_ID.firebasestorage.app (domyślny kosz utworzony lub później 30 października 2024 r.)
  • PROJECT_ID.appspot.com (domyślny folder utworzony przed 30 października 2024 r.)

Zainicjuj pakiet SDK, używając tego fragmentu kodu:

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: 'BUCKET_NAME'
};

// 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: 'BUCKET_NAME'
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Cloud Storage and get a reference to the service
const storage = firebase.storage();

Możesz już zacząć używać Cloud Storage.

Co dalej? Dowiedz się, jak utworzyć odwołanie Cloud Storage.

Konfiguracja zaawansowana

Niektóre przypadki użycia 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 pobliżu. Możesz na przykład utworzyć zbiory w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników z tych regionów i w ten sposób zmniejszyć opóźnienia.

Drugi przypadek użycia jest przydatny, jeśli masz dane z różnymi wzorami dostępu. Możesz na przykład skonfigurować zasobnik wieloregionalny lub regionalny, w którym będą przechowywane zdjęcia lub inne często używane treści, oraz zasobnik Nearline lub Coldline, w którym będą przechowywane kopie zapasowe użytkowników lub inne rzadko używane treści.

W obu przypadkach użyj kilku zasobników Cloud Storage.

Trzeci przypadek użycia jest przydatny, jeśli tworzysz aplikację, taką jak Dysk Google, która umożliwia użytkownikom zalogowanie się na kilka kont (np. na konto osobiste i służbowe). Aby uwierzytelniać każde dodatkowe konto, możesz użyć niestandardowej aplikacji Firebase.

Używanie wielu grup Cloud Storage

Jeśli chcesz użyć zasobnika Cloud Storage innego niż domyślny opisany wcześniej w tym przewodniku lub użyć kilku zasobników Cloud Storage w jednej aplikacji, możesz utworzyć instancję firebase.storage, która odwołuje się do niestandardowego zasobnika:

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

Praca z zaimportowanymi zasobnikami

Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz przyznać Firebase uprawnienia dostępu do tych plików za pomocą narzędzia gsutil, które jest częścią pakietu Google Cloud SDK:

gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME

Numer projektu znajdziesz w sposób opisany w wprowadzeniu do projektów Firebase.

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ ich domyślna kontrola dostępu zezwala na korzystanie z Firebase. Jest to środek tymczasowy, który w przyszłości będzie wykonywany automatycznie.

Używanie niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację za pomocą niestandardowego obiektu firebase.app.App, możesz utworzyć instancję obiektu firebase.storage.Storage zainicjalizowanego za pomocą tej aplikacji:

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

Dalsze kroki