Web'de Bulut Depolamayı kullanmaya başlayın

Firebase için Cloud Storage, uygulamalarınızda zengin medya içeriği oluşturmanıza olanak tanıyan, görüntüler ve videolar gibi kullanıcı tarafından oluşturulan içeriği yüklemenize ve paylaşmanıza olanak tanır. Verileriniz, yüksek kullanılabilirliğe ve küresel yedekliğe sahip, eksabayt ölçekli bir nesne depolama çözümü olan bir Google Cloud Storage paketinde depolanır. Firebase için Cloud Storage, bu dosyaları doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanır ve sivilceli ağları kolaylıkla yönetir.

Önkoşullar

Henüz yapmadıysanız, Firebase JS SDK'yı yükleyin ve Firebase'i başlatın .

Varsayılan bir Bulut Depolama paketi oluşturun

1. Firebase konsolunun gezinme bölmesinden Depolama'yı seçin, ardından Başlayın'ı tıklayın.

2. Güvenlik kurallarını kullanarak Bulut Depolama verilerinizin güvenliğini sağlamaya ilişkin mesajları inceleyin. Geliştirme sırasında, herkese açık erişim için kurallarınızı oluşturmayı düşünün.

3. Varsayılan Cloud Storage paketiniz için bir konum seçin.

   • Bu konum ayarı, projenizin varsayılan Google Cloud Platform (GCP) kaynak konumudur . Bu konumun, projenizde, özellikle Cloud Firestore veritabanınız ve App Engine uygulamanız (Cloud Scheduler kullanıyorsanız gereklidir) olmak üzere bir konum ayarı gerektiren GCP hizmetleri için kullanılacağını unutmayın.

   • Bir konum seçemiyorsanız, projenizin zaten bir varsayılan GCP kaynak konumu vardır. Ya proje oluşturma sırasında ya da bir konum ayarı gerektiren başka bir hizmet kurulurken ayarlandı.

   Blaze planındaysanız, her biri kendi konumuna sahip birden fazla paket oluşturabilirsiniz .

4. Bitti'yi tıklayın.

Herkese açık erişimi ayarla

Firebase için Cloud Storage, verilerinizin nasıl yapılandırılması gerektiğini, nasıl dizine eklenmesi gerektiğini ve verilerinizin ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan bildirime dayalı bir kurallar dili sağlar. Varsayılan olarak, Cloud Storage'a okuma ve yazma erişimi kısıtlanmıştır, böylece yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Kimlik Doğrulamayı ayarlamadan başlamak için, genel erişim için kurallarınızı yapılandırabilirsiniz .

Bu, Cloud Storage'ı uygulamanızı kullanmayan kişiler dahil herkese açık hale getirir, bu nedenle kimlik doğrulamayı ayarlarken Cloud Storage'ınızı tekrar kısıtladığınızdan emin olun.

Uygulamanıza paket URL'nizi ekleyin

Henüz dahil edilmemişse, Cloud Storage paket URL'nizi Firebase uygulamanızın yapılandırma nesnesine eklemeniz gerekir.

1. Firebase konsolunda Depolama kontrol panelinize gidin.

2. Dosyalar sekmesini tıklayın, ardından dosya görüntüleyicinin başlığına bakın.

3. URL'yi panonuza kopyalayın. Genellikle project-id .appspot.com .

4. Uygulamanızdaki firebaseConfig nesnenize, paket URL'niz ile storageBucket niteliğini ekleyin:

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

import firebase from "firebase/app";
import "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: '[your-storage-bucket-url]'
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


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

Cloud Storage'ı kullanmaya hazırsınız!

Sonraki adım? Bulut Depolama referansı oluşturmayı öğrenin.

Gelişmiş kurulum

Ek kurulum gerektiren birkaç kullanım durumu vardır:

• Cloud Storage paketlerini birden çok coğrafi bölgede kullanma
• Cloud Storage paketlerini farklı depolama sınıflarında kullanma
• Aynı uygulamada birden çok kimliği doğrulanmış kullanıcıyla Cloud Storage paketleri kullanma

Dünyanın her yerinden kullanıcılarınız varsa ve verilerini yanlarında depolamak istiyorsanız, ilk kullanım durumu mükemmeldir. Örneğin, gecikmeyi azaltmak amacıyla ABD, Avrupa ve Asya'da bu bölgelerdeki kullanıcılar için veri depolamak üzere paketler oluşturabilirsiniz.

Farklı erişim modellerine sahip verileriniz varsa, ikinci kullanım durumu yararlıdır. Örneğin: resimleri veya sık erişilen diğer içerikleri depolayan çok bölgeli veya bölgesel bir grup ve kullanıcı yedeklerini veya seyrek erişilen diğer içerikleri depolayan bir yakın hat veya soğuk hat grubu oluşturabilirsiniz.

