إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توفر هذه المقالة وثائق مرجعية دالات Azure Core Tools، والتي تتيح لك تطوير المشاريع دالات Azure وإدارتها ونشرها من الكمبيوتر المحلي. لمعرفة المزيد حول استخدام Core Tools، راجع Work مع دالات Azure Core Tools.
يتم تنظيم أوامر Core Tools في السياقات التالية، كل منها يوفر مجموعة فريدة من الإجراءات.
| سياق الأمر | الوصف |
|---|---|
func |
الأوامر المستخدمة لإنشاء الوظائف تشغيلها على الكمبيوتر المحلي. |
func azure |
أوامر للعمل مع موارد Azure، بما في ذلك النشر. |
func azurecontainerapps |
انشر تطبيق الوظائف المعبأة في حاويات إلى Azure Container Apps. |
func durable |
أوامر للعمل مع Durable Functions. |
func extensions |
أوامر لتثبيت الملحقات وإدارتها. |
func kubernetes |
أوامر للعمل مع Kubernetes و دالات Azure. |
func settings |
أوامر لإدارة إعدادات البيئة لمضيف الوظائف المحلية. |
func templates |
أوامر لسرد قوالب الوظائف المتوفرة. |
قبل استخدام الأوامر في هذه المقالة، يجب عليك تثبيت Core Tools.
func init
يتم من خلالها إنشاء مشروع Functions جديد بلغة معينة.
func init <PROJECT_FOLDER>
عند توفير ، يتم إنشاء المشروع في مجلد جديد بهذا الاسم. وإلا، يتم استخدام المجلد الحالي.
يدعم الخيارات التالية، والتي لا تدعم الإصدار 1.x ما لم تتم الإشارة إلى خلاف ذلك:
| خيار | الوصف |
|---|---|
--csx |
إنشاء وظائف .NET كبرنامج نصي C#، وهو سلوك الإصدار 1.x. صالح فقط مع . |
--docker |
ينشيء Dockerfile لحاوية باستخدام صورة أساسية تستند إلى المختار. استخدم هذا الخيار عندما تخطط لنشر تطبيق دالة في حاوية. |
--docker-only |
يضيف Dockerfile إلى مشروع موجود. مطالبات لوقت تشغيل العامل إذا لم يتم تحديده أو تعيينه في local.settings.js. استخدم هذا الخيار عندما تخطط لنشر تطبيق دالة في حاوية والمشروع موجود بالفعل. |
--force |
تتم تهيئة المشروع حتى عندما تكون هناك ملفات موجودة في المشروع. يتم من خلال هذا الإعداد الكتابة فوق الملفات الموجودة بنفس الاسم. لا تتأثر الملفات الأخرى في مجلد المشروع. |
--language |
تتم تهيئة مشروع خاص بلغة معينة. يتم دعم ذلك حاليًا عند تعيين إلى . الخيارات هي و. يمكنك أيضًا استخدام أو . |
--managed-dependencies |
يتم تثبيت التبعيات المُدارة. حاليًا، لا يدعم هذه الوظيفة إلا وقت تشغيل عامل PowerShell. |
--model |
تعيين نموذج البرمجة المطلوب للغة مستهدفة عند توفر أكثر من نموذج واحد. الخيارات المدعومة هي V1 و V2 Python و V3 و V4 Node.js. لمزيد من المعلومات، راجع دليل المطور Python ودليل المطور Node.js على التوالي. |
--source-control |
يتحكم في إنشاء مستودع git. بشكل افتراضي، لا يتم إنشاء مستودع. عند ، يتم إنشاء مستودع. |
--worker-runtime |
تعيين وقت تشغيل اللغة للمشروع. القيم المدعومة هي: و و و و (JavaScript) و و و. على سبيل Java، استخدم Maven. لإنشاء مشروع غير خاص بلغة محددة مع ملفات المشروع فقط، استخدم . عند عدم التعيين، ستتم مطالبتك باختيار وقت التشغيل أثناء التهيئة. |
--target-framework |
تعيين إطار العمل الهدف لمشروع تطبيق الوظيفة. صالح فقط مع . القيم المدعومة هي: net10.0 (معاينة)، net9.0، net8.0 (افتراضي)، net6.0، net48 (.NET Framework 4.8). |
إشعار
عند استخدام خيارات --docker أو --docker-only، تقوم Core Tools تلقائيا بإنشاء Dockerfile لوظائف C# وJavaScript Python وPowerShell. بالنسبة Java الدالات، يجب إنشاء Dockerfile يدويا. لمزيد من المعلومات، راجع إنشاء تطبيقات الوظائف المعبأة في حاويات.
func logs
يتم من خلالها الحصول على سجلات للوظائف قيد التشغيل في نظام مجموعة Kubernetes.
func logs --platform kubernetes --name <APP_NAME>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--platform |
نظام استضافة الأساسي لتطبيق الوظائف. الخيارات المدعومة: . |
--name |
اسم تطبيق الدالة في Azure. |
لمعرفة المزيد، راجع دالات Azure على Kubernetes باستخدام KEDA.
func new
يتم من خلالها إنشاء وظيفة جديدة في المشروع الحالي استنادًا إلى قالب.
func new
عند التشغيل بدون الخيار، تتم مطالبتك باختيار قالب. في الإصدار 1.x، يطلب منك أيضا اختيار اللغة.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--authlevel |
يتيح لك تعيين مستوى التخويل لمشغل HTTP. القيم المدعومة هي: و و. لا يتم فرض التخويل عند التشغيل محليًا. لمزيد من المعلومات، راجع مستوى التخويل. |
--csx |
(الإصدار 2.x والإصدارات الأحدث.) ينشئ نفس قوالب برنامج C# النصي (.csx) المستخدمة في الإصدار 1.x وفي المدخل. |
| ، | لغة برمجة القالب، مثل C# أو F# أو JavaScript. هذا الخيار مطلوب في الإصدار 1.x. في الإصدار 2.x والإصدارات الأحدث، لا تستخدم هذا الخيار لأن اللغة معرفة من قِبل وقت تشغيل العامل. |
| ، | اسم الوظيفة. |
| ، | استخدم الأمر لمشاهدة القائمة الكاملة للقوالب المتوفرة لكل لغة مدعومة. |
لمعرفة المزيد، راجع إنشاء وظيفة.
func run
الإصدار 1.x فقط.
يمكنك من استدعاء دالة مباشرة، والتي تشبه تشغيل دالة باستخدام علامة التبويب Test في مدخل Azure. هذا الإجراء مدعوم فقط في الإصدار 1.x. بالنسبة للإصدارات الأحدث، استخدم وبادر باستدعاء نقطة النهاية الوظيفة مباشرةً.
func run
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--content |
تم تمرير محتوى مضمن إلى الوظيفة. |
--debug |
بادر بإرفاق مصحح الأخطاء إلى عملية المضيف قبل تشغيل الوظيفة. |
--file |
اسم الملف المطلوب استخدامه كمحتوى. |
--no-interactive |
لا يطالب بإدخال، وهو أمر مفيد لسيناريوهات التشغيل التلقائي. |
--timeout |
وقت الانتظار (بالثواني) حتى يصبح مضيف الوظائف المحلي جاهزًا. |
على سبيل المثال، لاستدعاء وظيفة تشغيل HTTP وتمرير نص المحتوى، بادر بتشغيل الأمر التالي:
func run MyHttpTrigger --content '{\"name\": \"Azure\"}'
func start
يتم من خلالها بدء تشغيل مضيف وقت التشغيل المحلي وتحميل مشروع الوظيفة في المجلد الحالي.
يعتمد الأمر المحدد على إصدار وقت التشغيل.
- v2.x+
- v1.x
func start
يدعم الخيارات التالية:
| خيار | الوصف |
|---|---|
--cert |
المسار إلى ملف .pfx الذي يحتوي على مفتاح خاص. غير مدعوم إلا مع . |
--cors |
قائمة مفصولة بفاصلة لأصول CORS، بدون مسافات. |
--cors-credentials |
السماح بالطلبات المصادق عليها عبر المنشأ باستخدام ملفات تعريف الارتباط ورأس المصادقة. |
--dotnet-isolated-debug |
عند التعيين إلى true، يوقف عملية عامل .NET مؤقتا حتى يتم إرفاق مصحح أخطاء من .NET المشروع المعزول الذي يتم تصحيحه. |
--enable-json-output |
تطرح سجلات وحدة التحكم بتنسيق JSON، حيثما أمكن. |
--enableAuth |
تمكين البنية الأساسية لمعالجة المصادقة الكاملة، مع متطلبات التخويل. |
--functions |
قائمة مفصولة بفواصل من الوظائف المطلوب تحميلها. |
--language-worker |
الوسيطات المطلوبة لتكوين عامل اللغة. على سبيل المثال، يمكنك تمكين تصحيح الأخطاء لعامل اللغة من خلال توفير منفذ debug والوسيطات المطلوبة الأخرى. |
--no-build |
تجنب إنشاء المشروع الحالي قبل التشغيل. بالنسبة .NET مشاريع الفئة فقط. الافتراضي هو . |
--password |
إما كلمة المرور أو ملف يحتوي على كلمة المرور لملف .pfx. يستخدم فقط مع . |
--port |
المنفذ المحلي للاستماع من عليه. القيمة الافتراضية: 7071. |
--timeout |
مهلة بدء مضيف الوظائف، بالثواني. الافتراضي: 20 ثانية. |
--useHttps |
ربط إلى بدلاً من . بشكل افتراضي، ينشئ هذا الخيار شهادة موثوق بها على الكمبيوتر الخاص بك. |
مع تشغيل المشروع، يمكنك التحقق من نقاط نهاية الوظائف الفردية.
الخيارات العمومية
تدعم جميع الأوامر هذه الخيارات:
| خيار | الوصف |
|---|---|
--slot |
يستهدف فتحة نشر مسماة محددة، إذا تم تكوينها. |
--access-token |
يوفر رمزا مميزا للوصول، بخلاف الرمز المميز الافتراضي، لاستخدامه لتنفيذ الإجراءات المصادق عليها في Azure. |
--access-token-stdin |
يقرأ رمز وصول معينا من إدخال قياسي. استخدم هذا عند قراءة الرمز المميز مباشرة من أمر سابق مثل . |
--management-url |
تعيين عنوان URL للإدارة للسحابة Azure، والتي يتم تعيينها افتراضيا إلى https://management.azure.com. استخدم هذا الخيار عند تشغيل تطبيق الوظائف في سحابة ذات سيادة. |
--subscription |
تعيين اشتراك Azure الافتراضي. |
func azure functionapp fetch-app-settings
يتم من خلالها إحضار الإعدادات من تطبيق وظائف محدد.
func azure functionapp fetch-app-settings <APP_NAME>
لمزيد من المعلومات، راجع تنزيل إعدادات التطبيق.
يتم تنزيل الإعدادات في ملف local.settings.json للمشروع. يتم إخفاء القيم على الشاشة لأغراض الأمان. يمكنك حماية الإعدادات في الملف local.settings.json عن طريق تمكين التشفير المحلي.
func azure functionapp list-functions
يتم من خلالها إرجاع قائمة بالوظائف في تطبيق الوظائف المحدد.
func azure functionapp list-functions <APP_NAME>
| خيار | الوصف |
|---|---|
--show-keys |
تتضمن عناوين URL لنقطة نهاية الدالة التي يتم إرجاعها قيم مفتاح الوصول على مستوى الدالة. |
func azure functionapp logstream
يربط موجه الأوامر المحلي بسجلات الدفق لتطبيق الوظائف في Azure.
func azure functionapp logstream <APP_NAME>
المهلة الافتراضية للاتصال هي ساعتين. يمكنك تغيير المهلة بإضافة إعداد تطبيق بالاسم SCM_LOGSTREAM_TIMEOUT، مع عرض قيمة المهلة بالثواني. غير مدعومة حتى الآن لنظام Linux في خطة استهلاك Flex أو الاستهلاك . بالنسبة لهذه التطبيقات، استخدم الخيار لعرض السجلات في المدخل.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--browser |
افتح Azure Application Insights Live Stream لتطبيق الوظائف في المستعرض الافتراضي. |
لمزيد من المعلومات، راجع تطبيقات تنفيذ الدفق القابلة للتنفيذ في دالات Azure.
func azure functionapp publish
نشر مشروع Functions إلى مورد تطبيق دالة موجود في Azure.
func azure functionapp publish <APP_NAME>
لمزيد من المعلومات، راجع توزيع ملفات المشروع.
تنطبق خيارات النشر التالية، استنادًا إلى الإصدار:
- v2.x+
- v1.x
| خيار | الوصف |
|---|---|
--additional-packages |
قائمة بالحزم المطلوب تثبيتها عند إنشاء التبعيات الأصلية. على سبيل المثال: . |
| ، | يتم من خلالها تنفيذ إجراء بنية عند التوزيع إلى تطبيق وظائف Linux. يقبل: و . |
--build-native-deps |
يتخطى إنشاء المجلد .wheels عند نشر تطبيقات الوظائف Python. |
--csx |
انشر مشروع برنامج C# النصي (.csx). |
--dotnet-cli-params |
عند نشر وظائف C# المحولة برمجيًا (.csproj)، تستدعي core tools . يتم إلحاق أي معلمات تم تمريرها إلى هذا إلى سطر الأوامر. |
--force |
تجاهل التحقق المنشور مسبقا في سيناريوهات معينة. |
--list-ignored-files |
يتم من خلالها عرض قائمة بالملفات التي يتم تجاهلها أثناء النشر، والتي تستند إلى الملف . |
--list-included-files |
تعرض قائمة بالملفات التي يتم نشرها، والتي تستند إلى الملف . |
--no-build |
لم يتم بناء المشروع أثناء النشر. بالنسبة إلى Python، لا يتم تنفيذ pip install. |
--nozip |
تعمل على إيقاف تشغيل الوضع الافتراضي. يتم استخراج الملفات إلى المجلد على الخادم بدلا من تشغيلها مباشرة من حزمة النشر. |
--overwrite-settings -y |
منع المطالبة بالكتابة فوق إعدادات التطبيق عند استخدام . |
--publish-local-settings -i |
نشر الإعدادات في local.settings.json إلى Azure، مع المطالبة بالكتابة فوق إذا كان الإعداد موجودا بالفعل. إذا كنت تستخدم محاكي تخزين محلي، فقم أولا بتغيير إعداد التطبيق إلى اتصال تخزين فعلي. |
| ، | فقط نشر الإعدادات وتخطي المحتوى. الإعداد الافتراضي هو مطالبة. |
func azure storage fetch-connection-string
الحصول على سلسلة الاتصال لحساب تخزين Azure المحدد.
func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>
لمزيد من المعلومات، راجع
func azurecontainerapps deploy
نشر تطبيق دالة في حاوية إلى بيئة Azure Container Apps. يجب أن يكون كل من حساب التخزين المستخدم من قبل تطبيق الوظائف والبيئة موجودا بالفعل. لمزيد من المعلومات، راجع استضافة Azure Container Apps دالات Azure.
func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>
تنطبق خيارات النشر التالية:
| خيار | الوصف |
|---|---|
--environment |
اسم بيئة Container Apps الموجودة. |
--image-build |
عند التعيين إلى ، يتخطى بناء Docker المحلي. |
--image-name |
اسم صورة حاوية موجودة في سجل حاوية. يتضمن اسم الصورة اسم العلامة. |
--location |
المنطقة الخاصة بالنشر. من الناحية المثالية، هذه هي نفس المنطقة مثل موارد حساب البيئة والتخزين. |
--name |
الاسم المستخدم لنشر تطبيق الوظائف في بيئة Container Apps. يستخدم هذا الاسم نفسه أيضا عند إدارة تطبيق الوظائف في المدخل. يجب أن يكون الاسم فريدا في البيئة. |
--registry |
عند التعيين، يتم تشغيل بناء Docker ويتم دفع الصورة إلى مجموعة التسجيل في . لا يمكنك استخدام مع . بالنسبة إلى Docker Hub، استخدم أيضا --registry-username. |
--registry-password |
كلمة المرور أو الرمز المميز المستخدم لاسترداد الصورة من سجل خاص. |
--registry-username |
اسم المستخدم المستخدم لاسترداد الصورة من سجل خاص. |
--resource-group |
مجموعة الموارد التي سيتم فيها إنشاء الموارد المتعلقة بالوظائف. |
--storage-account |
سلسلة الاتصال لحساب التخزين الذي سيتم استخدامه من قبل تطبيق الوظائف. |
--worker-runtime |
تعيين لغة وقت التشغيل لتطبيق الوظائف. يتم استخدام هذه المعلمة فقط مع و ، وإلا يتم تحديد اللغة أثناء الإنشاء المحلي. القيم المدعومة هي: و و (لمعالجات العملاء). |
هام
تعد سلسلة الاتصال التخزين وبيانات اعتماد الخدمة الأخرى أسرارا مهمة. تأكد من تخزين أي ملفات برامج نصية بأمان باستخدام ولا تخزنها في أي عنصر تحكم مصدر يمكن الوصول إليه بشكل عام.
func deploy
تم إهمال الأمر. بدلا من ذلك، استخدم .
func durable delete-task-hub
حذف كافة عناصر التخزين في مركز مهام Durable Functions.
func durable delete-task-hub
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--task-hub-name |
اسم اختياري لمركز مهام Durable المطلوب استخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable get-history
ترجع محفوظات مثيل التنظيم المحدد.
func durable get-history --id <INSTANCE_ID>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--id |
يحدد معرف مثيل التنظيم (مطلوب). |
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--task-hub-name |
اسم اختياري لمركز مهام Durable المطلوب استخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable get-instances
ترجع حالة كل مثيلات التنظيم. يدعم التقسيم المرحلي باستخدام المعلمة .
func durable get-instances
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--continuation-token |
الرمز المميز الاختياري الذي يشير إلى صفحة/مقطع معين من الطلبات المطلوب إرجاعها. |
--connection-string-setting |
اسم اختياري لإعداد التطبيق الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--created-after |
اختياريًا، احصل على المثيلات التي تم إنشاؤها بعد هذا التاريخ/الوقت (UTC). يتم قبول كل التواريخ والأوقات بالتنسيق ISO 8601. |
--created-before |
اختياريًا، احصل على المثيلات التي تم إنشاؤها قبل تاريخ/وقت (UTC) محدد. يتم قبول كل التواريخ والأوقات بالتنسيق ISO 8601. |
--runtime-status |
اختياريًا، احصل على المثيلات التي تطابق حالتها حالة معينة، بما في ذلك ، ، و . يمكنك توفير حالة واحدة أو أكثر يُفصل بينها بفواصل. |
--top |
يمكنك اختياريًا قصر عدد السجلات التي يتم إرجاعها في طلب معين. |
--task-hub-name |
اسم اختياري لمركز المهام Durable Functions لاستخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable get-runtime-status
ترجع حالة مثيل التنظيم المحدد.
func durable get-runtime-status --id <INSTANCE_ID>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--id |
يحدد معرف مثيل التنظيم (مطلوب). |
--show-input |
عند التعيين، تحتوي الاستجابة على إدخال الوظيفة. |
--show-output |
عند التعيين، تحتوي الاستجابة على محفوظات التنفيذ. |
--task-hub-name |
اسم اختياري لمركز المهام Durable Functions لاستخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable purge-history
إزالة حالة مثيل التنظيم ومحفوظاته وتخزين blob لعمليات التنظيم الأقدم من الحد المحدد.
func durable purge-history
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--created-after |
اختياريًا، احذف محفوظات المثيلات التي تم إنشاؤها بعد هذا التاريخ/الوقت (UTC). يتم قبول كل قيم التاريخ والوقت بالتنسيق ISO 8601. |
--created-before |
اختياريًا، احذف محفوظات المثيلات التي تم إنشاؤها قبل هذا التاريخ/الوقت (UTC). يتم قبول كل قيم التاريخ والوقت بالتنسيق ISO 8601. |
--runtime-status |
اختياريًا، احذف محفوظات المثيلات التي تطابق حالتها حالة معينة، بما في ذلك و و و. يمكنك توفير حالة واحدة أو أكثر يُفصل بينها بفواصل. في حالة عدم تضمين ، يتم حذف سجل المثيل بغض النظر عن الحالة. |
--task-hub-name |
اسم اختياري لمركز المهام Durable Functions لاستخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable raise-event
تنفيذ حدث على مثيل التنظيم المحدد.
func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--event-data |
البيانات المطلوب تمريرها إلى الحدث، سواء مضمنة أو من ملف JSON (مطلوب). بالنسبة للملفات، ضع قبل المسار إلى الملف علامة العطف ()، مثل . |
--event-name |
اسم الحدث المطلوب تنفيذه (مطلوب). |
--id |
يحدد معرف مثيل التنظيم (مطلوب). |
--task-hub-name |
اسم اختياري لمركز المهام Durable Functions لاستخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable rewind
إرجاع مثيل التنظيم المحدد.
func durable rewind --id <INSTANCE_ID> --reason <REASON>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--id |
يحدد معرف مثيل التنظيم (مطلوب). |
--reason |
سبب إرجاع التنظيم (مطلوب). |
--task-hub-name |
اسم اختياري لمركز المهام Durable Functions لاستخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable start-new
بدء مثيل جديد من وظيفة التنظيم المحددة.
func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--function-name |
اسم وظيفة المنسق لبدء التشغيل. |
--id |
يحدد معرف مثيل التنظيم (مطلوب). |
--input |
إدخال وظيفة التنظيم، سواء مضمنة أو من ملف JSON (مطلوب). بالنسبة للملفات، ضع قبل المسار إلى الملف علامة العطف ()، مثل . |
--task-hub-name |
اسم اختياري لمركز المهام Durable Functions لاستخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func durable terminate
إيقاف مثيل التنظيم المحدد.
func durable terminate --id <INSTANCE_ID> --reason <REASON>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connection-string-setting |
اسم اختياري للإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه. |
--id |
يحدد معرف مثيل التنظيم (مطلوب). |
--reason |
سبب إيقاف التنظيم (مطلوب). |
--task-hub-name |
اسم اختياري لمركز المهام Durable Functions لاستخدامه. |
لمعرفة المزيد، راجع وثائق Durable Functions.
func extensions install
تثبيت ملحقات الوظائف يدويا في مشروع غير .NET أو في مشروع برنامج نصي C#.
func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--configPath |
مسار الدليل الذي يحتوي على ملف extensions.csproj. |
--csx |
يدعم مشاريع برنامج C# النصي (.csx). |
--force |
تحديث إصدارات الملحقات الموجودة. |
--output |
مسار الإخراج للملحقات. |
--package |
معرف حزمة ملحق محددة. عند عدم التحديد، يتم تثبيت الملحقات المشار إليها، كما هو الحال مع . |
--source |
مصدر موجز NuGet عند عدم استخدام NuGet.org. |
--version |
إصدار حزمة ملحق. |
يقوم المثال التالي بتثبيت الإصدار 5.0.1 من ملحق مراكز الأحداث في المشروع المحلي:
func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1
تنطبق الاعتبارات التالية عند استخدام :
لمشاريع C# المحولة برمجيا (كل من عملية عامل قيد المعالجة وعملية عامل معزولة)، بدلا من ذلك استخدم أساليب تثبيت حزمة NuGet القياسية، مثل .
لتثبيت الملحقات يدويا باستخدام Core Tools، يجب أن يكون لديك .NET SDK مثبتا.
عندما يكون ذلك ممكنا، يجب عليك بدلا من ذلك استخدام حزم الملحقات. فيما يلي بعض الأسباب التي قد تدفعك إلى تثبيت الملحقات يدويا:
- تحتاج إلى الوصول إلى إصدار محدد من ملحق غير متوفر في مجموعة.
- تحتاج إلى الوصول إلى ملحق مخصص غير متوفر في مجموعة.
- تحتاج إلى الوصول إلى مجموعة محددة من الملحقات غير متوفرة في مجموعة واحدة.
قبل أن تتمكن من تثبيت الملحقات يدويا، يجب أولا إزالة الكائن من ملف host.json الذي يعرف المجموعة. لا يتم اتخاذ أي إجراء عند تعيين حزمة ملحق بالفعل في ملف host.json.
في المرة الأولى التي تقوم فيها بتثبيت ملحق بشكل صريح، تتم إضافة ملف مشروع .NET باسم extensions.csproj إلى جذر مشروع التطبيق الخاص بك. يُعرف هذا الملف مجموعة حزم NuGet المطلوبة من قبل الوظائف الخاصة بك. بينما يمكنك العمل مع مراجع حزمة NuGet في هذا الملف، تتيح لك Core Tools تثبيت الملحقات دون الحاجة إلى تحرير ملف المشروع C# يدوياً.
func extensions sync
يتم تثبيت كل الملحقات المضافة إلى تطبيق الوظائف.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--configPath |
مسار الدليل الذي يحتوي على ملف extensions.csproj. |
--csx |
يدعم مشاريع برنامج C# النصي (.csx). |
--output |
مسار الإخراج للملحقات. |
إعادة إنشاء ملف extensions.csproj مفقود. لا يتم اتخاذ أي إجراء عند تعريف حزمة ملحق في ملف host.json لديك.
func kubernetes deploy
يتم توزيع مشروع الوظائف على شكل حاوية docker مخصصة إلى نظام مجموعة Kubernetes.
func kubernetes deploy
ينشئ هذا الأمر المشروع على شكل حاوية مخصصة وينشره إلى نظام مجموعة Kubernetes. يجب أن تحتوي الحاويات المخصصة على Dockerfile. لإنشاء تطبيق باستخدام Dockerfile، استخدم الخيار مع الأمر .
تتوفر خيارات توزيع Kubernetes التالية:
| خيار | الوصف |
|---|---|
--dry-run |
تعرض اختيارًا قالب التوزيع، دون تنفيذ. |
--config-map-name |
اسم اختياري لخريطة تكوين موجودة مع إعدادات تطبيق الوظائف لاستخدامها في التوزيع. يلزم توفر . السلوك الافتراضي هو إنشاء الإعدادات استنادًا إلى الكائن في ملف local.settings.json. |
--cooldown-period |
فترة التهدئة (بالثواني) بعد أن تكون كل المشغلات غير نشطة قبل أن يتراجع حجم التوزيع إلى الصفر، مع وجود القيمة الافتراضي 300 ثانية. |
--ignore-errors |
متابعة التوزيع بعد إرجاع المورد لخطأ. السلوك الافتراضي هو التوقف عند وقوع خطأ. |
--image-name |
اسم الصورة المطلوب استخدامها لتوزيع pod والمطلوب قراءة الوظائف منه. |
--keda-version |
تعيين إصدار KEDA المطلوب تثبيته. الخيارات الصالحة هي: و (الافتراضي). |
--keys-secret-name |
اسم مجموعة أسرار Kubernetes لاستخدامها لتخزين مفاتيح الوصول. |
--max-replicas |
تعيين الحد الأقصى لعدد النسخ المتماثلة الذي يتم تغيير حجم Horizontal Pod Autoscaler (HPA) إليها. |
--min-replicas |
تعيين الحد الأدنى لعدد النسخ المتماثلة التي لا يمكن تغيير حجم HPA أدناها. |
--mount-funckeys-as-containervolume |
تحميل مفاتيح الوصول كحجم حاوية. |
--name |
الاسم المستخدم للتوزيع والبيانات الاصطناعية الأخرى في Kubernetes. |
--namespace |
تعيين مساحة اسم Kubernetes المطلوب التوزيع إليها، التي يتم تعيينها افتراضيًا إلى مساحة الاسم الافتراضية. |
--no-docker |
تتم قراءة الوظائف من الدليل الحالي بدلاً من صورة. يتطلب تحميل نظام ملفات الصورة. |
--registry |
عند التعيين، يتم تشغيل بنية Docker ودفع الصورة إلى سجل بهذا الاسم. لا يمكنك استخدام مع . بالنسبة لـ Docker، استخدم اسم المستخدم لديك. |
--polling-interval |
الفاصل الزمني للاستقصاء (بالثواني) للتحقق من مشغلات لا تتبع HTTP، مع تحديد القيمة الافتراضية بالقيمة 30 ثانية. |
--pull-secret |
السر المستخدم للوصول إلى بيانات اعتماد التسجيل الخاص. |
--secret-name |
اسم مجموعة أسرار Kubernetes الموجودة التي تحتوي على إعدادات تطبيق الوظائف لاستخدامها في التوزيع. السلوك الافتراضي هو إنشاء الإعدادات استنادًا إلى الكائن في ملف local.settings.json. |
--show-service-fqdn |
يعرض عناوين URL لمشغلات HTTP باستخدام Kubernetes FQDN بدلاً من السلوك الافتراضي لاستخدام عنوان IP. |
--service-type |
تعيين نوع خدمة Kubernetes. القيم المدعومة هي: و و (افتراضي). |
--use-config-map |
استخدم كائن (v1) بدلاً من كائن كائن (v1) لتكوين إعدادات تطبيق الوظائف. يتم تعيين اسم الخريطة باستخدام . |
تستخدم Core Tools وDocker CLI المحلية لإنشاء الصورة ونشرها. تأكد من أن Docker مثبت محليًا بالفعل. بادر بتشغيل الأمر للاتصال بحسابك.
يدعم دالات Azure استضافة الوظائف الحاوية إما في Azure Container Apps أو في دالات Azure. تشغيل الحاويات الخاصة بك مباشرة في مجموعة Kubernetes أو في خدمة Azure Kubernetes (AKS) غير مدعوم رسميا من قبل دالات Azure. لمعرفة المزيد، راجع دعم حاوية Linux في دالات Azure.
func kubernetes install
يتم تثبيت KEDA في نظام مجموعة Kubernetes.
func kubernetes install
يتم تثبيت KEDA إلى نظام المجموعة المعرف في ملف التكوين kubectl.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--dry-run |
عرض قالب التوزيع، دون تنفيذ. |
--keda-version |
تعيين إصدار KEDA المطلوب تثبيته. الخيارات الصالحة هي: و (الافتراضي). |
--namespace |
دعم التثبيت إلى مساحة اسم Kubernetes معينة. عند عدم التعيين، يتم استخدام مساحة الاسم الافتراضية. |
لمعرفة المزيد، راجع إدارة KEDA والوظائف في Kubernetes.
func kubernetes remove
إزالة KEDA من نظام مجموعة Kubernetes المعرفة في ملف تكوين kubectl.
func kubernetes remove
إزالة KEDA من نظام المجموعة المعرف في ملف تكوين kubectl.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--namespace |
دعم إلغاء التثبيت من مساحة اسم Kubernetes معينة. عند عدم التعيين، يتم استخدام مساحة الاسم الافتراضية. |
لمعرفة المزيد، راجع إلغاء تثبيت KEDA من Kubernetes.
func settings add
إضافة إعداد جديد إلى المجموعة في الملف local.settings.json.
func settings add <SETTING_NAME> <VALUE>
بدلاً من استخدم اسم إعداد التطبيق وبدلاً من استخدم قيمة الإعداد.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connectionString |
إضافة أزواج اسم-قيمة إلى المجموعة بدلاً من المجموعة . استخدم المجموعة فقط عندما تطلبها أطر عمل معينة. لمعرفة المزيد، راجع الملف local.settings.json. |
func settings decrypt
فك تشفير القيم المشفرة مسبقًا في المجموعة في الملف local.settings.json.
func settings decrypt
كما يتم فك تشفير قيم سلسلة الاتصال في المجموعة . في local.settings.json، يتم أيضًا تعيين إلى . تشفير الإعدادات المحلية للحد من خطر تسرب معلومات قيمة من local.settings.js. في Azure، يتم تخزين إعدادات التطبيق دائما مشفرة.
func settings delete
إزالة إعداد موجود من المجموعة في الملف local.settings.json.
func settings delete <SETTING_NAME>
بدلاً من استخدم اسم إعداد التطبيق وبدلاً من استخدم قيمة الإعداد.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--connectionString |
إضافة أزواج اسم-قيمة إلى المجموعة بدلاً من المجموعة . |
func settings encrypt
تشفير قيم عناصر فردية في المجموعة في الملف local.settings.json.
func settings encrypt
كما يتم تشفير قيم سلسلة الاتصال في المجموعة . في local.settings.jsتشغيل، يتم أيضًا تعيين إلى ، الذي يحدد فكر تشفير التشغيل المحلي للإعدادات قبل استخدامها. تشفير الإعدادات المحلية للحد من خطر تسرب معلومات قيمة من local.settings.js. في Azure، يتم تخزين إعدادات التطبيق دائما مشفرة.
func settings list
إخراج قائمة بالإعدادات في المجموعة في الملف local.settings.json.
func settings list
كما يتم إخراج سلاسل الاتصال من المجموعة . وفقًا للإعدادات الافتراضية، يتم إخفاء القيم لأغراض الأمان. يمكنك أيضًا استخدام الخيار لعرض القيمة الفعلية.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--showValue |
إظهار القيم الفعلية غير المُخفاة في الإخراج. |
func templates list
سرد قوالب الوظائف (المشغلات) المتوفرة.
يدعم الإجراء الخيارات التالية:
| خيار | الوصف |
|---|---|
--language |
اللغة التي يتم تصفية القوالب التي تم إرجاعها لها. الإعداد الافتراضي هو إرجاع كل اللغات. |