المواقع الجغرافية لـ Cloud Functions

‫Cloud Functions هي خدمة إقليمية، ما يعني أنّ البنية الأساسية التي تشغّل الدالة تقع في مناطق محدّدة وتديرها Google لتكون متاحة بشكل متكرر في جميع المناطق داخل تلك المناطق.

عند اختيار المناطق التي تريد تشغيل الدوال فيها، يجب أن تكون الاعتبارات الأساسية هي وقت الاستجابة ومدى التوفّر. يمكنك بشكل عام اختيار مناطق قريبة من المستخدمين، ولكن يجب أيضًا مراعاة الموقع الجغرافي للمنتجات والخدمات الأخرى التي يستخدمها تطبيقك. يمكن أن يؤثر استخدام الخدمات في مناطق متعددة في وقت استجابة تطبيقك، بالإضافة إلى الأسعار.

تلقائيًا، تنشر واجهة سطر أوامر Firebase الدوال في منطقة معيّنة استنادًا إلى إعدادات مشروعك. بالنسبة إلى الدوال المستندة إلى الأحداث، يتم نشرها عادةً في منطقة ضمن منطقة مصدر البيانات الذي يشغّلها (مثل قاعدة بيانات Cloud Firestore أو حزمة Cloud Storage)، ويتم نشرها في us-central1 كحل احتياطي.

بعد النشر، يمكنك التحقّق من المنطقة في وحدة تحكّم "Firebase" أو من خلال تشغيل "firebase functions:list". إذا أردت تشغيل الدالة في منطقة مختلفة، يمكنك تغيير منطقتها.

المناطق المتاحة

في القوائم الواردة في هذا القسم، يشير الرمز energy_savings_leaf إلى أنّ الكهرباء في هذه المنطقة يتم إنتاجها بانبعاثات كربون منخفضة. لمزيد من المعلومات، يُرجى الاطّلاع على الطاقة الخالية من الكربون لمناطق Google Cloud.

أسعار المستوى 1

يتوفّر Cloud Functions في المناطق التالية بالأسعار من الفئة 1:

أسعار المستوى 2

يتوفّر Cloud Functions في المناطق التالية بالأسعار من الفئة 2:

يجب أن تكون أسماء الدوال في منطقة معيّنة في مشروع معيّن فريدة (غير حساسة لحالة الأحرف)، ولكن يمكن أن تتشارك الدوال في مناطق مختلفة أو في مشاريع مختلفة الاسم نفسه.

أفضل الممارسات لتحديد منطقة

تلقائيًا، تنشر واجهة سطر أوامر Firebase الدوال في منطقة معيّنة استنادًا إلى إعدادات مشروعك. بالنسبة إلى الدوال المستندة إلى الأحداث، يتم نشرها عادةً في منطقة ضمن منطقة مصدر البيانات الذي يشغّلها (مثل قاعدة بيانات Cloud Firestore أو حزمة Cloud Storage)، ويتم نشرها في us-central1 كحل احتياطي.

ننصحك بضبط مناطق محدّدة بدلاً من الاعتماد على الإعدادات التلقائية في Firebase، والتي قد تتغيّر بمرور الوقت. عند ضبط المناطق، اتّبِع الاقتراحات الواردة في هذا القسم لكل نوع من أنواع المشغّلات

لضبط المنطقة التي يتم فيها تشغيل دالة، اضبط المَعلمة region في تعريف الدالة كما هو موضّح:

exports.firestoreAsia = onDocumentCreated(
  {
    document: "my-collection/{docId}",
    region: "asia-northeast1",
  },
  (event) => {},
);

# Before
@firestore_fn.on_document_created("my-collection/{docId}")
def firestore_trigger(event):
    pass

# After
@firestore_fn.on_document_created("my-collection/{docId}",
                                  region="asia-northeast1")
def firestore_trigger_asia(event):
    pass

