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 şurada saklanır: Google Cloud Storage paketi — bir yüksek kullanılabilirlik ve global boyut sunan eksabayt ölçekli nesne depolama çözümü İşten çıkarma 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şturun
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ürecinde herkese açık erişim kurallarınızı ayarlama hakkında daha fazla bilgi edinin.
Varsayılan konumunuz için bir konum seçin. Cloud Storage paket.
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. Proje sırasında konum gerektiren başka bir hizmet ayarlarken ayarını değiştirebilirsiniz.
Blaze planını kullanıyorsanız: Her biri kendine ait olan birden fazla paket oluşturun konum.
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 alanı kontrol panelinize gidin.
Dosyalar sekmesini tıklayın ve 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 uygulamasını 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
Firebase'e
gsutil
aracı,
Google Cloud SDK'sı:
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Proje numaranızı projenin Firebase projeleri.
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 çözümdür ve otomatik olarak yapılır.
Ö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. Ayrıca, Cloud Storage Kullanım sayfasını da ziyaret edebilirsiniz. kontrol paneline gidin ayrıntılı kullanım bilgileridir.
Firebase lansmanı kontrol listesini inceleyin.