Cloud Functions لمنصّة Firebase

Cloud Functions for Firebase هو إطار عمل لا يستخدِم الخادم، ويسمح لك بتشغيل رمز الخلفية تلقائيًا استجابةً للأحداث التي يتم تشغيلها من خلال أحداث الخلفية أو طلبات HTTPS أو وظائف Admin SDK أو Cloud Scheduler. يتم تخزين رمز JavaScript أو TypeScript أو Python على بنية Google Cloud الأساسية وتشغيله في بيئة مُدارة. لست بحاجة إلى إدارة خوادمك وتوسيع نطاقها.

هل تستخدم حاليًا Cloud Functions في Google Cloud؟ مزيد من المعلومات عن كيفية ملاءمة Firebase للصورة

البدء حالات الاستخدام

الإمكانات الرئيسية

دمج ميزات Firebase وربط Firebase بمنصّة Google Cloud

يمكن للوظائف التي تكتبها الاستجابة للأحداث التي يتم إنشاؤها من خلال ميزات Firebase وGoogle Cloud المختلفة، بدءًا من عوامل تشغيل مصادقة Firebase ووصولاً إلى عوامل تشغيل "مساحة التخزين في السحابة الإلكترونية".

يمكنك الدمج بين ميزات Firebase باستخدام حزمة تطوير البرامج (SDK) للمشرف مع Cloud Functions، والدمج مع خدمات تابعة لجهات خارجية من خلال كتابة وحدات ربط طلبات الويب الخاصة بك. تعمل Cloud Functions على تقليل تكرار التعليمات البرمجية، ما يسهّل استخدام Firebase وGoogle Cloud داخل الدالة.
لا يحتاج إلى صيانة يمكنك نشر رمز JavaScript أو TypeScript أو Python على خوادمنا باستخدام سطر واحد من أوامر سطر الأوامر. بعد ذلك، توسّع Firebase تلقائيًا موارد الحوسبة لمطابقة أنماط استخدام المستخدمين. ولن تضطر إلى القلق بشأن بيانات الاعتماد أو إعداد الخادم أو توفير خوادم جديدة أو إيقاف الخوادم القديمة.
الحفاظ على خصوصية المنطق وأمانه في كثير من الحالات، يفضّل المطوّرون التحكّم في منطق التطبيق على الخادم لتجنّب التلاعب من جهة العميل. وفي بعض الأحيان، لا يكون من المرغوب فيه السماح بإجراء هندسة عكسية لهذا الرمز. Cloud Functions معزول تمامًا عن العميل، لذا يمكنك التأكّد من أنّه خاص ويعمل دائمًا على النحو المطلوب.

كيف تعمل هذه الميزة؟

بعد كتابة دالة ونشرها، تبدأ خوادم Google في إدارة الدالة على الفور. يمكنك بدء الدالة مباشرةً باستخدام طلب HTTP أو دالة Admin SDK أو وظيفة مجدوَلة، أو في حال الدوال التي تعمل في الخلفية، تستمع خوادم Google إلى الأحداث وتعمل على تنفيذ الدالة عند بدء تنفيذها.

مع زيادة الحمّل أو انخفاضه، تستجيب Google من خلال توسيع نطاق عدد مثيلات الخادم الافتراضي بسرعة اللازمة لتشغيل وظيفتك. يتم تشغيل كل دالة بشكل منفصل في بيئتها الخاصة باستخدام الإعدادات الخاصة بها.

مراحل نشاط الدالة التي تعمل في الخلفية

  1. يمكنك كتابة رمز برمجي لدالة جديدة، واختيار مقدّم حدث (مثل Cloud Firestore)، وتحديد الشروط التي يجب أن تتم فيها execut الدالة.
  2. عند نشر الدالة:
    1. ينشئ Firebase CLI أرشيفًا .zip لرموز الدالة، ثم يتم تحميله إلى حزمة Cloud Storage (تليها علامة "gcf-sources") قبل أن تنشئ Cloud Functions مستودعًا Artifact Registry (يُسمى gcf-artifacts) في مشروعك.
    2. Cloud Build يسترجع رمز الدالة وينشئ مصدر الدالة. يمكنك عرض سجلّات Cloud Build في وحدة تحكّم Google Cloud.
    3. يتم تحميل صورة الحاوية لرمز الدوالّ المُنشأة إلى ملف شخصي مستودع Artifact Registry خاص في مشروعك (يُسمى gcf-artifacts)، ويتم طرح الدالة الجديدة.
  3. عندما يُنشئ موفِّر الحدث حدثًا يتطابق مع شروط الدالة، يتمّ استدعاء الرمز.
  4. إذا كانت الدالة مشغولة في معالجة العديد من الأحداث، تنشئ Google المزيد من النُسخ لمعالجة العمل بشكل أسرع. إذا كانت الدالة غير نشطة، يتم تنظيف النُسخ.
  5. عند تعديل الدالة من خلال نشر الرمز المعدَّل، يتمّ تنظيف نُسخ الإصدارات القديمة مع عناصر الإنشاء في Artifact Registry واستبدالها بنُسخ جديدة.
  6. عند حذف الدالة، يتمّ تنظيف جميع النُسخ وملفّات أرشيف zip، بالإضافة إلى عناصر التصميم ذات الصلة في Artifact Registry. تتم إزالة الربط بين الدالة وموفّر الحدث.

بالإضافة إلى الاستماع إلى الأحداث التي تتضمّن وظيفة في الخلفية، يمكنك استدعاء الوظائف مباشرةً باستخدام طلب HTTP أو طلب من العميل. يمكنك أيضًا بدء الدوالّ وفقًا لجدول زمني ثابت أو إضافة دوالّ المهام إلى "قائمة الانتظار" من خلال Admin SDK.

مسار التنفيذ

إعداد Cloud Functions ثبِّت Firebase CLI وأدخِل الإعدادات الأساسية لملف Cloud Functions في مشروعك على Firebase.
كتابة الدوالّ اكتب رمز JavaScript أو رمز TypeScript أو رمز Python لمعالجة الأحداث الواردة من خدمات Firebase أو خدمات Google Cloud أو مزوّدي الأحداث الآخرين.
اختبار الدوالّ استخدِم المحاكي المحلي لاختبار وظائفك.
النشر والمراقبة عليك ترقية مشروعك إلى خطة أسعار Blaze المستندة إلى نظام الدفع حسب الاستخدام ونشر الدوالّ باستخدام واجهة برمجة التطبيقات Firebase. يمكنك بعد ذلك استخدام Google Cloud وحدة التحكّم للاطّلاع على السجلّات والبحث فيها.

الخطوات التالية