Zacznij korzystać z Cloud Storage on Web

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 treści multimedialnych w aplikacjach. Twoje dane są przechowywane w zasobniku Google Cloud Storage - rozwiązaniu do przechowywania obiektów w skali eksabajtów z wysoką dostępnością i globalną nadmiarowością. Cloud Storage for 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 niedziałające sieci.

Wymagania wstępne

Dodaj i skonfiguruj pakiet SDK Firebase w swojej aplikacji.

Utwórz domyślny zasobnik Cloud Storage

W panelu nawigacyjnym konsoli Firebase wybierz Pamięć , a następnie kliknij Rozpocznij .
Zapoznaj się z komunikatem na temat zabezpieczania danych w Cloud Storage za pomocą reguł bezpieczeństwa. Podczas programowania rozważ skonfigurowanie reguł dostępu publicznego .
Wybierz lokalizację dla domyślnego zasobnika Cloud Storage.
- To ustawienie lokalizacji jest domyślną lokalizacją zasobów Google Cloud Platform (GCP) Twojego projektu. Pamiętaj, że ta lokalizacja będzie używana przez usługi GCP w Twoim projekcie, które wymagają ustawienia lokalizacji, w szczególności baza danych Cloud Firestore i aplikacja App Engine (która jest wymagana, jeśli używasz Cloud Scheduler).
- Jeśli nie możesz wybrać lokalizacji, Twój projekt ma już domyślną lokalizację zasobów GCP. Został ustawiony podczas tworzenia projektu lub podczas konfigurowania innej usługi, która wymaga ustawienia lokalizacji.
Jeśli korzystasz z abonamentu Blaze, możesz utworzyć wiele zasobników , każdy z własną lokalizacją .
Ostrzeżenie: po ustawieniu domyślnej lokalizacji zasobów GCP projektu nie można jej zmienić.
Kliknij Gotowe .

Skonfiguruj dostęp publiczny

Cloud Storage for Firebase zapewnia deklaratywny język reguł, który pozwala zdefiniować strukturę danych, sposób ich indeksowania oraz moment, w którym można je odczytywać i zapisywać. 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 używają Twojej aplikacji, więc pamiętaj, aby ponownie ograniczyć przechowywanie w chmurze podczas konfigurowania uwierzytelniania.

Dodaj adres URL swojego zasobnika do swojej aplikacji

Jeśli nie jest jeszcze uwzględniony, musisz dodać adres URL zasobnika Cloud Storage do obiektu konfiguracyjnego aplikacji Firebase .

Przejdź do panelu Storage w konsoli Firebase .
Kliknij kartę Pliki , a następnie spójrz w nagłówek przeglądarki plików.
Skopiuj adres URL do schowka. Zwykle ma postać project-id .appspot.com .

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

Web v8

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

Web v9

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

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

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

Ustawienia zaawansowane

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

Korzystanie z zasobników Cloud Storage w wielu regionach geograficznych
Korzystanie z zasobników Cloud Storage w różnych klasach pamięci
Korzystanie z zasobników Cloud Storage z wieloma uwierzytelnionymi użytkownikami w tej samej aplikacji

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

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

W obu przypadkach 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, aby uwierzytelnić każde dodatkowe konto.

Używaj wielu zasobników Cloud Storage

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

Web v8

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

Web v9

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

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 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 możesz znaleźć zgodnie z opisem we wprowadzeniu do projektów Firebase .

Nie ma to wpływu na nowo utworzone zasobniki, ponieważ mają one domyślnie ustawioną kontrolę dostępu zezwalającą na Firebase. Jest to środek tymczasowy, który w przyszłości zostanie wykonany automatycznie.

Użyj niestandardowej aplikacji Firebase

Jeśli tworzysz bardziej skomplikowaną aplikację przy użyciu niestandardowego firebase.app.App , możesz utworzyć instancję firebase.storage.Storage zainicjowaną przez tę aplikację:

Web v8

// 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

Web v9

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

Następne kroki

Przygotuj się do uruchomienia aplikacji:
- Skonfiguruj alerty dotyczące budżetu dla swojego projektu w Google Cloud Console.
- Monitoruj pulpit nawigacyjny Użycie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase. Można również odwiedzić Wykorzystanie pulpit Cloud Storage Aby uzyskać bardziej szczegółowe informacje na temat użytkowania.
- Przejrzyj listę kontrolną uruchamiania Firebase .