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