Cloud Storage for Firebase به شما امکان میدهد محتوای تولید شده توسط کاربر، مانند تصاویر و ویدیو را آپلود و به اشتراک بگذارید، که به شما امکان میدهد محتوای رسانهای غنی را در برنامههای خود بسازید. دادههای شما در یک سطل Google Cloud Storage - یک راهحل ذخیرهسازی شی در مقیاس اگزابایت با در دسترس بودن بالا و افزونگی جهانی ذخیره میشود. Cloud Storage for Firebase به شما امکان میدهد این فایلها را مستقیماً از دستگاههای تلفن همراه و مرورگرهای وب بهطور ایمن آپلود کنید و به راحتی شبکههای ناقص را مدیریت کنید.
پیش نیازها
اگر قبلاً این کار را نکردهاید، Firebase JS SDK را نصب کرده و Firebase را مقداردهی اولیه کنید .
یک سطل پیشفرض Cloud Storage ایجاد کنید
از صفحه پیمایش کنسول Firebase ، Storage را انتخاب کنید، سپس روی شروع به کار کلیک کنید.
پیامهای مربوط به ایمن کردن دادههای Cloud Storage خود را با استفاده از قوانین امنیتی مرور کنید. در طول توسعه، قوانین خود را برای دسترسی عمومی تنظیم کنید .
مکانی را برای سطل Cloud Storage پیش فرض خود انتخاب کنید.
این تنظیم مکان، مکان منبع پیشفرض Google Cloud Platform (GCP) پروژه شما است. توجه داشته باشید که این مکان برای سرویسهای GCP در پروژه شما استفاده میشود که به تنظیمات مکان نیاز دارند، بهویژه پایگاه داده Cloud Firestore و برنامه App Engine شما (که در صورت استفاده از Cloud Scheduler لازم است).
اگر نمیتوانید مکانی را انتخاب کنید، پروژه شما از قبل دارای یک مکان منبع GCP پیشفرض است. در حین ایجاد پروژه یا هنگام راهاندازی سرویس دیگری که نیاز به تنظیم مکان دارد تنظیم شده است.
اگر در طرح Blaze هستید، میتوانید چندین سطل ایجاد کنید که هر کدام مکان خاص خود را دارند.
روی Done کلیک کنید.
دسترسی عمومی را تنظیم کنید
Cloud Storage for Firebase یک زبان قواعد اعلامی را ارائه می دهد که به شما امکان می دهد نحوه ساختار داده های شما، نحوه نمایه سازی و زمان خواندن و نوشتن داده های شما را تعریف کنید. به طور پیشفرض، دسترسی خواندن و نوشتن به Cloud Storage محدود شده است، بنابراین فقط کاربران تأیید شده میتوانند دادهها را بخوانند یا بنویسند. برای شروع بدون تنظیم Authentication ، می توانید قوانین خود را برای دسترسی عمومی پیکربندی کنید .
این باعث میشود که Cloud Storage برای هر کسی باز شود، حتی افرادی که از برنامه شما استفاده نمیکنند، بنابراین هنگام تنظیم احراز هویت، مطمئن شوید که Cloud Storage خود را دوباره محدود کنید.
URL سطل خود را به برنامه خود اضافه کنید
اگر قبلاً شامل نشده است، باید URL سطل Cloud Storage خود را به شی پیکربندی برنامه Firebase خود اضافه کنید.
به داشبورد Storage خود در کنسول Firebase بروید.
روی زبانه Files کلیک کنید، سپس به سربرگ نمایشگر فایل نگاه کنید.
URL را در کلیپ بورد خود کپی کنید. معمولاً به شکل
project-id .appspot.com
است.به شی
firebaseConfig
در برنامه خود، ویژگیstorageBucket
را با URL سطل خود اضافه کنید:
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 هستید!
مرحله بعدی؟ با نحوه ایجاد یک مرجع Cloud Storage آشنا شوید.
راه اندازی پیشرفته
چند مورد استفاده وجود دارد که نیاز به تنظیمات اضافی دارد:
- استفاده از سطل های Cloud Storage در چندین منطقه جغرافیایی
- استفاده از سطل های Cloud Storage در کلاس های ذخیره سازی مختلف
- استفاده از سطلهای Cloud Storage با چندین کاربر احراز هویت شده در یک برنامه
اولین مورد استفاده اگر کاربرانی در سراسر جهان دارید و می خواهید داده های آنها را در نزدیکی آنها ذخیره کنید، عالی است. برای مثال، میتوانید در ایالات متحده، اروپا و آسیا سطلهایی ایجاد کنید تا دادهها را برای کاربران آن مناطق ذخیره کنید تا تأخیر را کاهش دهید.
مورد دوم اگر داده هایی با الگوهای دسترسی متفاوت دارید مفید است. به عنوان مثال: میتوانید یک سطل چند منطقهای یا منطقهای راهاندازی کنید که تصاویر یا سایر محتوایی که اغلب به آنها دسترسی دارند را ذخیره میکند، و یک سطل نزدیک یا سرد که پشتیبانگیریهای کاربر یا سایر محتوایی که بهندرت به آنها دسترسی دارند را ذخیره میکند.
در هر یک از این موارد استفاده، میخواهید از چند سطل Cloud Storage استفاده کنید .
مورد سوم در صورتی مفید است که در حال ساختن برنامهای مانند Google Drive هستید که به کاربران امکان میدهد چندین حساب وارد شده (به عنوان مثال، یک حساب شخصی و یک حساب کاری) داشته باشند. می توانید از یک نمونه برنامه Firebase سفارشی برای احراز هویت هر حساب اضافی استفاده کنید .
از چند سطل Cloud Storage استفاده کنید
اگر میخواهید از یک سطل Cloud Storage غیر از سطل پیشفرض ارائهشده در بالا استفاده کنید، یا از چند سطل Cloud Storage در یک برنامه استفاده کنید، میتوانید نمونهای از firebase.storage
ایجاد کنید که به سطل سفارشی شما ارجاع دهد:
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");
کار با سطل های وارداتی
هنگام وارد کردن یک سطل Cloud Storage موجود به Firebase، باید به Firebase امکان دسترسی به این فایل ها را با استفاده از ابزار gsutil
موجود در Google Cloud SDK بدهید:
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
می توانید شماره پروژه خود را همانطور که در مقدمه پروژه های Firebase توضیح داده شده است، پیدا کنید.
این روی سطلهای تازه ایجاد شده تأثیری نمیگذارد، زیرا آنها دارای تنظیم پیشفرض کنترل دسترسی برای اجازه دادن به Firebase هستند. این یک اقدام موقت است و در آینده به صورت خودکار انجام خواهد شد.
از یک برنامه Firebase سفارشی استفاده کنید
اگر با استفاده از firebase.app.App
سفارشی برنامه پیچیدهتری میسازید، میتوانید نمونهای از firebase.storage.Storage
که با آن برنامه مقداردهی شده است ایجاد کنید:
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");
مراحل بعدی
برای راه اندازی برنامه خود آماده شوید:
برای اطمینان از اینکه فقط برنامههای شما میتوانند به سطلهای ذخیرهسازی شما دسترسی داشته باشند، App Check فعال کنید.
هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
داشبورد استفاده و صورتحساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید. همچنین میتوانید برای اطلاعات بیشتر در مورد استفاده، از داشبورد استفاده از Cloud Storage دیدن کنید.
چک لیست راه اندازی Firebase را مرور کنید.