مرجع Azure Functions Core Tools

توفر هذه المقالة وثائق مرجعية Azure Functions Core Tools، والتي تتيح لك تطوير المشاريع Azure Functions وإدارتها ونشرها من الكمبيوتر المحلي. لمعرفة المزيد حول استخدام Core Tools، راجع Work مع Azure Functions 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 Functions.
func settings أوامر لإدارة إعدادات البيئة لمضيف الوظائف المحلي.
func templates أوامر لسرد قوالب الوظائف المتوفرة.

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

func init

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

func init [<PROJECT_FOLDER>]

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

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

خيار ‏‏الوصف
--bundles-channel، -c قناة إصدار مجموعة الملحقات. القيم المدعومة هي: GA (افتراضي) Previewو و.Experimental ينطبق فقط على المشاريع غير .NET.
--configuration-profile تهيئة مشروع بملف تعريف تكوين مضيف. --configuration-profile الخيار قيد المعاينة حاليا. لمزيد من المعلومات، راجع ملفات تعريف التكوين.
--csx إنشاء وظائف .NET كبرنامج نصي C#، وهو سلوك الإصدار 1.x. صالح فقط مع --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 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، -a تعيين مستوى التخويل لمشغل HTTP. القيم المدعومة هي: function وanonymous وadmin. لا يتم فرض التخويل عند التشغيل محليًا. لمزيد من المعلومات، راجع مستوى التخويل.
--csx (الإصدار 2.x والإصدارات الأحدث.) ينشئ نفس قوالب برنامج C# النصي (.csx) المستخدمة في الإصدار 1.x وفي المدخل.
--file، -f الملف الهدف للدالة الجديدة. بالنسبة لمشاريع Python v2، يحدد الملف الذي تريد إضافة الدالة إليه (الإعدادات الافتراضية إلى function_app.py). بالنسبة لمشاريع Node.js v4، يحدد اسم ملف الإخراج في src/functions المجلد. لا ينطبق على مشاريع .NET المحولة برمجيا.
--language، -l لغة برمجة القالب، مثل C# أو JavaScript. هذا الخيار مطلوب في الإصدار 1.x. في الإصدار 2.x والإصدارات الأحدث، لا تستخدم هذا الخيار لأن اللغة محددة بواسطة وقت تشغيل العامل.
--name، -n اسم الوظيفة.
--template، -t استخدم الأمر func templates list لمشاهدة القائمة الكاملة للقوالب المتوفرة لكل لغة مدعومة.

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

func pack

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

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 .
--skip-install يتخطى التشغيل npm install عند التعبئة Node.jsتطبيق الوظائف المستندة إلى. يستخدم لتجنب الكتابة فوق وحدات npm المخصصة.
--build-native-deps تثبيت تبعيات Python محليا باستخدام صورة تطابق البيئة المستخدمة في Azure. عند التمكين، تبدأ Core Tools حاوية Docker، وتنشئ التطبيق داخل تلك الحاوية، وتنشئ ملف .zip مع استعادة جميع التبعيات في .python_packages. استخدم هذا الخيار عند التشغيل على Windows لتجنب مشكلات المكتبة المحتملة عند النشر إلى Linux في Azure.

func run

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

يمكنك من استدعاء دالة مباشرة، والتي تشبه تشغيل دالة باستخدام علامة التبويب Test في مدخل 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 قائمة مفصولة بفواصل من الوظائف المطلوب تحميلها.
--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 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 Functions.

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

الحصول على connection string لحساب Azure Storage المحدد.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

لمزيد من المعلومات، راجع تنزيل تخزين connection string.

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>

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

خيار ‏‏الوصف
--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 connection string لحساب التخزين الذي سيتم استخدامه من قبل تطبيق الوظائف.
--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 اسم الإعداد الذي يحتوي على connection string التخزين المراد استخدامه.
--task-hub-name اسم مركز المهام الدائم المراد استخدامه.

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

func durable get-history

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

func durable get-history --id <INSTANCE_ID>

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

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

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

func durable get-instances

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

func durable get-instances

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

خيار ‏‏الوصف
--continuation-token الرمز المميز الذي يشير إلى صفحة أو مقطع معين من طلبات الإرجاع.
--connection-string-setting اسم إعداد التطبيق الذي يحتوي على connection string التخزين المراد استخدامها.
--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 اسم الإعداد الذي يحتوي على connection string التخزين المراد استخدامه.
--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 اسم الإعداد الذي يحتوي على connection string التخزين المراد استخدامه.
--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 اسم الإعداد الذي يحتوي على connection string التخزين المراد استخدامه.
--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 اسم الإعداد الذي يحتوي على connection string التخزين المراد استخدامه.
--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 اسم الإعداد الذي يحتوي على connection string التخزين المراد استخدامه.
--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 اسم الإعداد الذي يحتوي على connection string التخزين المراد استخدامه.
--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

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

func kubernetes deploy

ينشئ هذا الأمر المشروع على شكل حاوية مخصصة وينشره إلى نظام مجموعة Kubernetes. يجب أن تحتوي الحاويات المخصصة على Dockerfile. لإنشاء تطبيق باستخدام Dockerfile، استخدم --dockerfile الخيار مع 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 Functions استضافة الوظائف الحاوية إما في Azure Container Apps أو في Azure Functions. لا يدعم Azure Functions رسميا تشغيل حاوياتك مباشرة في مجموعة Kubernetes أو في Azure Kubernetes Service (AKS). لمزيد من المعلومات، راجع دعم حاوية Linux في Azure Functions.

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

يقوم هذا الأمر أيضا بفك تشفير القيم connection string في مجموعة 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> استخدم قيمة الإعداد.

func settings 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 لعرض القيمة الفعلية.

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 Functions Core Tools.
--help، -h عرض معلومات التعليمات.
--pause-on-error إيقاف مؤقت لإدخال إضافي قبل إنهاء العملية. مفيد عند تشغيل Core Tools من بيئة تطوير متكاملة (IDE).
  • Last updated on