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