المواقع الجغرافية لـ 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، وبالنسبة إلى عامل تشغيل Pub/Sub، سيكون 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، وذلك في الحالات التي لا تتوفّر فيها المنطقة نفسها: