دالات Azure local runtime and tools reference

توفر هذه المقالة وثائق مرجعية لوقت التشغيل المحلي والأدوات التي تدعم دالات Azure. استخدم هذه الأدوات لتطوير وإدارة وتشغيل مشاريع دالات Azure من جهاز الكمبيوتر المحلي الخاص بك. الاسم الثنائي هو func (أو func.exe على Windows).

تجربتان في التطوير المحلي تصدران كfunc.exe: دالات Azure Core Tools (GA) و دالات Azure CLI (المعاينة). استخدم المحدد لاختيار التجربة التي ستعرضها.

هام

دالات Azure CLI (v5) حاليا قيد المعاينة. هذه النسخة التجريبية لا تدعم بعد Java وPowerShell. للعمل مع لغات غير مدعومة حاليا، استمر في استخدام دالات Azure Core Tools v4.

هناك أداتان لسطر الأوامر تصدران كما func.exe هو الحال في دالات Azure:

أدوات دالات Azure الأساسية دالات Azure CLI
func.exe النسخة v4 v5
مستوى الدعم التوافر العام (GA) معاينة
تثبيت القدم ثنائية كاملة تشمل جميع الأوامر والقدرات لجميع اللغات الأصلية. تثبيت قاعدة صغيرة، بالإضافة إلى أعباء عمل لكل لغة وميزات أخرى تضيفها حسب الحاجة. المضيف يشحن كعبء عمل مستقل، لذا تحصل على أحدث إصدار للمضيف دون الحاجة لإعادة تحميل ملف السطوع.
استخدم عندما... تحتاج إلى دعم كامل لخدمات التطوير لجميع سير العمل في التطوير. تريد تجربة خفيفة تعتمد على عبء العمل مع ميزات جديدة مثل قوالب البدء السريع وملفات تعريف تحافظ على تزامن بيئتك المحلية مع إعدادات خطة استضافة Azure الخاصة بك.

لمعرفة المزيد حول استخدام Core Tools، راجع Work مع دالات Azure Core Tools.

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

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

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

هام

دالات Azure CLI (v5) حاليا قيد المعاينة. هذه النسخة التجريبية لا تدعم بعد Java وPowerShell. للعمل مع لغات غير مدعومة حاليا، استمر في استخدام دالات Azure Core Tools v4.

لمعرفة المزيد عن استخدام سطر الوصول، بما في ذلك التثبيت وأعباء العمل، راجع تطوير دالات Azure محليا باستخدام دالات Azure CLI.

الأوامر المدمجة التالية تأتي مع تثبيت وحدة التحكم الأساسية:

القيادة ‏‏الوصف
func init قم بتهيئة مشروع دالات Azure جديد.
func new أنشئ دالة جديدة من قالب.
func run تشغيل دالات Azure host runtime محليا. func start هو اسم مستعار متوافق مع الإصدارات السابقة.
func quickstart تصفح وجمع تطبيقات الوظائف الكاملة من كتالوج قوالب البدء السريع.
func profile Inspect and manage دالات Azure CLI profiles.
func setup Prepare دالات Azure المحلي لاعتماديات CLI (وقت تشغيل المضيف، عمال اللغة، حزم الإضافات).
func workload إدارة أعباء عمل CLI المثبتة.

قد تساهم أعباء العمل بأوامر إضافية في المستوى الأعلى. تظهر هذه الأوامر فقط بعد تثبيت عبء العمل المساهم.

func init

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

func init [<PROJECT_FOLDER>]

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

يدعم الأمر func init هذه الخيارات، والتي تعتمد على الإصدار:

خيار ‏‏الوصف
--bundles-channel، -c قناة إصدار مجموعة الملحقات. القيم المدعومة هي: GA (افتراضي) Previewو و.Experimental ينطبق فقط على المشاريع غير .NET.
--configuration-profile تهيئة مشروع بملف تعريف تكوين مضيف. --configuration-profile الخيار قيد المعاينة حاليا. لمزيد من المعلومات، راجع ملفات تعريف التكوين.
--csx ينشئ .NET يعمل كسكريبت C#‎. صالح فقط مع --worker-runtime dotnet.
--docker ينشئ ملف Dockerfile لحاوية باستخدام صورة أساسية مبنية على الصورة المختارة --worker-runtime. استخدم هذا الخيار عندما تخطط لنشر تطبيق دالة في حاوية.
--docker-only يضيف Dockerfile إلى مشروع موجود. يطالب بوقت تشغيل العامل إذا لم يتم تحديده أو تعيينه في local.settings.json. استخدم هذا الخيار عندما تخطط لنشر تطبيق دالة في حاوية والمشروع موجود بالفعل.
--force يقوم بتهيئة المشروع حتى عندما تكون هناك ملفات موجودة في المشروع. يتم من خلال هذا الإعداد الكتابة فوق الملفات الموجودة بنفس الاسم. لا تتأثر الملفات الأخرى في مجلد المشروع.
--language، -l تتم تهيئة مشروع خاص بلغة معينة. مدعوم حاليا عند --worker-runtime تعيين إلى node. الخيارات هي typescript وjavascript. يمكنك أيضًا استخدام --worker-runtime javascript أو --worker-runtime typescript.
--managed-dependencies يتم تثبيت التبعيات المُدارة. حاليا، يدعم وقت تشغيل عامل PowerShell فقط هذه الميزة.
--model، -m تعيين نموذج البرمجة للغة مستهدفة عند توفر أكثر من نموذج واحد. الخيارات المدعومة هي V1 و V2 Python، و V3 و V4 Node.js. لمزيد من المعلومات، راجع دليل المطور Python ودليل المطور Node.js.
--no-bundle لا تقم بتكوين مجموعة الملحقات في host.json. ينطبق فقط على المشاريع غير .NET.
--no-docs يتخطى إنشاء ملفات وثائق "البدء". ينطبق على المشاريع Python.
--skip-npm-install تخطي التشغيل npm install بعد إنشاء المشروع. ينطبق على المشاريع Node.js.
--source-control يتحكم في ما إذا كان يتم إنشاء مستودع Git. بشكل افتراضي، لا يتم إنشاء مستودع. عند true، يتم إنشاء مستودع.
--worker-runtime تعيين وقت تشغيل اللغة للمشروع. القيم المدعومة هي: csharpو dotnetو dotnet-isolatedو javascriptو node و (JavaScript) powershellpythonو.typescript على سبيل Java، استخدم Maven. لإنشاء مشروع غير خاص بلغة محددة مع ملفات المشروع فقط، استخدم custom. عند عدم التعيين، ستتم مطالبتك باختيار وقت التشغيل أثناء التهيئة.
--target-framework تعيين إطار العمل الهدف لمشروع تطبيق الوظيفة. صالح فقط مع --worker-runtime dotnet-isolated. القيم المدعومة هي: 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 يدويا. لمزيد من المعلومات، راجع إنشاء تطبيقات الوظائف المعبأة في حاويات.

