GlobalOptions interface

GlobalOptions هي خيارات يمكن ضبطها على مستوى مشروع بأكمله. هذه الخيارات شائعة في HTTPS ووظائف معالجة الأحداث.

Signature:

export interface GlobalOptions 

أماكن إقامة

الموقع	النوع	الوصف
التزامن	الرقم | التعبير<number> | إعادة ضبط القيمة	يشير ذلك المصطلح إلى عدد الطلبات التي يمكن أن تعرِضها الدالة دُفعة واحدة.
وحدة المعالجة المركزية (CPU)	الرقم | "gcf_gen1"	عدد كسري لوحدات المعالجة المركزية المطلوب تخصيصها لدالة معيَّنة.
enforceAppCheck	قيمة منطقية	تحدِّد هذه السياسة ما إذا كان سيتم فرض فحص التطبيقات من Firebase. وتكون القيمة التلقائية على "خطأ".
ingressSettings	خطوات الإعداد | إعادة ضبط القيمة	إعدادات الدخول التي تتحكّم في المكان الذي يمكن استدعاء هذه الدالة منه.
المُرسِل	"عام" | "خاص" | سلسلة | سلسلة[]	مرسِل لضبط التحكّم في الوصول إلى وظائف HTTPS
labels	سجلّ<string, string>	تصنيفات المستخدم المطلوب ضبطها على الدالة.
maxInstances	الرقم | التعبير<number> | إعادة ضبط القيمة	الحد الأقصى لعدد الحالات التي يمكن أن تعمل بالتوازي.
الذاكرة	MemoryOption | التعبير<number> | إعادة ضبط القيمة	مقدار الذاكرة الذي سيتم تخصيصه لدالة.
المثيلات الدقيقة	الرقم | التعبير<number> | إعادة ضبط القيمة	الحد الأدنى لعدد المثيلات الفعلية المراد تشغيلها في وقت محدد.
حذف	منطقية | التعبير<boolean>	إذا كانت القيمة هي true، لا تستخدم هذه الدالة أو تحاكيها.
preserveExternalChanges	قيمة منطقية	تتحكّم هذه السياسة في ما إذا كان سيتم الاحتفاظ بإعدادات الدالة المعدَّلة خارج مصدر الدالة. وتكون القيمة التلقائية على "خطأ".
المنطقة	supportedRegion | سلسلة | التعبير<string> | إعادة ضبط القيمة	المنطقة التي يجب تفعيل الدوال فيها.
الأسرار	(سلسلة | SecretParam)[]
serviceAccount	سلسلة | التعبير<string> | إعادة ضبط القيمة	حساب خدمة محدَّد للدالة التي يتم تشغيلها.
timeoutSeconds	الرقم | التعبير<number> | إعادة ضبط القيمة	مهلة الدالة بالثواني، القيم المحتملة هي من 0 إلى 540. يمكن أن تحدد دوال HTTPS مهلة أعلى.
vpcConnector	سلسلة | التعبير<string> | إعادة ضبط القيمة	ربط دالة بموصِّل محدّد في شبكة VPC
vpcConnectorEgressSettings	VpcEgresssetting | إعادة ضبط القيمة	إعدادات الخروج لموصل شبكة VPC.

GlobalOptions.concurrency

يشير ذلك المصطلح إلى عدد الطلبات التي يمكن أن تعرِضها الدالة دُفعة واحدة.

يمكن تطبيقه فقط على الدوال التي تعمل على Cloud Functions (الجيل الثاني). تؤدي القيمة "فارغ" إلى استعادة التزامن التلقائي (80 عندما تكون وحدة المعالجة المركزية (CPU) >= 1، وفي الحالات الأخرى). لا يمكن ضبط التزامن على أي قيمة أخرى غير 1 إذا كانت قيمة cpu أقل من 1. الحد الأقصى لقيمة التزامن هو 1,000.

Signature:

concurrency?: number | Expression<number> | ResetValue;

GlobalOptions.cpu

عدد كسري لوحدات المعالجة المركزية المطلوب تخصيصها لدالة معيَّنة.

يتم ضبط القيمة التلقائية على 1 للدوال التي تتضمّن ذاكرة وصول عشوائي (RAM) بسعة 2 غيغابايت أو أقل من ، ويزيد عند استخدام أحجام ذاكرة أكبر. ويختلف هذا عن الإعدادات التلقائية عند استخدام الأداة المساعدة gcloud ويختلف عن المبلغ الثابت المحدّد في دوال Cloud (الجيل الأول). للرجوع إلى مبالغ وحدة المعالجة المركزية المستخدَمة في gcloud أو في Cloud Functions (الجيل الأول)، يجب ضبط القيمة على "gcf_gen1"