يمكنك تحديد مناطق متعددة من خلال تمرير سلاسل مناطق متعددة مفصولة بفواصل في region. يُرجى العِلم أيضًا أنّه عند تحديد منطقة للعديد من أنواع المشغّلات في الخلفية، ستحتاج إلى تحديد فلتر الأحداث الصحيح مع المنطقة. في المثال أعلاه، هذا هو Cloud Firestore document الذي يصدر الحدث. بالنسبة إلى مشغّل Cloud Storage، يمكن أن يكون فلتر الأحداث bucket، وبالنسبة إلى مشغّل Pub/Sub، سيكون topic، وهكذا.

لمزيد من المعلومات حول تغيير منطقة دالة تعالج زيارات الإنتاج، يُرجى الاطّلاع على مقالة تغيير منطقة دالة.

دوال HTTP والدوال التي يمكن للعميل استدعاؤها

بالنسبة إلى دوال HTTP والدوال القابلة للاستدعاء، ننصحك أولاً بضبط الدالة على المنطقة المقصودة أو المنطقة الأقرب إلى مكان إقامة معظم العملاء المتوقّعين، ثم تعديل الدالة الأصلية لإعادة توجيه طلب HTTP إلى الدالة الجديدة (يمكن أن يكون لهما الاسم نفسه). إذا كانت برامج دالة HTTP تتيح عمليات إعادة التوجيه، يمكنك ببساطة تغيير الدالة الأصلية لعرض حالة إعادة توجيه HTTP‏ (301) مع عنوان URL للدالة الجديدة. إذا لم تكن برامجك تتعامل مع عمليات إعادة التوجيه بشكل جيد، يمكنك استخدام خادم وكيل للطلب من الدالة الأصلية إلى الدالة الجديدة عن طريق بدء طلب جديد من الدالة الأصلية إلى الدالة الجديدة. الخطوة الأخيرة هي التأكد من أن جميع العملاء يستدعون الدالة الجديدة.

اختيار الموقع الجغرافي من جهة العميل للدوال القابلة للاستدعاء

Regarding the callable function, client callable setups should follow the same guidelines as HTTP functions. يمكن للعميل أيضًا تحديد منطقة، ويجب عليه القيام بذلك إذا كانت الدالة تعمل في منطقة أخرى غير المنطقة الافتراضية للمشروع.

لضبط المناطق على العميل، حدِّد المنطقة المطلوبة عند الإعداد:

lazy var functions = Functions.functions(region:"europe-west1")

@property(strong, nonatomic) FIRFunctions *functions;
// ...
self.functions = [FIRFunctions functionsWithRegion:@"europe-west1"];

var functions = firebase.app().functions('europe-west1');

private FirebaseFunctions mFunctions;
// ...
mFunctions = FirebaseFunctions.getInstance("europe-west1");

firebase::functions::Functions* functions;
// ...
functions = firebase::functions::Functions::GetInstance("europe-west1");

firebase.Functions.FirebaseFunctions functions;

functions = Firebase.Functions.FirebaseFunctions.GetInstance("europe-west1");

الدوال التي تعمل في الخلفية

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

إذا لم تكن الدالة متكررة حاليًا، أو إذا كان تكرارها لا يمتد إلى خارج المنطقة، ننصحك أولاً بتنفيذ التكرار قبل نقل الدالة.

تختلف اقتراحات المنطقة المثلى حسب نوع عامل تشغيل الحدث:

يتم اختيار المناطق استنادًا إلى موقعَي "Cloud Firestore" و"Cloud Storage"

لا تتطابق المناطق المتاحة للدوال دائمًا بدقة مع المناطق المتاحة لقاعدة بيانات Cloud Firestore وحِزم Cloud Storage.

يُرجى العِلم أنّه إذا كانت الدالة والمورد (مثيل قاعدة البيانات أو حزمة Cloud Storage) في موقعَين جغرافيَّين مختلفَين، قد يؤدي ذلك إلى زيادة وقت الاستجابة وتكاليف الفوترة.

في ما يلي ربط لأقرب المناطق التي تتوفّر فيها الدوال لـ Cloud Firestore وCloud Storage، في الحالات التي لا تتوفّر فيها المنطقة نفسها: