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

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

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

يتم تشغيل الدوال تلقائيًا في المنطقة us-central1. يُرجى العِلم أنّ هذا قد يختلف عن منطقة مصدر الحدث، مثل حاوية Cloud Storage. يمكنك التعرّف على كيفية تحديد المنطقة التي يتم فيها تنفيذ إحدى الدوال في وقت لاحق من هذه الصفحة.

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

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

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

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

الأسعار في الفئة 2

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

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

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

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

لضبط المنطقة التي يتم فيها تنفيذ الدالة، اضبط المَعلمة 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، وبالنسبة إلى مشغّل النشر/الاشتراك، سيكون topic، وهكذا.

راجِع مقالة تغيير منطقة إحدى الدوال للحصول على مزيد من المعلومات حول تغيير منطقة إحدى الدوال التي تعالج عددًا كبيرًا من الزيارات.

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

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

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

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

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

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