مرجع Azure Functions Core Tools

توفر هذه المقالة وثائق مرجعية لـ Azure Functions Core Tools، والتي تتيح لك تطوير مشاريع Azure Functions وإدارتها وتوزيعها من الكمبيوتر المحلي. لمعرفة المزيد حول استخدام Core Tools، راجع العمل باستخدام Azure Functions Core Tools.

يتم تنظيم أوامر Core Tools في السياقات التالية، كل منها يوفر مجموعة فريدة من الإجراءات.

سياق الأمر ‏‏الوصف
func الأوامر المستخدمة لإنشاء الوظائف تشغيلها على الكمبيوتر المحلي.
func azure أوامر للعمل مع موارد Azure، بما في ذلك النشر.
func azurecontainerapps انشر تطبيق الوظائف الحاوية إلى Azure Container Apps.
func durable أوامر للعمل مع Durable Functions.
func extensions أوامر لتثبيت الملحقات وإدارتها.
func kubernetes أوامر للعمل مع Kubernetes وAzure Functions.
func settings أوامر لإدارة إعدادات البيئة لمضيف الوظائف المحلية.
func templates أوامر لسرد قوالب الوظائف المتوفرة.

قبل استخدام الأوامر في هذه المقالة، يجب عليك تثبيت Core Tools.

func init

يتم من خلالها إنشاء مشروع Functions جديد بلغة معينة.

func init <PROJECT_FOLDER>

عند توفير <PROJECT_FOLDER>، يتم إنشاء المشروع في مجلد جديد بهذا الاسم. وإلا، يتم استخدام المجلد الحالي.

func init يدعم الخيارات التالية، والتي لا تدعم الإصدار 1.x ما لم تتم الإشارة إلى خلاف ذلك:

خيار ‏‏الوصف
--csx ينشئ وظائف .NET على شكل برنامج C# نصي، وهو سلوك الإصدار 1.x. صالح فقط مع --worker-runtime dotnet.
--docker ينشيء Dockerfile لحاوية باستخدام صورة أساسية تستند إلى --worker-runtime المختار. استخدم هذا الخيار عندما تخطط لنشر تطبيق دالة في حاوية.
--docker-only يضيف Dockerfile إلى مشروع موجود. مطالبات لوقت تشغيل العامل إذا لم يتم تحديده أو تعيينه في local.settings.js. استخدم هذا الخيار عندما تخطط لنشر تطبيق دالة في حاوية والمشروع موجود بالفعل.
--force تتم تهيئة المشروع حتى عندما تكون هناك ملفات موجودة في المشروع. يتم من خلال هذا الإعداد الكتابة فوق الملفات الموجودة بنفس الاسم. لا تتأثر الملفات الأخرى في مجلد المشروع.
--language تتم تهيئة مشروع خاص بلغة معينة. يتم دعم ذلك حاليًا عند تعيين --worker-runtime إلى node. الخيارات هي typescript وjavascript. يمكنك أيضًا استخدام --worker-runtime javascript أو --worker-runtime typescript.
--managed-dependencies يتم تثبيت التبعيات المُدارة. حاليًا، لا يدعم هذه الوظيفة إلا وقت تشغيل عامل PowerShell.
--model تعيين نموذج البرمجة المطلوب للغة مستهدفة عند توفر أكثر من نموذج واحد. الخيارات المدعومة هي V1 و V2 ل Python و V3 V4 ل Node.js. لمزيد من المعلومات، راجع دليل مطور Python ودليل مطوري Node.js، على التوالي.
--source-control يتحكم في إنشاء مستودع git. بشكل افتراضي، لا يتم إنشاء مستودع. عند true، يتم إنشاء مستودع.
--worker-runtime تعيين وقت تشغيل اللغة للمشروع. القيم المدعومة هي: csharp وdotnet وdotnet-isolated وjavascript وnode (JavaScript) وpowershell وpython وtypescript. بالنسبة للغة Java، استخدم Maven. لإنشاء مشروع غير خاص بلغة محددة مع ملفات المشروع فقط، استخدم custom. عند عدم التعيين، ستتم مطالبتك باختيار وقت التشغيل أثناء التهيئة.
--target-framework تعيين إطار العمل الهدف لمشروع تطبيق الوظيفة. صالح فقط مع --worker-runtime dotnet-isolated. القيم المدعومة هي: 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>

