Cloud Storage for Firebase, kullanıcı tarafından oluşturulan içerikleri yüklemenize ve paylaşmanıza izin verir. Bu şekilde, reklamlarınıza zengin medya içeriği oluşturabilirsiniz. Böylece, Verileriniz, yüksek kullanılabilirlik ve küresel yedekleme sunan bir exabayt ölçekli nesne depolama çözümü olan Google Cloud Storage paketinde depolanır. Cloud Storage for Firebase, bu dosyaları güvenli bir şekilde yüklemenizi sağlar mobil cihazlardan ve web tarayıcılarından doğrudan erişim sağlayarak sağlayabilir.
Ön koşullar
Henüz yapmadıysanız Firebase JS SDK'yı yükleyin ve Firebase'i başlatın.
Varsayılan Cloud Storage paketi oluştur
Firebase konsolunun gezinme bölmesinde Depolama'yı seçin. ve Başlayın'ı tıklayın.
Güvenliği kullanarak Cloud Storage verilerinizin güvenliğini sağlama hakkındaki mesajı inceleyin kurallar. Geliştirme sırasında kurallarınızı herkese açık erişim için ayarlayabilirsiniz.
Varsayılan Cloud Storage paketiniz için bir konum seçin.
Bu konum ayarı, projenizin varsayılan Google Cloud Platform (GCP) kaynak konumu. Bu konumun, projenizdeki GCP hizmetleri için kullanılacağını unutmayın konum ayarı gerektiren durumlar, özellikle de Cloud Firestore veritabanı ve App Engine uygulaması (Cloud Scheduler kullanıyorsanız bu gereklidir).
Konum seçemiyorsanız projeniz zaten varsayılan bir GCP kaynak konumuna sahip. Bu ayar, proje oluşturma sırasında veya konum ayarı gerektiren başka bir hizmet kurulurken ayarlanmıştır.
Blaze planını kullanıyorsanız her biri kendi konumuna sahip birden fazla paket oluşturabilirsiniz.
Bitti'yi tıklayın.
Herkese açık erişimi ayarlama
Cloud Storage for Firebase, aşağıdakileri yapmanıza olanak tanıyan bildirim temelli bir kural dili sağlar: verilerinizin nasıl yapılandırılacağını, nasıl dizine ekleneceğini ve ne zaman ve yazıya dökülebilir. Varsayılan olarak, Yalnızca kimliği doğrulanmış kullanıcıların okuma veya yazma işlemi yapabilmesi için Cloud Storage kısıtlıdır dışı verilerdir. Authentication'i kurmadan başlamak için: genel erişim için kurallarınızı yapılandırın.
Bu işlem, Cloud Storage hizmetini kullanmayanlar dahil olmak üzere herkese açık hale getirir Bu nedenle, kurulum sırasında Cloud Storage cihazınızı kısıtlamayı unutmayın kimlik doğrulama.
Paket URL'nizi uygulamanıza ekleyin
Dahil edilmemişse Cloud Storage paketinizin URL'sini sizin Firebase uygulamasının yapılandırma nesnesi.
Firebase konsolunda Depolama kontrol panelinize gidin.
Dosyalar sekmesini tıklayın, ardından dosya görüntüleyicinin başlığına bakın.
URL'yi panonuza kopyalayın. Bu form genellikle
project-id.appspot.com
Uygulamanızdaki
firebaseConfig
nesnenizestorageBucket
öğesini ekleyin özelliğini paket URL'nizle ekleyin:
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();
Cloud Storage'ü kullanmaya hazırsınız.
Sonraki adım: Nasıl Cloud Storage oluşturacağınızı öğrenin referans.
Gelişmiş kurulum
Ek kurulum gerektiren birkaç kullanım alanı vardır:
- Şu konumda Cloud Storage paket kullanılıyor: birden fazla coğrafi bölge
- Şu konumda Cloud Storage paket kullanılıyor: farklı depolama sınıfları
- Aynı uygulamada kimliği doğrulanmış birden fazla kullanıcıyla Cloud Storage paketlerini kullanma
Dünyanın dört bir yanında kullanıcılarınız varsa ilk kullanım alanı mükemmeldir. bu verileri yakınlarında saklar. Örneğin, ABD'de paket oluşturabilir, Avrupa ve Asya'da bu bölgelerdeki kullanıcılara ait verileri depolayarak gecikmeyi azaltabilirsiniz.
İkinci kullanım alanı, farklı erişim kalıplarına sahip verileriniz varsa yararlıdır. Örneğin, her mağazanın teklifini içeren çok bölgeli veya bölgesel bir paket resimler, sık erişilen diğer içerikler ve Nearline veya Coldline paketi kullanıcı yedeklerini veya nadiren erişilen diğer içerikleri depolayan uygulamalar.
Bu kullanım alanlarından birinde, birden fazla Cloud Storage paketi kullanın.
Üçüncü kullanım alanı, örneğin Google Drive gibi bir uygulama oluşturuyorsanız kullanışlıdır. Kullanıcıların giriş yapmış birden fazla hesaba (örneğin, kişisel bir hesap) sahip olmasına olanak tanır ve bir iş hesabı). Özel bir Firebase uygulaması kullanabilirsiniz örneğini kontrol edin.
Birden fazla Cloud Storage paketi kullan
Yukarıda sağlanan varsayılandan farklı bir Cloud Storage paketi kullanmak isterseniz:
veya tek bir uygulamada birden fazla Cloud Storage paketi kullanmak istiyorsanız örnek oluşturabilirsiniz
özel paketinize referans veren firebase.storage
arasından:
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");
Web
// Get a non-default Storage bucket var storage = firebase.app().storage("gs://my-custom-bucket");
İçe aktarılan paketlerle çalışma
Mevcut bir Cloud Storage paketini Firebase'e aktarırken Google Cloud SDK'sına dahil olan gsutil
aracını kullanarak Firebase'e bu dosyalara erişme izni 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.
Yeni oluşturulan paketler varsayılan erişime sahip olduğundan bu işlem yeni oluşturulan paketleri etkilemez kontrolü Firebase'e izin verecek şekilde ayarlandı. 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
şu uygulamayla başlatılan bir firebase.storage.Storage
örneğini oluşturabilir:
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");
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");
Sonraki adımlar
Uygulamanızı kullanıma sunmaya hazırlanma:
App Check özelliğini etkinleştirerek yalnızca şunlardan emin olun: uygulamalarınız depolama alanı gruplarınıza erişebilir.
Bütçe ayarlama uyarılar Google Cloud konsolunda projeniz için.
Kullanımı ve faturalandırmayı izleme kontrol paneli projenizin genel durumunu görmek için Firebase konsolunda birden fazla Firebase hizmetinde nasıl kullanıldığını gösterir. İsterseniz Cloud Storage Kullanım sayfasını da ziyaret edebilirsiniz. kontrol paneli ayrıntılı kullanım bilgileridir.
Firebase lansmanı kontrol listesini inceleyin.