تتيح لك خدمة Cloud Storage for Firebase تحميل محتوى من إنشاء المستخدمين ومشاركته، مثل الصور والفيديوهات، ما يتيح لك إنشاء محتوى من الوسائط التفاعلية المتقدّمة في تطبيقاتك. ويتم تخزين بياناتك في حزمة Google Cloud Storage، وهي عبارة عن حل لتخزين العناصر على نطاق كبير جدًا مع توفّر عالٍ وتكرار على مستوى العالم. تتيح لك خدمة Cloud Storage for Firebase تحميل هذه الملفات بأمان مباشرةً من الأجهزة الجوّالة ومتصفّحات الويب، مع التعامل مع الشبكات غير المستقرة بسهولة.
المتطلّبات الأساسية
ثبِّت حزمة تطوير البرامج (SDK) لـ Firebase JS وابدأ في إعداد Firebase، إذا لم يسبق لك إجراء ذلك.
إنشاء حزمة تلقائية في Cloud Storage
من مساحة الروابط في وحدة تحكُّم Firebase، اختَر مساحة التخزين، ثم انقر على البدء.
راجِع الرسالة المتعلقة بتأمين بيانات Cloud Storage باستخدام قواعد الأمان. أثناء التطوير، يمكنك إعداد قواعد الوصول العام.
اختَر موقعًا جغرافيًا لحزمتك التلقائية في Cloud Storage.
إنّ إعداد الموقع الجغرافي هذا هو الموقع الجغرافي التلقائي لموارد Google Cloud Platform (GCP) لمشروعك. تجدر الإشارة إلى أنّه سيتم استخدام هذا الموقع الجغرافي في خدمات Google Cloud Platform في مشروعك التي تتطلّب ضبط إعدادات الموقع الجغرافي، وتحديدًا قاعدة بيانات Cloud Firestore وتطبيق App Engine (مطلوب في حال استخدام Cloud Scheduler).
إذا لم تتمكّن من اختيار موقع جغرافي، يعني ذلك أنّ مشروعك يحتوي على موقع جغرافي تلقائي لمورد Google Cloud Platform. تم إعداده إما أثناء إنشاء المشروع أو عند إعداد خدمة أخرى تتطلب إعداد الموقع.
إذا كنت مشتركًا في خطة Blaze، يمكنك إنشاء عدة مجموعات بيانات، لكل منها موقعها الجغرافي الخاص.
انقر على تم.
إعداد إتاحة الوصول للجميع
توفّر خدمة Cloud Storage for Firebase لغة قواعد تعريفية تتيح لك تحديد كيفية تنظيم البيانات، وطريقة فهرستها، ومتى يمكن قراءة البيانات منها وكتابتها. وفقًا للإعدادات التلقائية، يكون إذن الوصول للقراءة والكتابة إلى Cloud Storage محظورًا، لذلك لا يمكن لأحد سوى المستخدمين الذين تمت مصادقتهم قراءة البيانات أو كتابتها. للبدء بدون إعداد المصادقة، يمكنك ضبط قواعدك للوصول العام.
يؤدي ذلك إلى إتاحة خدمة Cloud Storage لأي شخص، حتى الأشخاص الذين لا يستخدمون تطبيقك، لذا احرص على تقييد استخدام Cloud Storage مرة أخرى عند إعداد المصادقة.
يُرجى إضافة عنوان URL للحزمة إلى تطبيقك.
إذا لم يتم تضمينه من قبل، يجب إضافة عنوان URL لحزمة Cloud Storage إلى كائن الإعداد في تطبيق Firebase.
انتقِل إلى لوحة بيانات مساحة التخزين في وحدة تحكُّم Firebase.
انقر على علامة التبويب الملفات، ثم ابحث في رأس عارض الملفات.
انسخ عنوان 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");
الخطوات اللاحقة
الاستعداد لإطلاق تطبيقك:
فعِّل ميزة التحقّق من التطبيقات للمساعدة في التأكّد من أنّ تطبيقاتك فقط يمكنها الوصول إلى حِزم التخزين.
إعداد تنبيهات الميزانية لمشروعك في Google Cloud Console
راقِب لوحة بيانات الاستخدام والفوترة في وحدة تحكُّم Firebase للحصول على صورة عامة عن استخدام مشروعك على عدّة خدمات في Firebase. يمكنك أيضًا الانتقال إلى لوحة بيانات استخدام Cloud Storage للاطّلاع على معلومات أكثر تفصيلاً عن الاستخدام.