يدعم الإجراء func logs الخيارات التالية:

خيار ‏‏الوصف
--platform نظام استضافة الأساسي لتطبيق الوظائف. الخيارات المدعومة: kubernetes.
--name اسم تطبيق الوظائف في Azure.

لمعرفة المزيد، راجع Azure Functions على Kubernetes مع KEDA.

func new

يتم من خلالها إنشاء وظيفة جديدة في المشروع الحالي استنادًا إلى قالب.

func new

عند التشغيل func new بدون --template الخيار، تتم مطالبتك باختيار قالب. في الإصدار 1.x، يطلب منك أيضا اختيار اللغة.

يدعم الإجراء func new الخيارات التالية:

خيار ‏‏الوصف
--authlevel يتيح لك تعيين مستوى التخويل لمشغل HTTP. القيم المدعومة هي: function وanonymous وadmin. لا يتم فرض التخويل عند التشغيل محليًا. لمزيد من المعلومات، راجع مستوى التخويل.
--csx (الإصدار 2.x والإصدارات الأحدث.) ينشئ نفس قوالب برنامج C# النصي (.csx) المستخدمة في الإصدار 1.x وفي المدخل.
--language, -l لغة برمجة القالب، مثل C# أو F# أو JavaScript. هذا الخيار مطلوب في الإصدار 1.x. في الإصدار 2.x والإصدارات الأحدث، لا تستخدم هذا الخيار لأن اللغة معرفة من قِبل وقت تشغيل العامل.
--name, -n اسم الوظيفة.
--template, -t استخدم الأمر func templates list لمشاهدة القائمة الكاملة للقوالب المتوفرة لكل لغة مدعومة.

لمعرفة المزيد، راجع إنشاء وظيفة.

func run

الإصدار 1.x فقط.

تتيح لك استدعاء وظيفة مباشرةً، وهو مشابه لتشغيل وظيفة باستخدام علامة التبويب اختبار في مدخل Azure. هذا الإجراء مدعوم فقط في الإصدار 1.x. بالنسبة للإصدارات الأحدث، استخدم func start وبادر باستدعاء نقطة النهاية الوظيفة مباشرةً.

func run

يدعم الإجراء func run الخيارات التالية:

خيار ‏‏الوصف
--content تم تمرير محتوى مضمن إلى الوظيفة.
--debug بادر بإرفاق مصحح الأخطاء إلى عملية المضيف قبل تشغيل الوظيفة.
--file اسم الملف المطلوب استخدامه كمحتوى.
--no-interactive لا يطالب بإدخال، وهو أمر مفيد لسيناريوهات التشغيل التلقائي.
--timeout وقت الانتظار (بالثواني) حتى يصبح مضيف الوظائف المحلي جاهزًا.

على سبيل المثال، لاستدعاء وظيفة تشغيل HTTP وتمرير نص المحتوى، بادر بتشغيل الأمر التالي:

func run MyHttpTrigger --content '{\"name\": \"Azure\"}'

func start

يتم من خلالها بدء تشغيل مضيف وقت التشغيل المحلي وتحميل مشروع الوظيفة في المجلد الحالي.

يعتمد الأمر المحدد على إصدار وقت التشغيل.

func start

يدعم func start الخيارات التالية:

خيار ‏‏الوصف
--cert المسار إلى ملف .pfx الذي يحتوي على مفتاح خاص. غير مدعوم إلا مع --useHttps.
--cors قائمة مفصولة بفاصلة لأصول CORS، بدون مسافات.
--cors-credentials السماح بالطلبات المصادق عليها عبر المنشأ باستخدام ملفات تعريف الارتباط ورأس المصادقة.
--dotnet-isolated-debug عند التعيين إلى true، يتم إيقاف عملية عامل .NET مؤقتًا حتى يتم إرفاق مصحح أخطاء من مشروع .NET المعزول الذي يتم تتبع أخطائه.
--enable-json-output تطرح سجلات وحدة التحكم بتنسيق JSON، حيثما أمكن.
--enableAuth تمكين البنية الأساسية لمعالجة المصادقة الكاملة، مع متطلبات التخويل.
--functions قائمة مفصولة بفواصل من الوظائف المطلوب تحميلها.
--language-worker الوسيطات المطلوبة لتكوين عامل اللغة. على سبيل المثال، يمكنك تمكين تصحيح الأخطاء لعامل اللغة عن طريق توفير منفذ تصحيح الأخطاء والوسيطات المطلوبة الأخرى.
--no-build تجنب إنشاء المشروع الحالي قبل التشغيل. لمشاريع فئة .NET فقط. الافتراضي هو false.
--password إما كلمة المرور أو ملف يحتوي على كلمة المرور لملف .pfx. يستخدم فقط مع --cert.
--port المنفذ المحلي للاستماع من عليه. القيمة الافتراضية: 7071.
--timeout مهلة بدء مضيف الوظائف، بالثواني. الافتراضي: 20 ثانية.
--useHttps ربط إلى https://localhost:{port} بدلاً من http://localhost:{port}. بشكل افتراضي، ينشئ هذا الخيار شهادة موثوق بها على الكمبيوتر الخاص بك.

مع تشغيل المشروع، يمكنك التحقق من نقاط نهاية الوظائف الفردية.

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>

func azure functionapp logstream

يتم من خلالها توصيل موجه الأوامر المحلي بسجلات الدفق لتطبيق الوظائف في Azure.

func azure functionapp logstream <APP_NAME>

المهلة الافتراضية للاتصال هي ساعتين. يمكنك تغيير المهلة بإضافة إعداد تطبيق بالاسم SCM_LOGSTREAM_TIMEOUT، مع عرض قيمة المهلة بالثواني. لم يتم دعم تطبيقات Linux في خطة الاستهلاك بعد. بالنسبة لهذه التطبيقات، استخدم الخيار --browser لعرض السجلات في المدخل.

يدعم الإجراء deploy الخيارات التالية:

خيار ‏‏الوصف
--browser افتح البث المباشر Azure Application Insights لتطبيق الوظائف في المستعرض الافتراضي.

لمزيد من المعلومات، راجع تمكين سجلات تنفيذ الدفق في Azure Functions.

func azure functionapp publish

يتم من خلالها تزيع مشروع الوظائف إلى مورد تطبيق وظائف موجود في Azure.

func azure functionapp publish <APP_NAME>

لمزيد من المعلومات، راجع توزيع ملفات المشروع.

تنطبق خيارات النشر التالية، استنادًا إلى الإصدار:

خيار ‏‏الوصف
--access-token يتيح لك استخدام رمز وصول مميز معين عند تنفيذ إجراءات مصادق عليها azure .
--access-token-stdin يقرأ رمز وصول معينا من إدخال قياسي. استخدم هذا عند قراءة الرمز المميز مباشرة من أمر سابق مثل az account get-access-token.
--additional-packages قائمة بالحزم المطلوب تثبيتها عند إنشاء التبعيات الأصلية. على سبيل المثال: python3-dev libevent-dev.
--build, -b يتم من خلالها تنفيذ إجراء بنية عند التوزيع إلى تطبيق وظائف Linux. يقبل: remote و local.
--build-native-deps يتخطى إنشاء المجلد .wheels عند نشر تطبيقات الوظائف Python.
--csx انشر مشروع برنامج C# النصي (.csx).
--dotnet-cli-params عند نشر وظائف C# المحولة برمجيًا (.csproj)، تستدعي core tools dotnet build --output bin/publish. يتم إلحاق أي معلمات تم تمريرها إلى هذا إلى سطر الأوامر.
--force تجاهل التحقق المنشور مسبقا في سيناريوهات معينة.
--list-ignored-files يتم من خلالها عرض قائمة بالملفات التي يتم تجاهلها أثناء النشر، والتي تستند إلى الملف .funcignore.
--list-included-files تعرض قائمة بالملفات التي يتم نشرها، والتي تستند إلى الملف .funcignore.
--management-url تعيين عنوان URL للإدارة للسحابة الخاصة بك. استخدم هذا عند التشغيل في سحابة ذات سيادة.
--no-build لم يتم بناء المشروع أثناء النشر. بالنسبة للغة Python، لا يتم تنفيذ pip install.
--nozip تعمل على إيقاف تشغيل الوضع Run-From-Package الافتراضي.
--overwrite-settings -y منع المطالبة بالكتابة فوق إعدادات التطبيق عند استخدام --publish-local-settings -i.
--publish-local-settings -i نشر الإعدادات في local.settings.json إلى Azure، مما يطالبك بالكتابة فوق إذا كانت الإعدادات موجودة بالفعل. إذا كنت تستخدم محاكي تخزين محلي، فقم أولا بتغيير إعداد التطبيق إلى اتصال تخزين فعلي.
--publish-settings-only, -o فقط نشر الإعدادات وتخطي المحتوى. الإعداد الافتراضي هو مطالبة.
--slot اسم اختياري لفتحة محددة المطلوب النشر إليها.
--subscription تعيين الاشتراك الافتراضي لاستخدامه.

