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

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

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

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

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

المناطق التي تتوفّر فيها هذه الميزة

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

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

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

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

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

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

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

تتيح Firebase CLI نشر الدوال تلقائيًا في منطقة استنادًا إلى إعدادات مشروعك. بالنسبة إلى الدوال المستندة إلى الأحداث، يتم عادةً نشرها في منطقة ضمن منطقة مصدر البيانات الذي يؤدي إلى تشغيلها (مثل قاعدة بيانات 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 الخاص بالدالة الجديدة. إذا كانت برامجك لا تتعامل بشكل جيد مع عمليات إعادة التوجيه، يمكنك توجيه الطلب من الدالة الأصلية إلى الدالة الجديدة من خلال بدء طلب جديد من الدالة الأصلية إلى الدالة الجديدة. الخطوة الأخيرة هي التأكّد من أنّ جميع العملاء يستدعون الدالة الجديدة.

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

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

لضبط المناطق على العميل، حدِّد المنطقة المطلوبة عند بدء التشغيل:

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، وذلك في الحالات التي لا تتوفّر فيها المنطقة نفسها: