إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
واجهة دالات Azure CLI هي الإصدار الرئيسي التالي (v5) من وقت تشغيل التطوير المحلي والأدوات الخاصة ب دالات Azure. يتميز هذا الإصدار من func.exe ببنية تعتمد على عبء العمل، لذا تقوم فقط بتنزيل ما تحتاجه للمكدس الذي تطور عليه.
مهم
دالات Azure CLI (v5) حاليا قيد المعاينة. هذه النسخة التجريبية لا تدعم بعد Java وPowerShell. للعمل مع لغات غير مدعومة حاليا، استمر في استخدام دالات Azure Core Tools v4.
هناك أداتان لسطر الأوامر تصدران كما func.exe هو الحال في دالات Azure:
| أدوات دالات Azure الأساسية | دالات Azure CLI | |
|---|---|---|
| func.exe النسخة | v4 | v5 |
| مستوى الدعم | التوافر العام (GA) | معاينة |
| تثبيت القدم | ثنائية كاملة تشمل جميع الأوامر والقدرات لجميع اللغات الأصلية. | تثبيت قاعدة صغيرة، بالإضافة إلى أعباء عمل لكل لغة وميزات أخرى تضيفها حسب الحاجة. المضيف يشحن كعبء عمل مستقل، لذا تحصل على أحدث إصدار للمضيف دون الحاجة لإعادة تحميل ملف السطوع. |
| استخدم عندما... | تحتاج إلى دعم كامل لخدمات التطوير لجميع سير العمل في التطوير. | تريد تجربة خفيفة تعتمد على عبء العمل مع ميزات جديدة مثل قوالب البدء السريع وملفات تعريف تحافظ على تزامن بيئتك المحلية مع إعدادات خطة استضافة Azure الخاصة بك. |
للحصول على مرجع الأمر، انظر دالات Azure CLI reference.
الأمثلة غير متوفرة حاليا بسبب نقص دعم مكدس اللغات.
Install the دالات Azure CLI
يتم توزيع دالات Azure CLI كتثبيت أساسي صغير بالإضافة إلى أعباء عمل تضيفها للتكدسات التي تطور فيها. بعد التثبيت، يكون الملف func الثنائي على جهاز PATH.
إشعار
قد تتغير طريقة التثبيت بين المعاينة والتوافر العام.
iex "& { $(irm https://aka.ms/func-cli/install.ps1) } -Prerelease"
إذا كنت تقوم بالترقية من تثبيت سابق، أضف -Force (PowerShell) أو --force (Bash) إلى الأمر.
تحقق من التثبيت:
func --version
بعد تثبيت سطر القاعدة (CLI) الأساسي، قم بتثبيت أحمال العمل الخاصة بالمكدس الخاص بك. أسرع طريقة هي func setup، حيث يتم تثبيت المضيف، وعامل اللغة، وحزم الامتدادات (عند الحاجة)، وعبء عمل المكدس، وعبء القوالب في خطوة واحدة.
على سبيل المثال:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
يمكنك أيضا تثبيت أحمال العمل بشكل فردي باستخدام func workload install. في كلتا الحالتين، في المرة الأولى التي تشغل func initفيها ، func newأو func run بدون تثبيت الأحمال المطلوبة، يطلب منك مؤشر التحكم تثبيتها.
Workloads
يستخدم سطر دالات Azure نموذج workload model. التثبيت الأساسي func صغير وغير متحكم في اللغة. تقوم بتثبيت أحمال العمل عند الطلب للحصول على أدوات خاصة بالتكدس، ومضيف الوظائف، وعمال اللغات، وحزم الإضافات، والقوالب.
تنقسم أعباء العمل إلى هذه الفئات:
-
Host: مدة تشغيل دالات Azure المضيف التي يستخدمها
func run. - Bundles: تشوهات حزم الامتدادات الجاهزة بحيث تعمل المشغلات والروابط بشكل مسبق (مطلوبة للتكديس غير .NET).
-
المكدس: أدوات مشروع خاصة باللغة (على سبيل المثال،
python،node،dotnet). -
العامل: عامل اللغة الذي يستخدمه المضيف في وقت التشغيل (على سبيل المثال،
python-worker،node-worker). -
القوالب: قوالب الدوال التي تظهر بواسطة
func new(على سبيل المثال،python-templates،node-templates).
للاطلاع على القائمة الكاملة لأحمال العمل المتاحة ووصفها، انظر أعباء العمل المتاحة في مرجع واجهة برمجة السطوع.
تجربة التجربة الأولى
في المرة الأولى التي تقوم فيها بتشغيل func init، func newأو func run، يتحقق مؤشر القيادة مما إذا كانت أحمال العمل المطلوبة لسيناريوك مثبتة. إذا لم تكن كذلك، فإن مؤشر التحكم يطلب منك تثبيتها. قبول الرسالة يثبت المجموعة الموصى بها للمجموعة التي اخترتها. يمكنك رفض الإشعار وتثبيت أحمال العمل يدويا باستخدام func workload install، أو تشغيل func setup إعداد المعيار بشكل غير تفاعلي.
تحديثات عبء العمل
شغل func workload search بشكل دوري للتحقق من الأحمال الجديدة المتاحة. استمر في استخدام Core Tools (v4) للمجموعات غير المدعومة أو عندما تحتاج إلى ميزات GA محددة في Core Tools.
إنشاء مشروع محلي
لإنشاء مشروع دوال جديد، استخدم الأمر func init .
func init MyProjFolder --stack dotnet
func init MyProjFolder --stack node --language javascript
func init MyProjFolder --stack node --language typescript
func init MyProjFolder --stack python
func init MyProjFolder --stack go
يحدد الخيار --stack أي مكدس لغوي يجب استخدامه. العبء المثبت لتلك التكديس يوفر الهيكل الأساسي.
إنشَاء دَالة
لإضافة دالة من قالب، استخدم الأمر func new .
func new --template "HTTP trigger" --name MyHttpTrigger
قم بتشغيل الدالات محليًا
لبدء مضيف الدوال وتشغيل مشروعك، استخدم func run:
func run
func start يتم الحفاظ عليه كاسم مستعار متوافق مع الإصدارات السابقة. المضيف يدير تلقائيا Azurite (محاكي التخزين المحلي) إلا إذا نجحت --no-azurite.
سقالة من قوالب البدء السريع
لتصفح وتركيب تطبيقات العينات الكاملة (واجهات برمجة تطبيقات HTTP، عمال الطوابير، Durable Functions التنسيقات)، استخدم func quickstart:
func quickstart --stack dotnet --resource http
func quickstart --stack node --resource http
func quickstart --stack python --resource http
func quickstart --stack go --resource http
إدارة أحمال العمل
يستخدم func workload لتثبيت وتحديث وإزالة أعباء العمل. للاطلاع على القائمة الكاملة للأوامر الفرعية والخيارات، راجع func workload مرجع CLI.
Profiles
الملفات الشخصية ترمز قيود الإصدار للمضيف، وحزم الإضافات، والعمال. تطبيق ملف تعريف أثناء التشغيل باستخدام func run --profile <name>. للاطلاع على القائمة الكاملة للأوامر الفرعية والخيارات، راجع func profile مرجع CLI.