func azure storage fetch-connection-string

يتم الحصول على سلسلة الاتصال لحساب Azure Storage المحدد.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

لمزيد من المعلومات، راجع تنزيل سلسلة الاتصال تخزين.

func azurecontainerapps deploy

نشر تطبيق دالة في حاوية إلى بيئة Azure Container Apps. يجب أن يكون كل من حساب التخزين المستخدم من قبل تطبيق الوظائف والبيئة موجودا بالفعل. لمزيد من المعلومات، راجع استضافة Azure Container Apps ل Azure Functions.

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>

تنطبق خيارات النشر التالية:

خيار ‏‏الوصف
--access-token يتيح لك استخدام رمز وصول مميز معين عند تنفيذ إجراءات مصادق عليها azure .
--access-token-stdin يقرأ رمز وصول معينا من إدخال قياسي. استخدم هذا عند قراءة الرمز المميز مباشرة من أمر سابق مثل az account get-access-token.
--environment اسم بيئة Container Apps الموجودة.
--image-build عند التعيين إلى true، يتخطى بناء Docker المحلي.
--image-name اسم صورة حاوية موجودة في سجل حاوية. يتضمن اسم الصورة اسم العلامة.
--location المنطقة الخاصة بالنشر. من الناحية المثالية، هذه هي نفس المنطقة مثل موارد حساب البيئة والتخزين.
--management-url تعيين عنوان URL للإدارة للسحابة الخاصة بك. استخدم هذا عند التشغيل في السحابة السيادية.
--name الاسم المستخدم لنشر تطبيق الوظائف في بيئة Container Apps. يستخدم هذا الاسم نفسه أيضا عند إدارة تطبيق الوظائف في المدخل. يجب أن يكون الاسم فريدا في البيئة.
--registry عند التعيين، يتم تشغيل بناء Docker ويتم دفع الصورة إلى مجموعة التسجيل في --registry. لا يمكنك استخدام --registry مع --image-name. بالنسبة إلى Docker Hub، استخدم --registry-usernameأيضا .
--registry-password كلمة المرور أو الرمز المميز المستخدم لاسترداد الصورة من سجل خاص.
--registry-username اسم المستخدم المستخدم لاسترداد الصورة من سجل خاص.
--resource-group مجموعة الموارد التي سيتم فيها إنشاء الموارد المتعلقة بالوظائف.
--storage-account سلسلة الاتصال لحساب التخزين الذي سيتم استخدامه بواسطة تطبيق الوظائف.
--subscription تعيين الاشتراك الافتراضي لاستخدامه.
--worker-runtime تعيين لغة وقت التشغيل لتطبيق الوظائف. يتم استخدام هذه المعلمة فقط مع --image-name و --image-build، وإلا يتم تحديد اللغة أثناء الإنشاء المحلي. القيم المدعومة هي: dotnetو dotnetIsolatednodeو pythonpowershellcustom (لمعالجات العملاء).

هام

تعد سلسلة الاتصال التخزين وبيانات اعتماد الخدمة الأخرى أسرارا مهمة. تأكد من تخزين أي ملفات برامج نصية بأمان باستخدام func azurecontainerapps deploy ولا تخزنها في أي عنصر تحكم مصدر يمكن الوصول إليه بشكل عام.

func deploy

تم func deploy إهمال الأمر. بدلا من ذلك، استخدم func kubernetes deploy.

func durable delete-task-hub

تحذف كل البيانات الاصطناعية الملموسة في مركز مهام Durable Functions.

func durable delete-task-hub

يدعم الإجراء delete-task-hub الخيارات التالية:

خيار ‏‏الوصف
--connection-string-setting اسم اختياري للإعداد الذي يحتوي على سلسلة اتصال التخزين المراد استخدامها.
--task-hub-name اسم اختياري لمركز مهام Durable المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func durable get-history

ترجع محفوظات مثيل التنظيم المحدد.

func durable get-history --id <INSTANCE_ID>

يدعم الإجراء get-history الخيارات التالية:

خيار ‏‏الوصف
--id يحدد معرف مثيل التنظيم (مطلوب).
--connection-string-setting اسم اختياري للإعداد الذي يحتوي على سلسلة اتصال التخزين المراد استخدامها.
--task-hub-name اسم اختياري لمركز مهام Durable المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func durable get-instances

ترجع حالة كل مثيلات التنظيم. يدعم التقسيم المرحلي باستخدام المعلمة top.

func durable get-instances

يدعم الإجراء get-instances الخيارات التالية:

خيار ‏‏الوصف
--continuation-token الرمز المميز الاختياري الذي يشير إلى صفحة/مقطع معين من الطلبات المطلوب إرجاعها.
--connection-string-setting اسم اختياري لإعدادات التطبيق الذي يحتوي على سلسلة اتصال التخزين المطلوب استخدامها.
--created-after اختياريًا، احصل على المثيلات التي تم إنشاؤها بعد هذا التاريخ/الوقت (UTC). يتم قبول كل التواريخ والأوقات بالتنسيق ISO 8601.
--created-before اختياريًا، احصل على المثيلات التي تم إنشاؤها قبل تاريخ/وقت (UTC) محدد. يتم قبول كل التواريخ والأوقات بالتنسيق ISO 8601.
--runtime-status اختياريًا، احصل على المثيلات التي تطابق حالتها حالة معينة، بما في ذلك running، completed، و failed. يمكنك توفير حالة واحدة أو أكثر يُفصل بينها بفواصل.
--top يمكنك اختياريًا قصر عدد السجلات التي يتم إرجاعها في طلب معين.
--task-hub-name اسم اختياري لمركز مهام Durable Functions المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func durable get-runtime-status

ترجع حالة مثيل التنظيم المحدد.

func durable get-runtime-status --id <INSTANCE_ID>

يدعم الإجراء get-runtime-status الخيارات التالية:

خيار ‏‏الوصف
--connection-string-setting اسم اختياري للإعداد الذي يحتوي على سلسلة اتصال التخزين المراد استخدامها.
--id يحدد معرف مثيل التنظيم (مطلوب).
--show-input عند التعيين، تحتوي الاستجابة على إدخال الوظيفة.
--show-output عند التعيين، تحتوي الاستجابة على محفوظات التنفيذ.
--task-hub-name اسم اختياري لمركز مهام Durable Functions المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func durable purge-history

إزالة حالة مثيل التنظيم ومحفوظاته وتخزين blob لعمليات التنظيم الأقدم من الحد المحدد.

func durable purge-history

يدعم الإجراء purge-history الخيارات التالية:

خيار ‏‏الوصف
--connection-string-setting اسم اختياري للإعداد الذي يحتوي على سلسلة اتصال التخزين المراد استخدامها.
--created-after اختياريًا، احذف محفوظات المثيلات التي تم إنشاؤها بعد هذا التاريخ/الوقت (UTC). يتم قبول كل قيم التاريخ والوقت بالتنسيق ISO 8601.
--created-before اختياريًا، احذف محفوظات المثيلات التي تم إنشاؤها قبل هذا التاريخ/الوقت (UTC). يتم قبول كل قيم التاريخ والوقت بالتنسيق ISO 8601.
--runtime-status اختياريًا، احذف محفوظات المثيلات التي تطابق حالتها حالة معينة، بما في ذلك completd وterminated وcanceled وfailed. يمكنك توفير حالة واحدة أو أكثر يُفصل بينها بفواصل. في حالة عدم تضمين --runtime-status، يتم حذف سجل المثيل بغض النظر عن الحالة.
--task-hub-name اسم اختياري لمركز مهام Durable Functions المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func durable raise-event

تنفيذ حدث على مثيل التنظيم المحدد.

func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>

يدعم الإجراء raise-event الخيارات التالية:

خيار ‏‏الوصف
--connection-string-setting اسم اختياري للإعداد الذي يحتوي على سلسلة اتصال التخزين المراد استخدامها.
--event-data البيانات المطلوب تمريرها إلى الحدث، سواء مضمنة أو من ملف JSON (مطلوب). بالنسبة للملفات، ضع قبل المسار إلى الملف علامة العطف (@)، مثل @path/to/file.json.
--event-name اسم الحدث المطلوب تنفيذه (مطلوب).
--id يحدد معرف مثيل التنظيم (مطلوب).
--task-hub-name اسم اختياري لمركز مهام Durable Functions المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func durable rewind

إرجاع مثيل التنظيم المحدد.

func durable rewind --id <INSTANCE_ID> --reason <REASON>

يدعم الإجراء rewind الخيارات التالية:

خيار ‏‏الوصف
--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>

يدعم الإجراء start-new الخيارات التالية:

خيار ‏‏الوصف
--connection-string-setting اسم اختياري للإعداد الذي يحتوي على سلسلة اتصال التخزين المراد استخدامها.
--function-name اسم وظيفة المنسق لبدء التشغيل.
--id يحدد معرف مثيل التنظيم (مطلوب).
--input إدخال وظيفة التنظيم، سواء مضمنة أو من ملف JSON (مطلوب). بالنسبة للملفات، ضع قبل المسار إلى الملف علامة العطف (@)، مثل @path/to/file.json.
--task-hub-name اسم اختياري لمركز مهام Durable Functions المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func durable terminate

إيقاف مثيل التنظيم المحدد.

func durable terminate --id <INSTANCE_ID> --reason <REASON>

يدعم الإجراء terminate الخيارات التالية:

خيار ‏‏الوصف
--connection-string-setting اسم اختياري للإعداد الذي يحتوي على سلسلة اتصال التخزين المراد استخدامها.
--id يحدد معرف مثيل التنظيم (مطلوب).
--reason سبب إيقاف التنظيم (مطلوب).
--task-hub-name اسم اختياري لمركز مهام Durable Functions المطلوب استخدامه.

لمعرفة المزيد، راجع وثائق Durable Functions.

func extensions install

تثبيت ملحقات الوظائف يدويا في مشروع non-.NET أو في مشروع برنامج نصي C#‎.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>

يدعم الإجراء install الخيارات التالية:

خيار ‏‏الوصف
--configPath مسار الدليل الذي يحتوي على ملف extensions.csproj.
--csx يدعم مشاريع برنامج C# النصي (.csx).
--force تحديث إصدارات الملحقات الموجودة.
--output مسار الإخراج للملحقات.
--package معرف حزمة ملحق محددة. عند عدم التحديد، يتم تثبيت الملحقات المشار إليها، كما هو الحال مع func extensions sync.
--source مصدر موجز NuGet عند عدم استخدام NuGet.org.
--version إصدار حزمة ملحق.

يقوم المثال التالي بتثبيت الإصدار 5.0.1 من ملحق مراكز الأحداث في المشروع المحلي:

func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1

تنطبق الاعتبارات التالية عند استخدام func extensions install:

  • لمشاريع C# المحولة برمجيا (كل من عملية عامل قيد المعالجة وعملية عامل معزولة)، بدلا من ذلك استخدم أساليب تثبيت حزمة NuGet القياسية، مثل dotnet add package.

  • لتثبيت الملحقات يدويا باستخدام Core Tools، يجب أن يكون لديك .NET SDK مثبتا .

  • عندما يكون ذلك ممكنا، يجب عليك بدلا من ذلك استخدام حزم الملحقات. فيما يلي بعض الأسباب التي قد تدفعك إلى تثبيت الملحقات يدويا:

    • تحتاج إلى الوصول إلى إصدار محدد من ملحق غير متوفر في مجموعة.
    • تحتاج إلى الوصول إلى ملحق مخصص غير متوفر في مجموعة.
    • تحتاج إلى الوصول إلى مجموعة محددة من الملحقات غير متوفرة في مجموعة واحدة.
  • قبل أن تتمكن من تثبيت الملحقات يدويا، يجب أولا إزالة extensionBundle الكائن من ملف host.json الذي يعرف المجموعة. لا يتم اتخاذ أي إجراء عند تعيين حزمة ملحق بالفعل في ملف host.json.

  • في المرة الأولى التي تقوم فيها بتثبيت ملحق بشكل صريح، تتم إضافة ملف مشروع .NET يسمى extensions.csproj إلى جذر مشروع التطبيق الخاص بك. يُعرف هذا الملف مجموعة حزم NuGet المطلوبة من قبل الوظائف الخاصة بك. بينما يمكنك العمل مع مراجع حزمة NuGet في هذا الملف، تتيح لك Core Tools تثبيت الملحقات دون الحاجة إلى تحرير ملف المشروع C# يدوياً.

func extensions sync

يتم تثبيت كل الملحقات المضافة إلى تطبيق الوظائف.

يدعم الإجراء sync الخيارات التالية:

خيار ‏‏الوصف
--configPath مسار الدليل الذي يحتوي على ملف extensions.csproj.
--csx يدعم مشاريع برنامج C# النصي (.csx).
--output مسار الإخراج للملحقات.

إعادة إنشاء ملف extensions.csproj مفقود. لا يتم اتخاذ أي إجراء عند تعريف حزمة ملحق في ملف host.json لديك.

func kubernetes deploy

يتم توزيع مشروع الوظائف على شكل حاوية docker مخصصة إلى نظام مجموعة Kubernetes.

func kubernetes deploy 

ينشئ هذا الأمر المشروع على شكل حاوية مخصصة وينشره إلى نظام مجموعة Kubernetes. يجب أن تحتوي الحاويات المخصصة على Dockerfile. لإنشاء تطبيق باستخدام Dockerfile، استخدم --dockerfile الخيار مع func init الأمر .

تتوفر خيارات توزيع Kubernetes التالية:

خيار ‏‏الوصف
--dry-run تعرض اختيارًا قالب التوزيع، دون تنفيذ.
--config-map-name اسم اختياري لخريطة تكوين موجودة مع إعدادات تطبيق الوظائف لاستخدامها في التوزيع. يلزم توفر --use-config-map. السلوك الافتراضي هو إنشاء الإعدادات استنادًا إلى الكائن Values في ملف local.settings.json.
--cooldown-period فترة التهدئة (بالثواني) بعد أن تكون كل المشغلات غير نشطة قبل أن يتراجع حجم التوزيع إلى الصفر، مع وجود القيمة الافتراضي 300 ثانية.
--ignore-errors متابعة التوزيع بعد إرجاع المورد لخطأ. السلوك الافتراضي هو التوقف عند وقوع خطأ.
--image-name اسم الصورة المطلوب استخدامها لتوزيع pod والمطلوب قراءة الوظائف منه.
--keda-version تعيين إصدار KEDA المطلوب تثبيته. الخيارات الصالحة هي: v1 وv2 (الافتراضي).
--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 ودفع الصورة إلى سجل بهذا الاسم. لا يمكنك استخدام --registry مع --image-name. بالنسبة لـ Docker، استخدم اسم المستخدم لديك.
--polling-interval الفاصل الزمني للاستقصاء (بالثواني) للتحقق من مشغلات لا تتبع HTTP، مع تحديد القيمة الافتراضية بالقيمة 30 ثانية.
--pull-secret السر المستخدم للوصول إلى بيانات اعتماد التسجيل الخاص.
--secret-name اسم مجموعة أسرار Kubernetes الموجودة التي تحتوي على إعدادات تطبيق الوظائف لاستخدامها في التوزيع. السلوك الافتراضي هو إنشاء الإعدادات استنادًا إلى الكائن Values في ملف local.settings.json.
--show-service-fqdn يعرض عناوين URL لمشغلات HTTP باستخدام Kubernetes FQDN بدلاً من السلوك الافتراضي لاستخدام عنوان IP.
--service-type تعيين نوع خدمة Kubernetes. القيم المدعومة هي: ClusterIP وNodePort وLoadBalancer (افتراضي).
--use-config-map استخدم كائن ConfigMap (v1) بدلاً من كائن Secret كائن (v1) لتكوين إعدادات تطبيق الوظائف. يتم تعيين اسم الخريطة باستخدام --config-map-name.

تستخدم Core Tools وDocker CLI المحلية لإنشاء الصورة ونشرها. تأكد من أن Docker مثبت محليًا بالفعل. بادر بتشغيل الأمر docker login للاتصال بحسابك.

تدعم Azure Functions استضافة وظائفك الحاوية إما في Azure Container Apps أو في Azure Functions. تشغيل الحاويات الخاصة بك مباشرة في مجموعة Kubernetes أو في Azure Kubernetes Service (AKS) غير مدعوم رسميا من قبل Azure Functions. لمعرفة المزيد، راجع دعم حاوية Linux في Azure Functions.

func kubernetes install

يتم تثبيت KEDA في نظام مجموعة Kubernetes.

func kubernetes install 

