مرجع 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 6.0 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 |
اللغة التي يتم تصفية القوالب التي تم إرجاعها لها. الإعداد الافتراضي هو إرجاع كل اللغات. |