GlobalOptions
هي الخيارات التي يمكن تعيينها عبر المشروع بأكمله. هذه الخيارات شائعة في وظائف HTTPS ومعالجة الأحداث.
إمضاء:
export interface GlobalOptions
ملكيات
ملكية | يكتب | وصف |
---|---|---|
التزامن | رقم | تعبير <رقم> | إعادة تعيين القيمة | عدد الطلبات التي يمكن للوظيفة تقديمها مرة واحدة. |
وحدة المعالجة المركزية | رقم | "gcf_gen1" | عدد كسري من وحدات المعالجة المركزية (CPUs) التي سيتم تخصيصها لوظيفة ما. |
forceAppCheck | منطقية | يحدد ما إذا كان سيتم فرض فحص تطبيق Firebase أم لا. الافتراضيات كاذبة. |
إعدادات الدخول | إعداد الدخول | إعادة تعيين القيمة | إعدادات الدخول التي تتحكم في المكان الذي يمكن استدعاء هذه الوظيفة منه. |
المستحضر | "عامة" | "خاص" | سلسلة | خيط[] | المستدعي لتعيين التحكم في الوصول إلى وظائف HTTPS. |
تسميات | سجل <سلسلة، سلسلة> | تسميات المستخدم لتعيينها على الوظيفة. |
maxInstances | رقم | تعبير <رقم> | إعادة تعيين القيمة | الحد الأقصى لعدد المثيلات التي يمكن تشغيلها بالتوازي. |
ذاكرة | خيار الذاكرة | تعبير <رقم> | إعادة تعيين القيمة | مقدار الذاكرة التي سيتم تخصيصها لوظيفة ما. |
minInstances | رقم | تعبير <رقم> | إعادة تعيين القيمة | الحد الأدنى لعدد المثيلات الفعلية التي سيتم تشغيلها في وقت معين. |
حذف | منطقية | تعبير <منطقية> | إذا كان هذا صحيحًا، فلا تقم بنشر هذه الوظيفة أو محاكاتها. |
saveExternalChanges | منطقية | يتحكم في ما إذا كان سيتم الاحتفاظ بتكوين الوظيفة المعدل خارج مصدر الوظيفة. الافتراضيات كاذبة. |
منطقة | المنطقة المدعومة | سلسلة | تعبير <سلسلة> | إعادة تعيين القيمة | المنطقة التي ينبغي نشر الوظائف فيها. |
أسرار | (سلسلة | SecretParam)[] | |
com.serviceAccount.service | سلسلة | تعبير <سلسلة> | إعادة تعيين القيمة | حساب خدمة محدد للوظيفة التي سيتم تشغيلها كـ. |
timeoutSeconds | رقم | تعبير <رقم> | إعادة تعيين القيمة | مهلة الوظيفة بالثواني، القيم المحتملة هي من 0 إلى 540. يمكن لوظائف HTTPS تحديد مهلة أعلى. |
vpcConnector | سلسلة | تعبير <سلسلة> | إعادة تعيين القيمة | قم بتوصيل وظيفة بموصل VPC محدد. |
vpcConnectorEgressSettings | VpcEgressSetting | إعادة تعيين القيمة | إعدادات الخروج لموصل VPC. |
GlobalOptions.concurrency
عدد الطلبات التي يمكن للوظيفة تقديمها مرة واحدة.
يمكن تطبيقه فقط على الوظائف التي تعمل على Cloud Functions (الجيل الثاني)). تعمل القيمة الخالية على استعادة التزامن الافتراضي (80 عندما تكون وحدة المعالجة المركزية > = 1، 1 وإلا). لا يمكن تعيين التزامن على أي قيمة غير 1 إذا كانت cpu
أقل من 1. الحد الأقصى لقيمة التزامن هو 1000.
إمضاء:
concurrency?: number | Expression<number> | ResetValue;
GlobalOptions.cpu
عدد كسري من وحدات المعالجة المركزية (CPUs) التي سيتم تخصيصها لوظيفة ما.
الإعدادات الافتراضية هي 1 للوظائف ذات < = 2 جيجا بايت رام وتزيد بالنسبة لأحجام الذاكرة الأكبر. ويختلف هذا عن الإعدادات الافتراضية عند استخدام الأداة المساعدة gcloud ويختلف عن المقدار الثابت المعين في Cloud Functions (الجيل الأول). للعودة إلى كميات وحدة المعالجة المركزية المستخدمة في gcloud أو في Cloud Functions (الجيل الأول)، قم بتعيين هذا على القيمة "gcf_gen1"
إمضاء:
cpu?: number | "gcf_gen1";
GlobalOptions.enforceAppCheck
يحدد ما إذا كان سيتم فرض فحص تطبيق Firebase أم لا. الافتراضيات كاذبة.
عندما يكون هذا صحيحًا، فإن الطلبات التي تحتوي على رموز مميزة غير صالحة تستجيب تلقائيًا بخطأ 401 (غير مصرح به). عندما تكون القيمة "خطأ"، فإن الطلبات التي تحتوي على رموز غير صالحة تقوم بتعيين event.app
على undefined
.
إمضاء:
enforceAppCheck?: boolean;
GlobalOptions.ingressSettings
إعدادات الدخول التي تتحكم في المكان الذي يمكن استدعاء هذه الوظيفة منه.
إمضاء:
ingressSettings?: IngressSetting | ResetValue;
GlobalOptions.invocer
المستدعي لتعيين التحكم في الوصول إلى وظائف HTTPS.
إمضاء:
invoker?: "public" | "private" | string | string[];
GlobalOptions.labels
تسميات المستخدم لتعيينها على الوظيفة.
إمضاء:
labels?: Record<string, string>;
GlobalOptions.maxInstances
الحد الأقصى لعدد المثيلات التي يمكن تشغيلها بالتوازي.
إمضاء:
maxInstances?: number | Expression<number> | ResetValue;
GlobalOptions.memory
مقدار الذاكرة التي سيتم تخصيصها لوظيفة ما.
إمضاء:
memory?: MemoryOption | Expression<number> | ResetValue;
GlobalOptions.minInstances
الحد الأدنى لعدد المثيلات الفعلية التي سيتم تشغيلها في وقت معين.
تتم محاسبة المثيلات مقابل تخصيص الذاكرة و10% من تخصيص وحدة المعالجة المركزية أثناء الخمول.
إمضاء:
minInstances?: number | Expression<number> | ResetValue;
GlobalOptions.omit
إذا كان هذا صحيحًا، فلا تقم بنشر هذه الوظيفة أو محاكاتها.
إمضاء:
omit?: boolean | Expression<boolean>;
GlobalOptions.preserveExternalChanges
يتحكم في ما إذا كان سيتم الاحتفاظ بتكوين الوظيفة المعدل خارج مصدر الوظيفة. الافتراضيات كاذبة.
عند تعيين التكوين المتاح في نظام أساسي أساسي غير متوفر بعد في Firebase SDK لوظائف السحابة، نوصي بتعيين preserveExternalChanges
على true
. بخلاف ذلك، عندما تقوم Google بإصدار إصدار جديد من SDK مع دعم التكوين المفقود، فقد يتم مسح الإعداد الذي تم تكوينه يدويًا لوظيفتك دون قصد.
إمضاء:
preserveExternalChanges?: boolean;
GlobalOptions.region
المنطقة التي ينبغي نشر الوظائف فيها.
إمضاء:
region?: SupportedRegion | string | Expression<string> | ResetValue;
GlobalOptions.secrets
إمضاء:
secrets?: (string | SecretParam)[];
GlobalOptions.serviceAccount
حساب خدمة محدد للوظيفة التي سيتم تشغيلها كـ.
إمضاء:
serviceAccount?: string | Expression<string> | ResetValue;
GlobalOptions.timeoutSeconds
مهلة الوظيفة بالثواني، القيم المحتملة هي من 0 إلى 540. يمكن لوظائف HTTPS تحديد مهلة أعلى.
الحد الأدنى لمهلة وظيفة الجيل الثاني هو 1 ثانية. يعتمد الحد الأقصى لمهلة الوظيفة على نوع الوظيفة: الحد الأقصى لمهلة وظائف معالجة الأحداث هو 540 ثانية (9 دقائق). تتمتع وظائف HTTPS والوظائف القابلة للاستدعاء بحد أقصى للمهلة يبلغ 36,00 ثانية (ساعة واحدة). تتمتع وظائف قائمة انتظار المهام بمهلة قصوى تصل إلى 1800 ثانية (30 دقيقة).
إمضاء:
timeoutSeconds?: number | Expression<number> | ResetValue;
GlobalOptions.vpcConnector
قم بتوصيل وظيفة بموصل VPC محدد.
إمضاء:
vpcConnector?: string | Expression<string> | ResetValue;
GlobalOptions.vpcConnectorEgressSettings
إعدادات الخروج لموصل VPC.
إمضاء:
vpcConnectorEgressSettings?: VpcEgressSetting | ResetValue;