Cloud Storage for Firebase به شما امکان میدهد محتوای تولید شده توسط کاربر، مانند تصاویر و ویدیو را آپلود و به اشتراک بگذارید، که به شما امکان میدهد محتوای رسانهای غنی را در برنامههای خود بسازید. دادههای شما در یک سطل Google Cloud Storage - یک راهحل ذخیرهسازی شی در مقیاس اگزابایت با در دسترس بودن بالا و افزونگی جهانی ذخیره میشود. Cloud Storage for Firebase به شما امکان میدهد این فایلها را مستقیماً از دستگاههای تلفن همراه و مرورگرهای وب بهطور ایمن آپلود کنید و به راحتی شبکههای ناقص را مدیریت کنید.
قبل از شروع
اگر قبلاً این کار را نکردهاید، مطمئن شوید که راهنمای شروع برنامههای وب را تکمیل کردهاید. این شامل:
ایجاد پروژه Firebase
ثبت برنامه وب خود در پروژه، و اتصال برنامه خود به Firebase با افزودن Firebase JS SDK و شیء پیکربندی Firebase به برنامه شما.
مطمئن شوید که پروژه Firebase شما در برنامه قیمتگذاری Blaze است. اگر در Firebase و Google Cloud تازه کار هستید، بررسی کنید که آیا واجد شرایط دریافت اعتبار 300 دلاری هستید یا خیر.
یک سطل پیشفرض Cloud Storage ایجاد کنید
از صفحه پیمایش کنسول Firebase ، Storage را انتخاب کنید. اگر پروژه شما هنوز در طرح قیمت گذاری Blaze به صورت پرداختی نیست، از شما خواسته می شود پروژه خود را ارتقا دهید. روی Get start کلیک کنید. مکانی را برای سطل پیش فرض خود انتخاب کنید. سطل ها در US-CENTRAL1
،US-EAST1
وUS-WEST1
میتواند از لایه «همیشه رایگان» برای Google Cloud Storage استفاده کند. سطلها در همه مکانهای دیگر از قیمت و استفاده Google Cloud Storage پیروی میکنند.اگر مایل هستید، میتوانید بعداً چندین سطل ایجاد کنید که هر کدام مکان خاص خود را دارند.
Firebase Security Rules برای سطل پیش فرض خود پیکربندی کنید. در طول توسعه، قوانین خود را برای دسترسی عمومی تنظیم کنید . روی Done کلیک کنید.
PROJECT_ID .firebasestorage.app
.
دسترسی عمومی را تنظیم کنید
Cloud Storage JS SDK را اضافه کنید و Cloud Storage مقداردهی اولیه کنید
PROJECT_ID .firebasestorage.app
(سطل پیشفرض ایجاد شده در30 اکتبر 2024 یا بعد از آن )PROJECT_ID .appspot.com
(سطل پیشفرض ایجاد شده قبل از30 اکتبر 2024 )
با استفاده از قطعه کد زیر SDK را راه اندازی کنید:
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);
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 هستید!
مرحله بعدی؟ با نحوه ایجاد یک مرجع Cloud Storage آشنا شوید.
راه اندازی پیشرفته
چند مورد استفاده وجود دارد که نیاز به تنظیمات اضافی دارد:
- استفاده از سطل های Cloud Storage در چندین منطقه جغرافیایی
- استفاده از سطل های Cloud Storage در کلاس های ذخیره سازی مختلف
- استفاده از سطلهای Cloud Storage با چندین کاربر احراز هویت شده در یک برنامه
اولین مورد استفاده اگر کاربرانی در سراسر جهان دارید و می خواهید داده های آنها را در نزدیکی آنها ذخیره کنید، عالی است. به عنوان مثال، میتوانید سطلهایی در ایالات متحده، اروپا و آسیا ایجاد کنید تا دادهها را برای کاربران در آن مناطق ذخیره کنید تا تأخیر را کاهش دهید.
مورد دوم اگر داده هایی با الگوهای دسترسی متفاوت دارید مفید است. به عنوان مثال: میتوانید یک سطل چند منطقهای یا منطقهای راهاندازی کنید که تصاویر یا سایر محتوایی که اغلب به آنها دسترسی دارد را ذخیره میکند، و یک سطل نزدیک یا سرد که پشتیبانگیریهای کاربر یا سایر محتوای غیرقابل دسترسی را ذخیره میکند.
در هر یک از این موارد استفاده، میخواهید از چند سطل Cloud Storage استفاده کنید .
مورد سوم در صورتی مفید است که در حال ساختن برنامهای مانند Google Drive هستید که به کاربران امکان میدهد چندین حساب وارد شده (به عنوان مثال، یک حساب شخصی و یک حساب کاری) داشته باشند. می توانید از یک نمونه برنامه Firebase سفارشی برای احراز هویت هر حساب اضافی استفاده کنید .
از چند سطل Cloud Storage استفاده کنید
اگر میخواهید از یک سطل Cloud Storage غیر از سطل پیشفرض که قبلاً در این راهنما توضیح داده شد استفاده کنید، یا از چندین سطل Cloud Storage در یک برنامه استفاده کنید، میتوانید نمونهای از firebase.storage
ایجاد کنید که به سطل سفارشی شما ارجاع دهد:
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");
// 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://BUCKET_NAME
می توانید شماره پروژه خود را همانطور که در مقدمه پروژه های Firebase توضیح داده شده است، پیدا کنید.
این روی سطلهای تازه ایجاد شده تأثیری نمیگذارد، زیرا آنها دارای تنظیم پیشفرض کنترل دسترسی برای اجازه دادن به Firebase هستند. این یک اقدام موقت است و در آینده به صورت خودکار انجام خواهد شد.
از یک برنامه Firebase سفارشی استفاده کنید
اگر با استفاده از firebase.app.App
سفارشی برنامه پیچیدهتری میسازید، میتوانید نمونهای از firebase.storage.Storage
که با آن برنامه مقداردهی شده است ایجاد کنید:
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");
// 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 را مرور کنید.