Erste Schritte mit Cloud Storage im Web

Mit Cloud Storage for Firebase können Sie von Nutzern erstellte Inhalte wie Bilder und Videos hochladen und teilen, um Ihre Apps mit Rich-Media-Inhalten zu ergänzen. Ihre Daten werden in einem Google Cloud Storage-Bucket gespeichert, einer Objektspeicherlösung im Exabyte-Maßstab mit hoher Verfügbarkeit und globaler Redundanz. Mit Cloud Storage for Firebase können Sie diese Dateien sicher hochladen von Mobilgeräten und Webbrowsern direkt übertragen. Komfort zu bieten.

Vorbereitung

Falls noch nicht geschehen, installieren Sie das Firebase JS SDK und initialisieren Sie Firebase.

Standard-Cloud Storage-Bucket erstellen

  1. Wählen Sie im Navigationsbereich der Firebase-Konsole Speicher aus. Klicken Sie dann auf Jetzt starten.

  2. Lesen Sie die Mitteilungen zum Schutz Ihrer Cloud Storage-Daten mithilfe der Sicherheitsfunktionen Regeln. Berücksichtigen Sie bei der Entwicklung Festlegen der Regeln für den öffentlichen Zugriff

  3. Wählen Sie einen Standort als Standardspeicherort aus. Cloud Storage Bucket.

    • Diese Standorteinstellung ist der standardmäßige Ressourcenstandort der Google Cloud Platform (GCP) für Ihr Projekt. Beachten Sie, dass dieser Speicherort für GCP-Dienste in Ihrem Projekt verwendet wird die eine Standorteinstellung erfordern, Cloud Firestore-Datenbank und Ihre App Engine App (Dies ist erforderlich, wenn Sie Cloud Scheduler verwenden.)

    • Wenn Sie keinen Speicherort auswählen können, verfügt Ihr Projekt bereits über einen standardmäßigen Speicherort für GCP-Ressourcen. Er wurde entweder während der Erstellung des Projekts oder beim Einrichten eines anderen Dienstes festgelegt, für den eine Speicherorteinstellung erforderlich ist.

    Wenn Sie den Tarif „Blaze“ nutzen, können Sie Erstellen Sie mehrere Buckets mit jeweils einem eigenen Bucket. location fest.

  4. Klicken Sie auf Fertig.

Öffentlichen Zugriff einrichten

Cloud Storage for Firebase bietet eine deklarative Regelsprache, mit der Sie um zu definieren, wie Ihre Daten strukturiert, wie sie indexiert werden und wann aus denen Ihre Daten gelesen und geschrieben werden können. Standardmäßig ist Lese- und Schreibzugriff auf Cloud Storage ist eingeschränkt, sodass nur authentifizierte Nutzer Lese- oder Schreibrechte haben Daten. Wenn Sie Authentication nicht einrichten möchten, können Sie konfigurieren Sie Ihre Regeln für den öffentlichen Zugriff.

Dadurch wird Cloud Storage für jeden zugänglich, auch für Personen, die nicht dein App, also achte bei der Einrichtung darauf, dass du deine Cloud Storage wieder einschränkst Authentifizierung.

Bucket-URL zur App hinzufügen

Wenn sie noch nicht enthalten ist, müssen Sie Ihre Cloud Storage-Bucket-URL zu Ihr Konfigurationsobjekt der Firebase-App.

  1. Rufen Sie in der Firebase Console Ihr Speicher-Dashboard auf.

  2. Klicken Sie auf den Tab Dateien und sehen Sie in der Kopfzeile des Dateibetrachters nach.

  3. Kopieren Sie die URL in die Zwischenablage. Sie liegt normalerweise in der Form project-id.appspot.com

  4. Fügen Sie dem firebaseConfig-Objekt in Ihrer App das storageBucket-Attribut mit Ihrer Bucket-URL hinzu:

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

Sie können Cloud Storage jetzt verwenden.

Nächster Schritt? Weitere Informationen zum Erstellen eines Cloud Storage Referenz.

Erweiterte Einrichtung

Einige Anwendungsfälle erfordern eine zusätzliche Einrichtung:

  • Cloud Storage Buckets werden verwendet in mehrere Regionen
  • Cloud Storage Buckets werden verwendet in verschiedenen Speicherklassen
  • Cloud Storage-Buckets mit mehreren authentifizierten Nutzern in derselben Anwendung verwenden

Der erste Anwendungsfall ist perfekt, wenn Sie Nutzende auf der ganzen Welt haben und ihre Daten in ihrer Nähe speichern. Sie können beispielsweise Buckets in den USA, Europa und Asien erstellen, um Daten für Nutzer in diesen Regionen zu speichern und so die Latenz zu reduzieren.

Der zweite Anwendungsfall ist hilfreich, wenn Sie Daten mit unterschiedlichen Zugriffsmustern haben. Sie können beispielsweise einen multiregionalen oder regionalen Bucket einrichten, in dem Bilder oder andere Inhalte, auf die häufig zugegriffen wird, sowie ein Nearline- oder Coldline-Bucket zur Speicherung von Nutzersicherungen oder anderen Inhalten, auf die selten zugegriffen wird.

In beiden Fällen sollten Sie mehrere Cloud Storage-Buckets verwenden.

Der dritte Anwendungsfall ist nützlich, wenn Sie eine App wie Google Drive erstellen, Nutzer haben mehrere angemeldete Konten, z. B. ein privates Konto. und einem Arbeitskonto). Sie können eine benutzerdefinierte Firebase App-Instanz verwenden, um jedes zusätzliche Konto zu authentifizieren.

Mehrere Cloud Storage-Buckets verwenden

Wenn Sie einen anderen Cloud Storage-Bucket als den oben angegebenen Standard verwenden möchten, gehen Sie so vor: oder mehrere Cloud Storage-Buckets in einer einzigen Anwendung verwenden, können Sie eine Instanz erstellen, von firebase.storage, die auf Ihren benutzerdefinierten Bucket verweisen:

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

Mit importierten Buckets arbeiten

Wenn Sie einen vorhandenen Cloud Storage-Bucket in Firebase importieren, Firebase den Zugriff auf diese Dateien über die gsutil-Tool, das im Google Cloud SDK:

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

Sie finden Ihre Projektnummer wie in der Einführung in Firebase-Projekte beschrieben.

Dies wirkt sich nicht auf neu erstellte Buckets aus, da diese den Standardzugriff haben Steuerelement zum Zulassen von Firebase festgelegt. Dies ist eine vorübergehende Maßnahme, künftig automatisch durchgeführt.

Benutzerdefinierte Firebase-App verwenden

Wenn du eine kompliziertere App mit einer benutzerdefinierten firebase.app.App entwickelst, kann eine firebase.storage.Storage-Instanz erstellen, die mit dieser Anwendung initialisiert wurde:

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

Nächste Schritte