Bu kullanım durumlarından herhangi birinde, birden çok Cloud Storage paketi kullanmak isteyeceksiniz.

Üçüncü kullanım örneği, Google Drive gibi, kullanıcıların birden fazla oturum açmış hesaba (örneğin, kişisel bir hesap ve bir iş hesabı) sahip olmasına olanak tanıyan bir uygulama oluşturuyorsanız kullanışlıdır. Her ek hesabın kimliğini doğrulamak için özel bir Firebase Uygulaması örneği kullanabilirsiniz.

Birden çok Cloud Storage paketi kullanın

Yukarıda sağlanan varsayılandan farklı bir Cloud Storage paketi kullanmak veya tek bir uygulamada birden fazla Cloud Storage paketi kullanmak istiyorsanız, özel paketinize başvuran bir firebase.storage örneği oluşturabilirsiniz:

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

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

İçe aktarılan paketlerle çalışma

Mevcut bir Bulut Depolama paketini Firebase'e aktarırken, Google Cloud SDK'da bulunan gsutil aracını kullanarak Firebase'e bu dosyalara erişme yeteneği vermeniz gerekir:

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

Proje numaranızı Firebase projelerine giriş bölümünde açıklandığı şekilde bulabilirsiniz.

Firebase'e izin vermek için varsayılan erişim kontrolüne sahip olduklarından, bu yeni oluşturulan paketleri etkilemez. Bu geçici bir önlemdir ve gelecekte otomatik olarak gerçekleştirilecektir.

Özel bir Firebase Uygulaması kullanın

Özel bir firebase.app.App kullanarak daha karmaşık bir uygulama oluşturuyorsanız, o uygulamayla başlatılan bir firebase.storage.Storage örneği oluşturabilirsiniz:

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

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

Sonraki adımlar

• Uygulamanızı başlatmaya hazırlanın:

  • Yalnızca uygulamalarınızın depolama paketlerinize erişebildiğinden emin olmak için Uygulama Kontrolünü etkinleştirin.

  • Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.

  • Projenizin birden fazla Firebase hizmetinde kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma panosunu izleyin. Daha ayrıntılı kullanım bilgileri için Bulut Depolama Kullanımı panosunu da ziyaret edebilirsiniz.

  • Firebase başlatma kontrol listesini inceleyin.

Firebase için Cloud Storage, uygulamalarınızda zengin medya içeriği oluşturmanıza olanak tanıyan, görüntüler ve videolar gibi kullanıcı tarafından oluşturulan içeriği yüklemenize ve paylaşmanıza olanak tanır. Verileriniz, yüksek kullanılabilirliğe ve küresel yedekliğe sahip, eksabayt ölçekli bir nesne depolama çözümü olan bir Google Cloud Storage paketinde depolanır. Firebase için Cloud Storage, bu dosyaları doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanır ve sivilceli ağları kolaylıkla yönetir.

Önkoşullar

Henüz yapmadıysanız, Firebase JS SDK'yı yükleyin ve Firebase'i başlatın .

Varsayılan bir Bulut Depolama paketi oluşturun

1. Firebase konsolunun gezinme bölmesinden Depolama'yı seçin, ardından Başlayın'ı tıklayın.

2. Güvenlik kurallarını kullanarak Bulut Depolama verilerinizin güvenliğini sağlamaya ilişkin mesajları inceleyin. Geliştirme sırasında, herkese açık erişim için kurallarınızı oluşturmayı düşünün.

3. Varsayılan Cloud Storage paketiniz için bir konum seçin.

   • Bu konum ayarı, projenizin varsayılan Google Cloud Platform (GCP) kaynak konumudur . Bu konumun, projenizde, özellikle Cloud Firestore veritabanınız ve App Engine uygulamanız (Cloud Scheduler kullanıyorsanız gereklidir) olmak üzere bir konum ayarı gerektiren GCP hizmetleri için kullanılacağını unutmayın.

   • Bir konum seçemiyorsanız, projenizin zaten bir varsayılan GCP kaynak konumu vardır. Ya proje oluşturma sırasında ya da bir konum ayarı gerektiren başka bir hizmet kurulurken ayarlandı.

   Blaze planındaysanız, her biri kendi konumuna sahip birden fazla paket oluşturabilirsiniz .

4. Bitti'yi tıklayın.

Herkese açık erişimi ayarla

Firebase için Cloud Storage, verilerinizin nasıl yapılandırılması gerektiğini, nasıl dizine eklenmesi gerektiğini ve verilerinizin ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan bildirime dayalı bir kurallar dili sağlar. Varsayılan olarak, Cloud Storage'a okuma ve yazma erişimi kısıtlanmıştır, böylece yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Kimlik Doğrulamayı ayarlamadan başlamak için, genel erişim için kurallarınızı yapılandırabilirsiniz .