يتم تثبيت KEDA إلى نظام المجموعة المعرف في ملف التكوين kubectl.

يدعم الإجراء install الخيارات التالية:

خيار ‏‏الوصف
--dry-run عرض قالب التوزيع، دون تنفيذ.
--keda-version تعيين إصدار KEDA المطلوب تثبيته. الخيارات الصالحة هي: v1 وv2 (الافتراضي).
--namespace دعم التثبيت إلى مساحة اسم Kubernetes معينة. عند عدم التعيين، يتم استخدام مساحة الاسم الافتراضية.

لمعرفة المزيد، راجع إدارة KEDA والوظائف في Kubernetes.

func kubernetes remove

إزالة KEDA من نظام مجموعة Kubernetes المعرفة في ملف تكوين kubectl.

func kubernetes remove 

إزالة KEDA من نظام المجموعة المعرف في ملف تكوين kubectl.

يدعم الإجراء remove الخيارات التالية:

خيار ‏‏الوصف
--namespace دعم إلغاء التثبيت من مساحة اسم Kubernetes معينة. عند عدم التعيين، يتم استخدام مساحة الاسم الافتراضية.

لمعرفة المزيد، راجع إلغاء تثبيت KEDA من Kubernetes.

func settings add

إضافة إعداد جديد إلى المجموعة Values في الملف local.settings.json.

func settings add <SETTING_NAME> <VALUE>

بدلاً من <SETTING_NAME> استخدم اسم إعداد التطبيق وبدلاً من <VALUE> استخدم قيمة الإعداد.

يدعم الإجراء add الخيارات التالية:

خيار ‏‏الوصف
--connectionString إضافة أزواج اسم-قيمة إلى المجموعة ConnectionStrings بدلاً من المجموعة Values. استخدم المجموعة ConnectionStrings فقط عندما تطلبها أطر عمل معينة. لمعرفة المزيد، راجع الملف local.settings.json.

func settings decrypt

فك تشفير القيم المشفرة مسبقًا في المجموعة Values في الملف local.settings.json.

func settings decrypt

كما يتم فك تشفير قيم سلسلة الاتصال في المجموعة ConnectionStrings. في local.settings.json، يتم أيضًا تعيين IsEncrypted إلى false. تشفير الإعدادات المحلية للحد من خطر تسرب معلومات قيمة من local.settings.js. في Azure، يتم دائمًا تخزين إعدادات التطبيق مشفرةً.

func settings delete

إزالة إعداد موجود من المجموعة Values في الملف local.settings.json.

func settings delete <SETTING_NAME>

بدلاً من <SETTING_NAME> استخدم اسم إعداد التطبيق وبدلاً من <VALUE> استخدم قيمة الإعداد.

يدعم الإجراء delete الخيارات التالية:

خيار ‏‏الوصف
--connectionString إضافة أزواج اسم-قيمة إلى المجموعة ConnectionStrings بدلاً من المجموعة Values.

func settings encrypt

تشفير قيم عناصر فردية في المجموعة Values في الملف local.settings.json.

func settings encrypt

كما يتم تشفير قيم سلسلة الاتصال في المجموعة ConnectionStrings. في local.settings.jsتشغيل، يتم أيضًا تعيين IsEncrypted إلى true، الذي يحدد فكر تشفير التشغيل المحلي للإعدادات قبل استخدامها. تشفير الإعدادات المحلية للحد من خطر تسرب معلومات قيمة من local.settings.js. في Azure، يتم دائمًا تخزين إعدادات التطبيق مشفرةً.

func settings list

إخراج قائمة بالإعدادات في المجموعة Values في الملف local.settings.json.

func settings list

كما يتم إخراج سلاسل الاتصال من المجموعة ConnectionStrings. وفقًا للإعدادات الافتراضية، يتم إخفاء القيم لأغراض الأمان. يمكنك أيضًا استخدام الخيار --showValue لعرض القيمة الفعلية.

يدعم الإجراء list الخيارات التالية:

خيار ‏‏الوصف
--showValue إظهار القيم الفعلية غير المُخفاة في الإخراج.

func templates list

سرد قوالب الوظائف (المشغلات) المتوفرة.

يدعم الإجراء list الخيارات التالية:

خيار ‏‏الوصف
--language اللغة التي يتم تصفية القوالب التي تم إرجاعها لها. الإعداد الافتراضي هو إرجاع كل اللغات.