ملفات تعريف التكوين

هام

دعم ملفات تعريف التكوين قيد المعاينة حاليا.

عند استخدام الخيار --configuration-profile ، تنشئ مجموعة محددة مسبقا من تكوينات وإعدادات المشروع. عند تحديد ملف تعريف تكوين، قد تتخطى التهيئة جميع خطوات التهيئة الأخرى.

قيمة ملف التعريف ‏‏الوصف إجراءات محددة
mcp-custom-handler إنشاء مشروع يستخدم معالجات مخصصة لاستضافة خادم MCP (بروتوكول سياق النموذج) الذي يمكن لوكلاء الذكاء الاصطناعي وعملاء MCP الآخرين الاتصال به. • تكوين "configurationProfile": "mcp-custom-handler" العنصر في ملف host.json بإعدادات معالج مخصص محددة.
• يعين MCP_EXTENSION_ENABLED إلى true في local.settings.json.		 
func init [<PATH>] [options]

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

يدعم الأمر func init هذه الخيارات المدمجة:

خيار ‏‏الوصف
--stack، -s التكديس المستخدم للمشروع (على سبيل المثال، python، node، dotnet، go). شغل func workload list لرؤية التكديس التي ساهمت بها أحمال العمل المثبتة لديك.
--name، -n اسم مشروع تطبيق الوظائف.
--language، -l لغة البرمجة (على سبيل المثال، C#‎، F#‎، JavaScript، TypeScript، Python). يستخدم عندما يدعم المكدس أكثر من لغة واحدة. يتم حساب القيم المدعومة من أحمال عمل المكدس المثبتة.
--force أعد التهيئة حتى عندما لا يكون المجلد المستهدف فارغا. يمسح المجلد (إلا .git) قبل تركيب السقالات.

تساهم أعباء العمل بخيارات إضافية تجمع تحت اسم عبء العمل في func init --help. راجع الخيارات الخاصة بعبء العمل لخيارات كل مكدس.

إذا لم يوفر عبء العمل المكدس المطلوب، يطبع مؤشر القيادة تلميحا يشير إلى func workload install ويخرج برمز خروج غير صفري.

خيارات خاصة بحجم العمل

يتسع الأمر init عند تثبيت واحد أو أكثر من هذه الأحمال العملية:

خيار ‏‏الوصف
--target-framework، -tfm إطار العمل .NET المستهدف للمشروع (على سبيل المثال، net10.0). افتراضي: net10.0.

المهيئ .NET لا يكتب كتلة حزمة امتداد، لذا --no-bundles و --bundles-channel غير مناسبين.

عندما يساهم أكثر من عبء عمل مثبت بنفس الخيار، يظهر الخيار مرة واحدة في func init --help.

الخيارات المشتركة

حاليا، الخيارات المشتركة هي --no-bundles و --bundles-channel. معرف حزمة الامتداد الافتراضي الذي تكتبه host.json يعتمد على القناة المختارة:

القناة معرف الحزمة
GA (افتراضي) Microsoft.Azure.Functions.ExtensionBundle
Preview Microsoft.Azure.Functions.ExtensionBundle.Preview
Experimental Microsoft.Azure.Functions.ExtensionBundle.Experimental

النطاق الافتراضي للإصدارات هو [4.*, 5.0.0).

func new

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

func new

يدعم الأمر func new هذه الخيارات، والتي تعتمد على الإصدار:

خيار ‏‏الوصف
--authlevel، -a تعيين مستوى التخويل لمشغل HTTP. القيم المدعومة هي: function وanonymous وadmin. لا يتم فرض التخويل عند التشغيل محليًا. لمزيد من المعلومات، راجع مستوى التخويل.
--csx تولد نفس قوالب سكريبت C# (.csx) المستخدمة في الإصدار 1 وفي البوابة.
--file، -f الملف الهدف للدالة الجديدة. بالنسبة لمشاريع Python v2، يحدد الملف الذي تريد إضافة الدالة إليه (الإعدادات الافتراضية إلى function_app.py). بالنسبة لمشاريع Node.js v4، يحدد اسم ملف الإخراج في src/functions المجلد. لا ينطبق على مشاريع .NET المحولة برمجيا.
--name، -n اسم الوظيفة.
--template، -t استخدم الأمر func templates list لمشاهدة القائمة الكاملة للقوالب المتوفرة لكل لغة مدعومة.

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

func new [<PATH>] [options]

هام

func new هو حاليا جزء تمهيدي. يطبع تلميحا لتثبيت عبء العمل ويخرج برمز خروج غير صفري حتى يتم تثبيت عبء القالب وتوصيله سلكيا. الخيارات الخاصة بالقالب يتم رطبها ديناميكيا من بيانات القالب الوصفية، لذا إضافة خيار قالب جديد لا يتطلب إصدار CLI.

يدعم الأمر func new هذه الخيارات المدمجة:

خيار ‏‏الوصف
--name، -n اسم الوظيفة.
--template، -t اسم قالب الوظيفة. تأتي القوالب المتاحة من عبء العمل المثبت <stack>-templates لمكدس المشروع.
--force الكتابة فوق الملفات الموجودة.

يتم إضافة خيارات إضافية بشكل ديناميكي من خلال القالب المختار. قم بالعمل func new --template <name> --help لرؤية الخيارات لقالب معين.

إذا لم يتم تثبيت عبء عمل القوالب للمشروع الحالي، يطبع مؤشر السطر تلميحا يشير إلى func workload install.

func logs

يتم من خلالها الحصول على سجلات للوظائف قيد التشغيل في نظام مجموعة Kubernetes.

func logs --platform kubernetes --name <APP_NAME>

func logs يدعم الأمر هذه الخيارات:

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

لمزيد من المعلومات، راجع دالات Azure على Kubernetes مع KEDA.

func pack

إنشاء حزمة توزيع تحتوي على التعليمات البرمجية لمشروعك في حالة قابلة للتشغيل. استخدم هذا الأسلوب عندما تحتاج إلى إنشاء حزمة توزيع لتطبيقك يدويا على الكمبيوتر المحلي خارج func azure functionapp publish الأمر. بشكل افتراضي، func pack ينشئ مشروعك عند الحاجة.

بالنسبة لتطبيقات وظائف Go، يقوم func pack ببناء حزمة نشر لينكس x64 يمكنك نشرها باستخدام أمر Azure CLI az functionapp deployment source config-zip.

func pack [<FOLDER_PATH>]

بشكل افتراضي، func pack يحزم الدليل الحالي، وملف .zip الإخراج له نفس اسم المجلد الجذر لمشروعك. قم بتشغيل func pack في الدليل الذي يحتوي على ملف مشروع host.json . إذا كنت بحاجة إلى التشغيل func pack في دليل آخر، فقم بتعيين <FOLDER_PATH> كمسار إلى جذر المشروع، مثل func pack ./myprojectroot. إذا كان ملف .zip المحدد موجودا بالفعل، فسيتم حذفه أولا ثم استبداله بإصدار محدث.

func pack يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--output، -o تعيين المسار إلى الموقع الذي يتم فيه إنشاء ملف حزمة .zip التوزيع.
--no-build لم يتم بناء Project قبل التعبئة. بالنسبة لتطبيقات C#، استخدم فقط عند إنشاء ثنائياتك بالفعل. بالنسبة للتطبيقات Node.js، يتم تخطي كل من npm install و npm run build . بالنسبة لتطبيقات Go، استخدم فقط عندما يحتوي bin/app بالفعل على ملف ثنائي Linux x64.
--skip-install يتخطى التشغيل npm install عند التعبئة Node.jsتطبيق الوظائف المستندة إلى. يستخدم لتجنب الكتابة فوق وحدات npm المخصصة.
--build-native-deps تثبيت تبعيات Python محليا باستخدام صورة تطابق البيئة المستخدمة في Azure. عند التمكين، تبدأ Core Tools حاوية Docker، وتنشئ التطبيق داخل تلك الحاوية، وتنشئ ملف .zip مع استعادة جميع التبعيات في .python_packages. استخدم هذا الخيار عند التشغيل على Windows لتجنب مشكلات المكتبة المحتملة عند النشر إلى Linux في Azure.

func run (الإصدار الأول فقط)

إشعار

ينطبق هذا الأمر فقط على الإصدار الأول من Core Tools وهو مهجور. في الإصدار 4، استخدم func startواستدعي نقطة نهاية الدالة مباشرة.

يستدعي دالة مباشرة، بطريقة مشابهة لتشغيل دالة باستخدام علامة التبويب Test في بوابة Azure.

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 قائمة مفصولة بفواصل من الوظائف المطلوب تحميلها.
--json-output-file إذا تم توفير مسار إلى الملف المستخدم لكتابة الإخراج عند استخدام --enable-json-output.
--language-worker الوسيطات المطلوبة لتكوين عامل اللغة. على سبيل المثال، يمكنك تمكين تصحيح الأخطاء لعامل اللغة من خلال توفير منفذ debug والوسيطات المطلوبة الأخرى.
--no-build تجنب إنشاء المشروع الحالي قبل التشغيل. بالنسبة .NET مشاريع الفئة فقط. القيمة الافتراضية هي false.
--password إما كلمة المرور أو ملف يحتوي على كلمة المرور لملف .pfx. يستخدم فقط مع --cert.
--port، -p المنفذ المحلي للاستماع من عليه. القيمة الافتراضية: 7071.
--runtime تعيين إصدار المضيف الذي سيتم بدء تشغيله. القيم المسموح بها هي: inproc6و inproc8و default (التي تقوم بتشغيل مضيف خارج العملية).
--timeout، -t مهلة بدء مضيف الوظائف، بالثواني. الافتراضي: 20 ثانية.
--useHttps ربط إلى https://localhost:{port} بدلاً من http://localhost:{port}. بشكل افتراضي، ينشئ هذا الخيار شهادة موثوق بها على الكمبيوتر الخاص بك.
--user-log-level تعيين الحد الأدنى لمستوى السجل لسجلات المستخدم. القيم الصالحة هي: Traceو DebugInformationو WarningوErrorCritical.None لا يؤثر هذا الإعداد على سجلات النظام. بالنسبة .NET المشاريع المعزولة، قم أيضا بتعيين المستوى الأدنى في Program.cs باستخدام builder.Logging.SetMinimumLevel(LogLevel.Debug) لكي يسري هذا الخيار.

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

func run

يبدأ تشغيل مضيف الوظائف ويحمل المشروع في المجلد الحالي.

func run [<PATH>] [options]

func start يتم الحفاظ عليه كاسم مستعار متوافق مع الرجوع السابق ويقبل نفس الحجج والخيارات.

func run يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--port، -p المنفذ المحلي للاستماع من عليه. افتراضي: 7071.
--cors قائمة مفصولة بفاصلة لأصول CORS، بدون مسافات.
--cors-credentials السماح بطلبات المصادقة عبر الأصول التي تستخدم ملفات تعريف الارتباط والرأس Authentication .
--functions قائمة مفصولة بفواصل من الوظائف المطلوب تحميلها.
--no-build لا تبني المشروع قبل التشغيل.
--enable-auth تمكين خط معالجة المصادقة الكامل، بما في ذلك متطلبات التفويض.
--host-version، -v نسخة وقت التشغيل المضيف للاستخدام (على سبيل المثال، 4.1049.0).
--profile ملف تعريف دالات Azure لتطبيقه أثناء حل إصدارات المضيف، العامل، والحزمة. راجع func profile.
--offline استخدم فقط أعباء العمل المثبتة محليا وتخطى تثبيت الشبكة.
--output وضع الإخراج: compact (TUI تفاعلي)، plain (CI / غير TTY)، أو json (NDJSON للمستهلكين البرمجيين ووكلاء الذكاء الاصطناعي). الإعدادات الافتراضية للكشف التلقائي بناء على الطرفية.
--no-tui الاسم المستعار ل --output=plain. يعطل تقنية TUI التفاعلية.
--log-file قم بعكس جميع أحداث المضيف إلى ملف السجل المحدد.
--no-azurite عطل Azurite المدار. المضيف يبدأ بدون استكشاف أو تشغيل محاكي محلي.

عندما يكون المشروع قيد التشغيل، قم باستدعاء نقاط نهاية الدالة مباشرة للتحقق من السلوك.

أزوريت المدار

عندما يستخدم مشروعك التخزين المحلي (على سبيل المثال)، AzureWebJobsStorage=UseDevelopmentStorage=truefunc run يتحقق تلقائيا من وجود محاكي Azurite يعمل ويشغل واحدا إذا لم يجد واحدا. يتوقف المحاكي عند func run الخروج. امنح --no-azurite الاشتراك لاختيار الانسحاب وإدارة أزورايت بنفسك.

أوضاع الإخراج

func run يختار وضع الإخراج تلقائيا بناء على الطرفية:

الشرط وضع
الطرفية التفاعلية (TTY) compact
مجموعة متغيرات غير تفاعلية مثل stdout غير تفاعلية، أو مخرجات معاد توجيهها، أو CI مجموعة متغيرات البيئة plain
صريح --output=json json

واجهة السطر لا تختار jsonتلقائيا أبدا. إذا compact طلب الملف لكن stdout ليس TTY، يقوم مؤشر التحكم بتخفيض الترقية إلى plain stderr ويكتب إشعارا من سطر واحد. يصدر الوضع json JSON محدد بالخطوط الجديدة (NDJSON)، كائن واحد لكل سطر، مع قيمة schema_version .1

func quickstart

Browses and scaffolds complete function apps من كتالوج قوالب دالات Azure quickstart. قوالب البدء السريع هي تطبيقات كاملة مثل واجهة HTTP، أو عامل يتم تفعيله في قائمة الانتظار، أو تنسيق Durable Functions. تساهم أحمال العمل المكدس بحل اللغات المحددة. يتم جلب الكتالوج عند وقت الأوامر والاستدعاء.

func quickstart [<PATH>] [options]

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

func quickstart يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--stack، -s التكديس الذي يجب استخدامه، مثل python، node، أو dotnet.
--language، -l لغة البرمجة. القيم المدعومة تأتي من مزودي التشغيل السريع المثبتين.
--template، -t معرف القالب من الكتالوج، مثل http-trigger-python-azd. يتجاوز جميع المحفزات التفاعلية.
--resource، -r تصفية حسب المحفز أو مورد الربط، مثل http، timer، blob، eventhub، servicebuscosmossqlmcpأو .durable
--iac تصفية حسب نوع البنية التحتية ككود، مثل bicep، terraform، أو none.
--search يتم تطبيق فلتر النصوص الفرعية غير الحساس للحروف على أسماء القوالب والوصف.
--fetch استراتيجية جلب الكتالوج: auto (الافتراضي)، git، أو http. auto يستجيب ل git ويعود إلى HTTP.
--force سقالة حتى عندما لا يكون المجلد المستهدف فارغا. يمسح المجلد (إلا .git) قبل تركيب السقالات.

الفرعيه:

الفرعي ‏‏الوصف
func quickstart list اذكر القوالب المتاحة في الكتالوج.
func quickstart info اعرض تفاصيل حول قالب معين.

func quickstart list

يسرد القوالب المتاحة من الكتالوج، مع تصفية اختيارية.

func quickstart list [options]
خيار ‏‏الوصف
--stack، -s التكديس الذي يجب استخدامه، مثل python، node، أو dotnet.
--language، -l لغة البرمجة. القيم المدعومة تأتي من مزودي التشغيل السريع المثبتين.
--resource، -r فلتر حسب الزناد أو مورد الربط.
--iac تصفية حسب نوع البنية التحتية ككود.
--search مطابقة النص الفرعي غير الحساس للحالة مع المعرفات، وأسماء القوالب، ونوع الموارد، ونوع البنية التحتية كنوع كود، والوصف.
--json قم بإصدار JSON قابل للقراءة آليا بدلا من الجدول.

func quickstart info

يعرض معلومات مفصلة حول قالب معين.

func quickstart info <ID> [options]

<ID> هو معرف القالب من الكتالوج. استخدمها func quickstart list لاكتشاف المعرفات المتاحة.

خيار ‏‏الوصف
--json يصدر JSON قابل للقراءة آليا بدلا من الإخراج المنسق.

func profile

Inspects and manages دالات Azure CLI profiles. الملفات الشخصية ترميز قيود الإصدارات، مثل نطاق إصدار المضيف، نطاق إصدار حزمة الامتدادات، ونطاقات إصدار العامل. كما أنها تعرف الوراثة من ملفات تعريف أخرى. تشمل مصادر الملفات الشخصية ملفات المشروع-المحلية (.func/profiles/)، والعامة للمستخدم (~/.azure-functions/profiles/)، والملفات الشخصية المدمجة. استخدم الخيار func run --profile <name> لاختيار أي قيود على ملف التعريف تنطبق عند تشغيل المضيف.

func profile <subcommand>

الفرعيه:

الفرعي ‏‏الوصف
func profile list قم بإدراج الملفات الشخصية المتاحة من المشروع، والمستخدم، والمصادر المدمجة.
func profile show عرض التفاصيل لملف شخصي.
func profile set حدد ملف تعريف افتراضي لمشروع.

func profile list

يسرد الملفات الشخصية المتاحة من المشروع، والمستخدم، والمصادر المدمجة. يعرض جدولا للاسم، المصدر، إصدار المضيف، حزمة الامتدادات، والحالة.

func profile list [<PATH>] [options]
خيار ‏‏الوصف
--source قائمة المصادر المفصولة بالفواصل تشمل: project, user, built-in. الافتراضي لجميع المصادر.
--json قم بإصدار JSON قابل للقراءة آليا بدلا من الجدول.

func profile show

يعرض تفاصيل ملف تعريف واحد، إما تم حله (مع تطبيق القيم الموروثة) أو خام (التعريف كما هو مكتوب، بدون توسعة الوراثة).

func profile show <NAME> [<PATH>] [options]
خيار ‏‏الوصف
--raw عرض تعريف الملف الشخصي الخام بدون القيم الموروثة.

func profile set

يضبط الملف الشخصي الافتراضي لمشروع الدوال عن طريق كتابة اسم الملف في .func/config.jsonملف المشروع . إذا لم يكن الملف الشخصي موجودا بالفعل في قائمة ملفات المشروع، أضافه.

func profile set <NAME> [<PATH>]

func setup

يعد الجهاز المحلي لتشغيل مشاريع دالات Azure. يقوم بتثبيت أو التحقق من وقت تشغيل المضيف، وعمال اللغة، وحزم الإضافات، والقوالب الخاصة بالمكدس التي تحددها. يدعم قيود الإصدار القائمة على الملف الشخصي، والاختيار المسبق، ووضع CI غير التفاعلي، ووضع التحقق فقط.

func setup [<PATH>] [options]

--features يختار ما يجب تثبيته أو التحقق منه. الميزات والأعباء التي يحلها كل واحد منها هي:

الميزة أعباء العمل المثبتة
node host، bundles، node، ، node-workernode-templates
python host، bundles، python، ، python-workerpython-templates
go host، ، bundles، gogo-worker
dotnet host، dotnet، dotnet-templates
runtime host، bundles
host host فقط

--features قابلة للتكرار وتقبل القيم المفصولة بالفواصل، لذا يمكنك دمج الميزات في استدعاء واحد (على سبيل المثال، func setup --features node,python). dotnet-isolated يقبل كاسم مستعار ل dotnet.

خيار ‏‏الوصف
--features المكونات التي يجب تثبيتها أو التحقق منها. قابلة للتكرار أو مفصولة بفاصل. راجع الجدول أعلاه لمعرفة أعباء العمل التي تثبتها كل ميزة.
--profile ملف تعريف دالات Azure لاستخدامه لقيود الإصدارات. قابلة للتكرار. مدمجة مع --profiles.
--profiles قائمة مفصولة بفاصل لملفات تعريف دالات Azure لاستخدامها لقيود الإصدار.
--install-policy سياسة التثبيت: latest-compatible (الافتراضية) أو if-needed.
--source مصدر حزمة NuGet للاستخدام في حل وتركيب عبء العمل.
--prerelease السماح بإصدارات عبء العمل المسبقة عند الحل من الكتالوج. الافتراضي: مفعل أثناء وجود أعباء العمل في مرحلة المعاينة.
--non-interactive لا تطلب ملاحظات.
--yes، -y أجب بنعم على تعليمات الإعداد.
--check تحقق مما إذا كانت التبعيات المحددة مثبتة دون إجراء تغييرات.
--output وضع الإخراج: plain (افتراضي) أو json (NDJSON).

func workload

يدير أعباء العمل المثبتة لواجهة دالات Azure.

func workload <subcommand>

الفرعيه:

الفرعي ‏‏الوصف
func workload list قم بإدراج أحمال العمل المثبتة.
func workload search ابحث في كتالوج عبء العمل.
func workload install قم بتثبيت عبء عمل.
func workload update قم بتحديث عبء العمل المثبت في مكانه.
func workload uninstall قم بإلغاء تثبيت عبء العمل.
func workload prune قم بإزالة تثبيتات عبء العمل غير النشطة جنبا إلى جنب.

func workload list

يسرد أعباء العمل المثبتة. افتراضيا، يعرض الأمر فقط النسخة المحملة (أعلى تثبيت مكلف) من كل عبء عمل. كنت --all-versions أرى كل تثبيت جنبا إلى جنب.

func workload list [options]
خيار ‏‏الوصف
--all-versions، -a قم بإدراج كل نسخة مثبتة من كل عبء عمل. الافتراضي: النسخة المحملة فقط.
--json قم بإصدار JSON قابل للقراءة آليا بدلا من الجدول.

يبحث في كتالوج عبء العمل المكون عن حزم عبء العمل المتاحة.

func workload search [<QUERY>] [options]

عندما تحذف ، <QUERY>يعرض الأمر جميع أعباء العمل في الكتالوج.

خيار ‏‏الوصف
--source رابط مصدر الكتالوج للبحث. يتحول افتراضيا إلى الكتالوج المكون.
--prerelease أدرج النسخ المسبقة في النتائج. الافتراضي: مفعل أثناء وجود أعباء العمل في مرحلة المعاينة.
--json قم بإصدار JSON قابل للقراءة آليا بدلا من الجدول.

func workload install

يقوم بحل معرف حزمة عبء العمل (أو الاسم المستعار) عبر الكتالوج المكون وتثبيته.

func workload install <ID> [options]

<ID> يمكن أن يكون معرف حزمة عبء العمل، أو اسم مستعار (على سبيل المثال)، pythonأو مسارا إلى ملف حزمة عبء عمل محلي.

خيار ‏‏الوصف
--version، -v نسخة محددة للتثبيت. الافتراضي: أحدث إصدار مستقر في الكتالوج.
--source رابط مصدر الكتالوج أو الدليل المحلي للحل منه. الافتراضي: الكتالوج المكون.
--prerelease السماح بإصدارات ما قبل الإصدار عند التحليل من الكتالوج. الافتراضي: مفعل أثناء وجود أعباء العمل في مرحلة المعاينة.
--force، -f قم باستبدال تثبيت موجود بنفس المعرف والإصدار. كما يتخطى نافذة "استخدم التحديث بدلا من ذلك".
--exact، -e قم بتعطيل مطابقة الأسماء المستعارة. <ID> يجب أن يكون معرف الطرد الحرفي.

إذا كان هناك إصدار من عبء العمل مثبت بالفعل، فإن وحدة السطر تطلب منك استخدامه func workload update بدلا من ذلك. السياقات غير التفاعلية تعامل الموضوع على أنه تراجع.

func workload update

يقوم بتبديل النسخة الذرية في مكانه لتحميل العمل المثبت. التحديثات ليست جنبا إلى جنب؛ للتركيبات جنبا إلى جنب استخدم func workload install --force.

func workload update [<ID>] [options]

قم بتمرير <ID> تحديث عبء عمل واحد، أو --all تحديث كل عبء عمل مثبت. حدد بالضبط أحد هذين الخيارين.

خيار ‏‏الوصف
--version، -v تم تثبيت النسخة للاستبدال. الافتراضي: أعلى نسخة مثبتة.
--all قم بتحديث كل عبء عمل تم تثبيته. غير متعارضين مع <ID>.
--major السماح بعبور حدود النسخة الرئيسية. الإعداد الافتراضي: نفس التخصص فقط.
--source رابط مصدر الكتالوج أو الدليل المحلي للحل منه. الافتراضي: الكتالوج المكون.
--prerelease السماح بإصدارات ما قبل الإصدار عند التحليل من الكتالوج. الافتراضي: مفعل أثناء وجود أعباء العمل في مرحلة المعاينة.
--exact، -e قم بتعطيل مطابقة الأسماء المستعارة. <ID> يجب أن يكون معرف الطرد الحرفي.

func workload uninstall

يزيل واحدة أو جميع النسخ المثبتة من عبء العمل.

func workload uninstall <ID> [options]
خيار ‏‏الوصف
--version، -v نسخة محددة لإزالتها. الافتراضي: النسخة الوحيدة المثبتة.
--all-versions، -a قم بإلغاء تثبيت كل نسخة مثبتة من عبء العمل. غير متعارضين مع --version.
--exact، -e قم بتعطيل مطابقة الأسماء المستعارة. <ID> يجب أن يكون معرف الطرد الحرفي.

func workload prune

يزيل التثبيت غير النشط لتحميل عبء العمل جنبا إلى جنب. لكل معرف حزمة ضمن النطاق، يحتفظ الأمر بأعلى نسخة مثبتة ويزيل الإصدارات القديمة. هذا الأمر محلي فقط ولا يمس الكتالوج أبدا.

func workload prune [<ID>] [options]

عندما تحذف ، <ID>يقوم الأمر بتقليم كل عبء عمل مثبت.

خيار ‏‏الوصف
--exact، -e قم بتعطيل مطابقة الأسماء المستعارة. <ID> يجب أن يكون معرف الطرد الحرفي.

func azure functionapp

func azure functionapp يحتوي السياق على الأوامر التالية:

تدعم جميع func azure functionapp الأوامر هذه الخيارات:

خيار ‏‏الوصف
--slot يستهدف فتحة نشر مسماة محددة، إذا تم تكوينها.
--access-token يوفر رمزا مميزا للوصول، بخلاف الرمز المميز الافتراضي، لاستخدامه لتنفيذ إجراءات مصادق عليها في Azure.
--access-token-stdin يقرأ رمز وصول معينا من الإدخال القياسي. استخدم هذا الخيار عند قراءة الرمز المميز مباشرة من أمر سابق مثل az account get-access-token.
--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>

func azure functionapp list-functions يدعم الأمر هذا الخيار:

خيار ‏‏الوصف
--show-keys قم بتضمين قيم مفتاح الوصول على مستوى الدالة في عناوين URL لنقطة نهاية الدالة التي تم إرجاعها.

func azure functionapp logstream

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

func azure functionapp logstream <APP_NAME>

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

func azure functionapp logstream يدعم الأمر هذا الخيار:

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

لمزيد من المعلومات، راجع تطبيقات تنفيذ الدفق القابلة للتنفيذ في دالات Azure.

func azure functionapp publish

نشر مشروع Functions إلى مورد تطبيق دالة موجود في Azure.

func azure functionapp publish <APP_NAME>

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

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

خيار ‏‏الوصف
--additional-packages قائمة بالحزم المطلوب تثبيتها عند إنشاء التبعيات الأصلية. على سبيل المثال: python3-dev libevent-dev.
--build، -b تنفيذ إجراء بناء عند النشر إلى تطبيق وظائف Linux. يقبل: remote و local.
--build-native-deps يتخطى إنشاء المجلد .wheels عند نشر تطبيقات الوظائف Python.
--csx انشر مشروع برنامج C# النصي (.csx).
--dotnet-cli-params عند نشر وظائف C# (.csproj) المحولة برمجيا، تستدعي dotnet build --output bin/publishالأدوات الأساسية . يتم إلحاق أي معلمات تم تمريرها إلى هذا الخيار إلى سطر الأوامر.
--dotnet-version بالنسبة لتطبيقات dotnet-isolated، يحدد إصدار .NET الهدف (على سبيل المثال، 8.0).
--force يتجاهل التحقق المنشور مسبقا في سيناريوهات معينة.
--list-ignored-files يعرض قائمة بالملفات التي يتم تجاهلها أثناء النشر، استنادا إلى ملف .funcignore .
--list-included-files يعرض قائمة بالملفات التي يتم نشرها، والتي تستند إلى ملف .funcignore .
--no-build لم يتم إنشاء Project أثناء النشر. بالنسبة إلى Python، لا يتم تشغيل pip install.
--nozip تعمل على إيقاف تشغيل الوضع Run-From-Package الافتراضي. استخراج الملفات إلى wwwroot المجلد على الخادم بدلا من تشغيلها مباشرة من حزمة التوزيع.
--overwrite-settings، -y يمنع المطالبة بالكتابة فوق إعدادات التطبيق عند استخدام --publish-local-settings -i.
--publish-local-settings، -i نشر الإعدادات في local.settings.json إلى Azure، مع المطالبة بالكتابة فوق إذا كان الإعداد موجودا بالفعل. إذا كنت تستخدم محاكي تخزين محلي، فقم أولا بتغيير إعداد التطبيق إلى اتصال تخزين فعلي.
--publish-settings-only، -o نشر الإعدادات فقط وتخطي المحتوى. الإعداد الافتراضي هو مطالبة.
--show-keys إضافة مفاتيح الوظائف إلى عناوين URL المعروضة في السجلات.

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 قم بتعيين إلى true لتخطي بناء Docker المحلي.
--image-name اسم صورة حاوية موجودة في سجل حاوية، بما في ذلك اسم العلامة.
--location المنطقة الخاصة بالنشر. من الناحية المثالية، هذه المنطقة هي نفس موارد حساب البيئة والتخزين.
--name الاسم المستخدم لنشر تطبيق الوظائف في بيئة Container Apps. يظهر هذا الاسم أيضا عند إدارة تطبيق الوظائف في المدخل. يجب أن يكون الاسم فريدا في البيئة.
--registry عند التعيين، يتم تشغيل بناء Docker ويتم دفع الصورة إلى مجموعة التسجيل في --registry. لا يمكنك استخدام --registry مع --image-name. بالنسبة إلى Docker Hub، استخدم أيضا --registry-username.
--registry-password كلمة المرور أو الرمز المميز المستخدم لاسترداد الصورة من سجل خاص.
--registry-username اسم المستخدم المستخدم لاسترداد الصورة من سجل خاص.
--resource-group مجموعة الموارد التي سيتم فيها إنشاء الموارد المتعلقة بالوظائف.
--storage-account سلسلة الاتصال لحساب التخزين الذي سيتم استخدامه من قبل تطبيق الوظائف.
--worker-runtime تعيين لغة وقت التشغيل لتطبيق الوظائف. يتم استخدام هذه المعلمة فقط مع --image-name و --image-build؛ وإلا يتم تحديد اللغة أثناء الإنشاء المحلي. القيم المدعومة هي: dotnetو dotnetIsolatednodeو pythonpowershellو و و custom (للمعالجات المخصصة).

هام

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

func deploy

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

func bundles add

إضافة تكوين مجموعة الملحقات إلى ملف host.json .

func bundles add

func bundles add يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--force، -f الكتابة فوق تكوين مجموعة الملحقات الموجودة إذا كانت موجودة.
--channel، -c قناة إصدار مجموعة الملحقات. القيم المدعومة هي: GA (افتراضي) Previewو و.Experimental

func bundles download

تنزيل مجموعة الملحقات التي تم تكوينها في host.json.

func bundles download

func bundles download يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--force، -f فرض إعادة تحميل حزمة الملحق حتى لو كانت موجودة بالفعل.

func bundles list

يسرد حزم الملحقات التي تم تنزيلها.

func bundles list

func bundles path

الحصول على المسار إلى مجموعة الملحقات التي تم تنزيلها.

func bundles path

func durable delete-task-hub

حذف كافة عناصر التخزين في مركز مهام Durable Functions.

func durable delete-task-hub

func durable delete-task-hub يدعم الأمر هذه الخيارات:

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

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

func durable get-history

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

func durable get-history --id <INSTANCE_ID>

func durable get-history يدعم الأمر هذه الخيارات:

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

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

func durable get-instances

ترجع حالة كل مثيلات التنظيم. يدعم هذا الأمر التصفحات باستخدام المعلمة top .

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 احصل على المثيلات التي تتطابق حالتها مع حالة معينة، بما في ذلك runningو completedو.failed يمكنك توفير حالة واحدة أو أكثر مفصولة بمسافة.
--top حدد عدد السجلات التي تم إرجاعها في طلب معين.
--task-hub-name اسم مركز المهام Durable Functions المراد استخدامه.

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

func durable get-runtime-status

إرجاع حالة مثيل تنسيق محدد.

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

func durable get-runtime-status يدعم الأمر هذه الخيارات:

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

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

func durable purge-history

إزالة حالة مثيل التزامن والمحفوظات وتخزين الكائنات الثنائية كبيرة الحجم للتزامنات الأقدم من الحد المحدد.

func durable purge-history

func durable purge-history يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--connection-string-setting اسم الإعداد الذي يحتوي على سلسلة الاتصال التخزين المراد استخدامه.
--created-after احذف محفوظات المثيلات التي تم إنشاؤها بعد هذا التاريخ/الوقت (UTC). يتم قبول كل قيم التاريخ والوقت بالتنسيق ISO 8601.
--created-before احذف محفوظات المثيلات التي تم إنشاؤها قبل هذا التاريخ/الوقت (UTC). يتم قبول كل قيم التاريخ والوقت بالتنسيق ISO 8601.
--runtime-status احذف محفوظات المثيلات التي تتطابق حالتها مع حالة معينة، بما في ذلك completedو terminatedcanceledو و.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>

func durable 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>

func durable 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>

func durable 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>

func durable terminate يدعم الأمر هذه الخيارات:

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

func extensions install يدعم الأمر هذه الخيارات:

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

يقوم المثال التالي بتثبيت الإصدار 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

يثبت جميع الإضافات المطلوبة من تطبيق الوظائف الخاص بك.

func extensions sync يدعم الأمر هذه الخيارات:

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

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

func kubernetes deploy

نشر مشروع Functions كحاوية Docker مخصصة إلى مجموعة Kubernetes.

func kubernetes deploy

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

func kubernetes deploy يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--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 قم بتعيين الحد الأقصى لعدد النسخ المتماثلة التي يتدرج إليها مقياس التحجيم التلقائي للجراب الأفقي (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 Secrets الموجودة التي تحتوي على إعدادات تطبيق الوظائف لاستخدامها في النشر. السلوك الافتراضي هو إنشاء إعدادات استنادا 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.
--use-git-hash-version استخدم تجزئة Git كإصدار لصورة الحاوية.
--write-configs إخراج تكوينات Kubernetes كملفات YAML بدلا من النشر.
--config-file مسار ملف الإخراج عند استخدام --write-configs. الافتراضي: functions.yaml.
--hash-files الملفات المراد تجزئتها لتحديد إصدار الصورة.
--image-build عند التعيين إلى false، يتخطى بناء Docker.
--key-secret-annotations التعليقات التوضيحية لإضافتها إلى سر المفاتيح، بالتنسيق key1=val1,key2=val2 .

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

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

func kubernetes delete

حذف توزيع Functions من مجموعة Kubernetes.

func kubernetes delete --name <APP_NAME>

func kubernetes delete يدعم الأمر هذه الخيارات:

خيار ‏‏الوصف
--name اسم النشر والبيانات الاصطناعية الأخرى في Kubernetes. (مطلوب)
--namespace تعيين مساحة اسم Kubernetes. الإعدادات الافتراضية لمساحة default الاسم.
--registry اسم سجل الحاوية.
--image-name الصورة التي يجب استخدامها لنشر الجراب.
--keda-version تعيين إصدار KEDA. الخيارات الصالحة هي v1 و v2 (افتراضي).

func kubernetes install

تثبيت KEDA في مجموعة Kubernetes

func kubernetes install

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

func kubernetes install يدعم الأمر هذه الخيارات:

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

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

func kubernetes remove

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

func kubernetes remove

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

func kubernetes remove يدعم الأمر هذا الخيار:

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

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

func settings add

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

func settings add <SETTING_NAME> <VALUE>

استبدل <SETTING_NAME> باسم إعداد التطبيق.

func settings 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.json. في Azure، يتم تخزين إعدادات التطبيق دائما مشفرة.

func settings delete

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

func settings delete <SETTING_NAME>

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

func settings delete يدعم الأمر هذا الخيار:

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

func settings encrypt

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

func settings encrypt

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

func settings list

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

func settings list

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

func settings list يدعم الأمر هذا الخيار:

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

func templates list

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

func templates list يدعم الأمر هذا الخيار:

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

الخيارات العمومية

تدعم معظم أوامر Core Tools هذه الخيارات:

خيار ‏‏الوصف
--script-root تعيين الدليل الجذر لتطبيق الوظائف وتغيير دليل العمل للأمر .
--verbose تمكين الإخراج المطول للتسجيل التفصيلي. ليست كل الأوامر تدعم هذا الخيار.
--offline يعمل في وضع عدم الاتصال، دون إجراء مكالمات شبكة خارجية. تدعم أوامر func start، func initو func new هذا الخيار. يمكنك أيضا ضبطه من خلال FUNCTIONS_CORE_TOOLS_OFFLINE متغير البيئة.
--version، -v يعرض إصدار دالات Azure Core Tools.
--help، -h عرض معلومات التعليمات.
--pause-on-error إيقاف مؤقت لإدخال إضافي قبل إنهاء العملية. هذا الخيار مفيد عند تشغيل الأدوات الأساسية من بيئة تطوير متكاملة (IDE).

معظم الأوامر تدعم هذه الخيارات:

خيار ‏‏الوصف
--help، -h عرض المساعدة للأمر.
--version Display the دالات Azure CLI version. استخدم --verbose مع --version مع معلومات بناء دقيقة.
--verbose تفعيل الإخراج المطول. ينتشر إلى جميع الأوامر الفرعية. عند تمريرها من الجذر بدون أمر فرعي، تطبع تفاصيل البناء، وقت التشغيل، نظام التشغيل، ومعلومات البنية.

الأحمال المتاحة

اذهب func workload search لرؤية الكتالوج الحالي. الأعباء التالية متاحة حاليا:

الاسم ‏‏الوصف
host مدة تشغيل المضيف دالات Azure المستخدمة في func run.
bundles قم بتثبيت حزم الإضافات، التي تتيح جميع امتدادات الربط. استخدم هذا العبء لأي تكديس غير .NET. مشاريع .NET لا تستخدم هذا العبء. بدلا من ذلك، يشيرون إلى الامتدادات مباشرة في مشاريعهم.
dotnet أدوات دالات Azure CLI لمشاريع .NET (C#, F#). كما يساهم بقوالب ل func quickstart. .NET لا يتطلب عبء عمل منفصل للعامل، لأن العامل جزء من المشروع المترجم نفسه.
dotnet-templates قوالب سقالة الوظائف لمشاريع العمال المعزولة ب ..NET.
python أدوات دالات Azure CLI لمشاريع Python. كما يساهم بقوالب ل func quickstart.
python-worker عامل لغة Python المستخدم من قبل مضيف Functions.
python-templates قوالب سقالة الوظائف ل Python (نماذج البرمجة v1 و v2).
node دالات Azure أدوات CLI لمشاريع Node.js (JavaScript، TypeScript). كما يساهم بقوالب ل func quickstart.
node-worker عامل اللغة Node.js المستخدم من قبل مضيف الدوال.
node-templates قوالب سقالة الوظائف ل Node.js (JavaScript، TypeScript).
go دالات Azure CLI tooling for Go projects. كما يساهم بقوالب ل func quickstart.
go-worker عامل لغة Go المستخدم من قبل مضيف Functions.

إشعار

ليست جميع تكدسات لغات Functions متاحة حاليا كأحمال عمل. لا يتم دعم تكديس Java وPowerShell حاليا في واجهة تحكم دالات Azure.

  • Last updated on