Check out what’s new from Firebase at Google I/O 2022. Learn more

Zacznij korzystać z Cloud Storage w sieci

Cloud Storage dla Firebase umożliwia przesyłanie i udostępnianie treści generowanych przez użytkowników, takich jak obrazy i filmy, co pozwala na tworzenie treści multimedialnych w aplikacjach. Twoje dane są przechowywane w zasobniku Google Cloud Storage — rozwiązaniu obiektowej pamięci masowej o skali eksabajta o wysokiej dostępności i globalnej nadmiarowości. 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 niestabilne sieci.

Warunki wstępne

Dodaj i skonfiguruj pakiet Firebase SDK w swojej aplikacji.

Utwórz domyślny zasobnik Cloud Storage

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

  2. Zapoznaj się z komunikatem o zabezpieczaniu danych w Cloud Storage za pomocą reguł zabezpieczeń. Podczas opracowywania rozważ skonfigurowanie reguł publicznego dostępu .

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

    • To ustawienie lokalizacji to domyślna lokalizacja zasobu Twojego projektu w Google Cloud Platform (GCP) . 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 bazy danych Cloud Firestore i aplikacji App Engine (co jest wymagane, jeśli używasz Cloud Scheduler).

    • Jeśli nie możesz wybrać lokalizacji, oznacza to, że Twój projekt ma już domyślną lokalizację zasobów GCP. Zostało to ustawione albo podczas tworzenia projektu, albo 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 dla Firebase udostępnia deklaratywny język reguł, który umożliwia zdefiniowanie struktury danych, sposobu ich indeksowania oraz czasu odczytywania i zapisywania danych. 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 .

Dzięki temu Cloud Storage jest dostępny 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 jest jeszcze uwzględniony, musisz dodać adres URL swojego zasobnika Cloud Storage do obiektu konfiguracyjnego aplikacji Firebase .

  1. Przejdź do panelu pamięci w konsoli Firebase .

  2. Kliknij kartę Pliki , a następnie spójrz w nagłówek 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:

    Web version 9

    import { initializeApp } from "firebase/app";
    import { getStorage } from "firebase/storage";
    
    // Set the configuration for your app
    // TODO: Replace with your app's config object
    const firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    const firebaseApp = initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    const storage = getStorage(firebaseApp);

    Web version 8

    // Set the configuration for your app
    // TODO: Replace with your app's config object
    var firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    firebase.initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    var 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. Możesz na przykład utworzyć zasobniki w Stanach Zjednoczonych, Europie i Azji, aby przechowywać dane użytkowników w tych regionach, aby skrócić czas oczekiwania.

Drugi przypadek użycia jest pomocny, jeśli masz dane o różnych wzorcach dostępu. Na przykład: możesz skonfigurować wieloregionalny lub regionalny zasobnik, który przechowuje zdjęcia lub inną często dostępną zawartość, oraz zasobnik nearline lub coldline, który przechowuje kopie zapasowe użytkowników lub inne rzadko używane treści.

W każdym z tych przypadków użyj wielu 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 wiele kont (na przykład konto osobiste i konto służbowe). Do uwierzytelnienia każdego dodatkowego konta możesz użyć niestandardowej instancji aplikacji Firebase .

Użyj wielu zasobników Cloud Storage

Jeśli chcesz użyć zasobnika Cloud Storage innego niż domyślny 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 Twojego niestandardowego zasobnika:

Web version 9

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 version 8

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

Praca z importowanymi zasobnikami

Podczas importowania istniejącego zasobnika Cloud Storage do Firebase musisz przyznać Firebase możliwość dostępu 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 swojego projektu znajdziesz zgodnie z opisem we wprowadzeniu do projektów Firebase .

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

Użyj niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację przy użyciu niestandardowej usługi firebase.app.App , możesz utworzyć instancję firebase.storage.Storage zainicjowaną za pomocą tej aplikacji:

Web version 9

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 version 8

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

Następne kroki