Cloud Storage for Firebase, resim ve video gibi kullanıcı tarafından oluşturulan içerikleri yüklemenize ve paylaşmanıza olanak tanır. Böylece uygulamalarınıza zengin medya içerikleri ekleyebilirsiniz. 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ı doğrudan mobil cihazlardan ve web tarayıcılarından güvenli bir şekilde yüklemenize olanak tanır. Böylece, bağlantının zayıf olduğu ağlarda sorun yaşamazsınız.
Başlamadan önce
Henüz yapmadıysanız web uygulamaları için başlangıç kılavuzunu tamamladığınızdan emin olun. Bunlardan bazıları:
Firebase projesi oluşturma.
Web uygulamanızı projeye kaydetme ve Firebase JS SDK'sını ve Firebase yapılandırma nesnenizi uygulamanıza ekleyerek uygulamanızı Firebase'e bağlama.
Firebase projenizin kullandıkça öde Blaze fiyatlandırma planında olduğundan emin olun. Firebase ve Google Cloud'da yeniyseniz 300 ABD doları kredi almaya uygun olup olmadığınızı kontrol edin.
Varsayılan Cloud Storage paketi oluşturma
Firebase konsolunun gezinme bölmesinde Depolama'yı seçin.
Projeniz henüz kullandıkça öde Blaze fiyatlandırma planında değilse projenizi yükseltmeniz istenir.
Başlayın'ı tıklayın.
Varsayılan paketiniz için bir konum seçin.
,US-CENTRAL1
veUS-EAST1
'teki paketler, Google Cloud Storage için "Daima Ücretsiz" katmanından yararlanabilir. Diğer tüm konumlardaki paketler Google Cloud Storage fiyatlandırma ve kullanım kurallarına tabidir.US-WEST1
Dilerseniz daha sonra her biri kendi konumuna sahip birden fazla paket oluşturabilirsiniz.
Varsayılan paketiniz için Firebase Security Rules öğesini yapılandırın. Geliştirme sırasında kurallarınızı herkese açık erişim için ayarlama seçeneğini değerlendirin.
Bitti'yi tıklayın.
Artık paketi Firebase konsolunun Cloud Storage Dosyalar sekmesinde görüntüleyebilirsiniz. Varsayılan paket adı biçiminiz PROJECT_ID.firebasestorage.app
Herkese açık erişimi ayarlama
Cloud Storage for Firebase, verilerinizin nasıl yapılandırılması, nasıl dizine eklenmesi ve ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan açıklayıcı bir kural dili sağlar. Varsayılan olarak, Cloud Storage için okuma ve yazma erişimi kısıtlanır. Böylece yalnızca kimliği doğrulanmış kullanıcılar veri okuyabilir veya yazabilir. Authentication ayarlarını yapmadan başlamak için kurallarınızı herkese açık erişim için yapılandırabilirsiniz.
Bu durumda, Cloud Storage uygulamanızı kullanmayan kullanıcılar da dahil olmak üzere herkese açık hale gelir. Bu nedenle, kimlik doğrulamayı ayarlarken Cloud Storage'nizi tekrar kısıtladığınızdan emin olun.
Cloud Storage JS SDK'sını ekleyin ve Cloud Storage'yi başlatın
JavaScript SDK'sını başlatırken Cloud Storage paket adınızı belirtmeniz gerekir.
Firebase konsolunun Cloud Storage Dosyalar sekmesinde Cloud Storage paket adınızı bulabilirsiniz. Varsayılan paketinizi ne zaman oluşturduğunuza bağlı olarak, paket adı aşağıdaki biçimlerden birinde olur:
(30 Ekim 2024'te veya sonrasındaPROJECT_ID.firebasestorage.app
oluşturulan varsayılan paket) (30 Ekim 2024PROJECT_ID.appspot.com
öncesinde oluşturulan varsayılan paket)
Aşağıdaki kod snippet'ini kullanarak SDK'yı başlatın:
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: 'BUCKET_NAME' }; // 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: 'BUCKET_NAME' }; // 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? Cloud Storage referansı oluşturmayı öğrenin.
Gelişmiş kurulum
Ek kurulum gerektiren birkaç kullanım alanı vardır:
- Birden fazla coğrafi bölgede Cloud Storage paketleri kullanma
- Farklı depolama sınıflarında Cloud Storage paketleri kullanma
- Aynı uygulamada kimliği doğrulanmış birden fazla kullanıcıyla Cloud Storage paketleri kullanma
Dünyanın dört bir yanında kullanıcılarınız varsa ve verilerini yakınlarında depolamak istiyorsanız ilk kullanım alanı mükemmel bir seçimdir. Örneğin, gecikmeyi azaltmak için ABD, Avrupa ve Asya'da bu bölgelerdeki kullanıcılara ait verileri depolamak üzere paketler oluşturabilirsiniz.
Farklı erişim kalıplarına sahip verileriniz varsa ikinci kullanım alanı faydalıdır. Örneğin: Resimleri veya sık erişilen diğer içerikleri depolayan çok bölgeli ya da bölgesel bir paket ve kullanıcı yedeklerini veya sık erişilmeyen diğer içerikleri depolayan yakın satır veya soğuk satır paketi oluşturabilirsiniz.
Bu kullanım alanlarından herhangi birinde birden fazla Cloud Storage paketi kullanmak isteyebilirsiniz.
Üçüncü kullanım alanı, Google Drive gibi kullanıcıların birden fazla oturum açmasına (ör. kişisel hesap ve iş hesabı) olanak tanıyan bir uygulama geliştiriyorsanız kullanışlıdır. Her ek hesabın kimliğini doğrulamak için özel bir Firebase uygulaması örneği kullanabilirsiniz.
Birden fazla Cloud Storage paketi kullanma
Bu kılavuzun önceki bölümlerinde açıklanan varsayılan paket dışında bir Cloud Storage paketi kullanmak veya tek bir uygulamada birden fazla Cloud Storage paketi kullanmak istiyorsanız özel paketinize referans veren bir firebase.storage
örneği oluşturabilirsiniz:
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://BUCKET_NAME
Proje numaranızı Firebase projelerine giriş bölümünde açıklandığı şekilde bulabilirsiniz.
Varsayılan erişim denetimi Firebase'e izin verecek şekilde ayarlandığından bu değişiklik, yeni oluşturulan paketleri etkilemez. Bu geçici bir önlemdir ve gelecekte otomatik olarak gerçekleştirilecektir.
Özel Firebase uygulaması kullanma
Özel bir firebase.app.App
kullanarak daha karmaşık bir uygulama geliştiriyorsanız bu uygulamayla başlatılmış bir firebase.storage.Storage
örneği oluşturabilirsiniz:
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ırlanın:
Depolama alanı gruplarınıza yalnızca uygulamalarınızın erişebilmesi için App Check seçeneğini etkinleştirin.
Google Cloud konsolunda projeniz için bütçe uyarıları ayarlayın.
Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin. Daha ayrıntılı kullanım bilgileri için Cloud Storage Kullanım kontrol panelini de ziyaret edebilirsiniz.
Firebase lansman kontrol listesini inceleyin.