Signature:

cpu?: number | "gcf_gen1";

GlobalOptions.enforceAppCheck

تحدِّد هذه السياسة ما إذا كان سيتم فرض فحص التطبيقات من Firebase. وتكون القيمة التلقائية على "خطأ".

عندما تكون القيمة true، تستجيب الرموز المميزة غير الصالحة تلقائيًا مع ظهور خطأ 401 (غير مصرح به). عند الضبط على "خطأ"، يتمّ ضبط الطلبات ذات الرموز المميّزة غير الصالحة على event.app على undefined.

Signature:

enforceAppCheck?: boolean;

GlobalOptions.ingressSettings

إعدادات الدخول التي تتحكّم في المكان الذي يمكن استدعاء هذه الدالة منه.

Signature:

ingressSettings?: IngressSetting | ResetValue;

GlobalOptions.invoker

مرسِل لضبط التحكّم في الوصول إلى وظائف HTTPS

Signature:

invoker?: "public" | "private" | string | string[];

GlobalOptions.labels

تصنيفات المستخدم المطلوب ضبطها على الدالة.

Signature:

labels?: Record<string, string>;

GlobalOptions.maxInstances

الحد الأقصى لعدد الحالات التي يمكن أن تعمل بالتوازي.

Signature:

maxInstances?: number | Expression<number> | ResetValue;

GlobalOptions.memory

مقدار الذاكرة الذي سيتم تخصيصه لدالة.

Signature:

memory?: MemoryOption | Expression<number> | ResetValue;

GlobalOptions.minInstances

الحد الأدنى لعدد المثيلات الفعلية المراد تشغيلها في وقت محدد.

يتم تحصيل رسوم على المثيلات لتخصيص الذاكرة و% 10 من تخصيص وحدة المعالجة المركزية (CPU) عندما يكون الجهاز غير نشِط لفترة قصيرة.

Signature:

minInstances?: number | Expression<number> | ResetValue;

GlobalOptions.omit

إذا كانت القيمة هي true، لا تستخدم هذه الدالة أو تحاكيها.

Signature:

omit?: boolean | Expression<boolean>;

GlobalOptions.preserveExternalChanges

تتحكّم هذه السياسة في ما إذا كان سيتم الاحتفاظ بإعدادات الدالة المعدَّلة خارج مصدر الدالة. وتكون القيمة التلقائية على "خطأ".

عند إعداد إعدادات متاحة في نظام أساسي أساسي ليست متاحة بعد في حزمة تطوير البرامج (SDK) لمنصّة Firebase for Cloud Functions، ننصحك بضبط السمة preserveExternalChanges على true. إذا لم تفعل ذلك، عندما تطرح Google إصدارًا جديدًا من حزمة SDK يتوافق مع الإعدادات المفقودة، قد يتم محو الإعدادات المضبوطة يدويًا لوظيفتك بدون قصد.

Signature:

preserveExternalChanges?: boolean;

GlobalOptions.region

المنطقة التي يجب تفعيل الدوال فيها.

Signature:

region?: SupportedRegion | string | Expression<string> | ResetValue;

GlobalOptions.secrets

Signature:

secrets?: (string | SecretParam)[];

GlobalOptions.serviceAccount

حساب خدمة محدَّد للدالة التي يتم تشغيلها.

Signature:

serviceAccount?: string | Expression<string> | ResetValue;

GlobalOptions.timeoutSeconds

مهلة الدالة بالثواني، القيم المحتملة هي من 0 إلى 540. يمكن أن تحدد دوال HTTPS مهلة أعلى.

الحد الأدنى للمهلة لوظيفة الجيل الثاني هو 1s. يعتمد الحدّ الأقصى لمهلة إحدى الدوال على نوع الدالة: يمكن أن تصل مهلة دوال التعامل مع الأحداث إلى 540 ثانية كحدّ أقصى (9 دقائق). إنّ مهلة دوال HTTPS والدوال القابلة للاتّصال هي 36,00 ثانية كحدّ أقصى (ساعة واحدة). الحد الأقصى لمهلة دوال قائمة المهام هو 1,800 ثانية (30 دقيقة).

Signature:

timeoutSeconds?: number | Expression<number> | ResetValue;

GlobalOptions.vpcConnector

ربط دالة بموصِّل محدّد في شبكة VPC

Signature:

vpcConnector?: string | Expression<string> | ResetValue;

GlobalOptions.vpcConnectorEgressSettings

إعدادات الخروج لموصل شبكة VPC.

Signature:

vpcConnectorEgressSettings?: VpcEgressSetting | ResetValue;