Bu, Cloud Storage'ı uygulamanızı kullanmayan kişiler dahil herkese açık hale getirir, bu nedenle kimlik doğrulamayı ayarlarken Cloud Storage'ınızı tekrar kısıtladığınızdan emin olun.

Uygulamanıza paket URL'nizi ekleyin

Henüz dahil edilmemişse, Cloud Storage paket URL'nizi Firebase uygulamanızın yapılandırma nesnesine eklemeniz gerekir.

1. Firebase konsolunda Depolama kontrol panelinize gidin.

2. Dosyalar sekmesini tıklayın, ardından dosya görüntüleyicinin başlığına bakın.

3. URL'yi panonuza kopyalayın. Genellikle project-id .appspot.com .

4. Uygulamanızdaki firebaseConfig nesnenize, paket URL'niz ile storageBucket niteliğini ekleyin:

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

import firebase from "firebase/app";
import "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: '[your-storage-bucket-url]'
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


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

Cloud Storage'ı kullanmaya hazırsınız!

Sonraki adım? Bulut Depolama referansı oluşturmayı öğrenin.

Gelişmiş kurulum

Ek kurulum gerektiren birkaç kullanım durumu vardır:

• Cloud Storage paketlerini birden çok coğrafi bölgede kullanma
• Cloud Storage paketlerini farklı depolama sınıflarında kullanma
• Aynı uygulamada birden çok kimliği doğrulanmış kullanıcıyla Cloud Storage paketleri kullanma

Dünyanın her yerinden kullanıcılarınız varsa ve verilerini yanlarında depolamak istiyorsanız, ilk kullanım durumu mükemmeldir. Örneğin, gecikmeyi azaltmak amacıyla ABD, Avrupa ve Asya'da bu bölgelerdeki kullanıcılar için veri depolamak üzere paketler oluşturabilirsiniz.

Farklı erişim modellerine sahip verileriniz varsa, ikinci kullanım durumu yararlıdır. Örneğin: resimleri veya sık erişilen diğer içerikleri depolayan çok bölgeli veya bölgesel bir grup ve kullanıcı yedeklerini veya seyrek erişilen diğer içerikleri depolayan bir yakın hat veya soğuk hat grubu oluşturabilirsiniz.

Bu kullanım durumlarından herhangi birinde, birden çok Cloud Storage paketi kullanmak isteyeceksiniz.

Üçüncü kullanım örneği, Google Drive gibi, kullanıcıların birden fazla oturum açmış hesaba (örneğin, kişisel bir hesap ve bir iş hesabı) sahip olmasına olanak tanıyan bir uygulama oluşturuyorsanız kullanışlıdır. Her ek hesabın kimliğini doğrulamak için özel bir Firebase Uygulaması örneği kullanabilirsiniz.

Birden çok Cloud Storage paketi kullanın

Yukarıda sağlanan varsayılandan farklı bir Cloud Storage paketi kullanmak veya tek bir uygulamada birden fazla Cloud Storage paketi kullanmak istiyorsanız, özel paketinize başvuran bir firebase.storage örneği oluşturabilirsiniz:

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

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

İçe aktarılan paketlerle çalışma

Mevcut bir Bulut Depolama paketini Firebase'e aktarırken, Google Cloud SDK'da bulunan gsutil aracını kullanarak Firebase'e bu dosyalara erişme yeteneği vermeniz gerekir:

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

Proje numaranızı Firebase projelerine giriş bölümünde açıklandığı şekilde bulabilirsiniz.

Firebase'e izin vermek için varsayılan erişim kontrolüne sahip olduklarından, bu yeni oluşturulan paketleri etkilemez. Bu geçici bir önlemdir ve gelecekte otomatik olarak gerçekleştirilecektir.

Özel bir Firebase Uygulaması kullanın

Özel bir firebase.app.App kullanarak daha karmaşık bir uygulama oluşturuyorsanız, o uygulamayla başlatılan bir firebase.storage.Storage örneği oluşturabilirsiniz:

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

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

Sonraki adımlar

• Uygulamanızı başlatmaya hazırlanın:

  • Yalnızca uygulamalarınızın depolama paketlerinize erişebildiğinden emin olmak için Uygulama Kontrolünü etkinleştirin.

  • Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.

  • Projenizin birden fazla Firebase hizmetinde kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma panosunu izleyin. Daha ayrıntılı kullanım bilgileri için Bulut Depolama Kullanımı panosunu da ziyaret edebilirsiniz.

  • Firebase başlatma kontrol listesini inceleyin.