التشغيل السريع: إنشاء دالة C# في Azure باستخدام رمز Visual Studio

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

• C#‎
• Java
• JavaScript
• PowerShell
• Python
• TypeScript
• (Go/Rust) أخرى

في هذه المقالة، يمكنك استخدام تعليمات Visual Studio البرمجية لإنشاء دالة مستندة إلى مكتبة فئة C# والتي تستجيب لطلبات HTTP. بعد اختبار التعليمة البرمجية محليا، يمكنك نشرها على بيئة Azure Functions بدون خادم.

يتطلب إكمال هذا التشغيل السريع تكلفة صغيرة تبلغ بضعة سنتات أمريكية أو أقل في الحساب في Azure.

هناك أيضاً إصدار يستند إلى واجهة سطر الأوامر من هذه المقالة.

1. تجهيز بيئتك

قبل البدء، تأكد من أن لديك المتطلبات التالية:

• حساب Azure مع اشتراك نشط. أنشئ حساباً مجانياً.

• إصدار 3.x. من Azure Functions Core Tools.

• Visual Studio Code في واحدة من النظم الأساسية المدعومة.

• ملحق #C لمحرر Visual Studio Code.

• ملحق Azure Functions للمحرر Visual Studio Code.

2. ⁧⁩⁧⁩ إنشاء المشروع المحلي الخاص بك

في هذا القسم، يمكنك استخدام التعليمات البرمجية Visual Studio لإنشاء مشروع Azure Functions محلي في C#. لاحقاً في هذه المقالة، ستنشر تعليمتك البرمجية للوظيفة إلى Azure.

1. اختر أيقونة Azure في ⁧⁩شريط النشاط⁧⁩، ثم في ⁧⁩Azure: في منطقة Functions⁧⁩، حدد أيقونة ⁩⁩Create new project...⁦⁦.

   

2. اختر موقع دليل لمساحة عمل مشروعك واختر ⁧⁩تحديد⁧⁩.

   ملاحظة

   صُممت هذه الخطوات لتُستكمل خارج مساحة العمل. في هذه الحالة، لا تقم بتحديد مجلد مشروع جزء من مساحة عمل.

3. قدّم المعلومات التالية عند المطالبات:

   • حدد اللغة الخاصة بمشروع الدالة: "Select"C#‎.

   • ⁧⁩حدد قالبًا للدالة الأولى لمشروعك⁧⁩: اختر ⁧HTTP trigger⁩.

   • أدخل اسم دالة: نوع HttpExample.

   • أدخل مساحة الاسم: نوعMy.Functions.

   • مستوى السماح: اختر Anonymous، بحيث يتمكن أي شخص من استدعاء نقطة النهاية لدالتك. للتعرف على مستويات التفويض، راجع ⁧⁩مفاتيح التفويض⁧⁩.

   • ⁧⁩حدد الكيفية التي ستفتح بها مشروعك⁧ ⁩بها: اختر ⁧Add to workspace⁩.

4. باستخدام هذه المعلومات، يقوم Visual Studio Code بإنشاء مشروع Azure Functions باستخدام مشغل HTTP. يمكن عرض ملفات المشروع المحلي في المستكشف. لمعرفة المزيد حول الملفات المُنشأة راجع ملفات المشروع المُنشأة.

تشغيل الدالة محليًا

تعليمة Visual Studio برمجية مع ⁧⁩Azure Functions Core tools⁧⁩ للسماح لك بتشغيل هذا المشروع في حاسوب التنمية المحلية الخاص بك قبل أن تقوم بالنشر إلى Azure.

1. لاستدعاء دالتك، اضغط ⁧⁩F5⁧⁩ لبدء مشروع تطبيق الدالة. يُعرض الإخراج من الأدوات الأساسية في لوحة Terminal. يبدأ تطبيقك في لوحة ⁧⁩Terminal⁧⁩. يمكنك مشاهدة نقطة نهاية URL للوظيفة التي تم تشغيلها بواسطة HTTP وتعمل محليًا.

   

   إذا واجهتك مشكلة في تشغيل ويندوز، فتأكد من أن المحطة الطرفية الافتراضية للتعليمة البرمجية Visual Studio لم يتم ضبطها على ⁧⁩WSL Bash⁧⁩.

2. مع تشغيل Core Tools، انتقل إلى ⁧⁩ Azure: منطقة ⁧⁩الدوال. تحت ⁧⁩الدوال⁧⁩، قم بتوسيع مشروع ⁧⁩الدوال⁧⁩⁧>⁩⁧⁩المحلية⁧⁩. انقر بزر الماوس الأيمن فوق (Windows) أو اضغط على ⁦⁧⁩⁩Ctrl -⁦⁧⁩⁩ (في macOS) على الدالة HttpExample واختر ⁩⁩تنفيذ الدالة الآن..⁦.⁦⁩.

   

3. في إدخال نص الطلب، ترى قيمة نص رسالة الطلب { "name": "Azure" }. اضغط «Enter» لإرسال رسالة الطلب هذه إلى الدالة الخاصة بك.

4. عند تنفيذ الدالة محليًا، وإرجاع استجابة، يتم رفع إشعار في التعليمة البرمجية لـ Visual Studio. يتم عرض معلومات حول تنفيذ الدالة في اللوحة ⁩الطرفية⁧⁩.

5. مع تركيز لوحة المحطة الطرفية ، اضغط على Ctrl + C لإيقاف الأدوات الأساسية وفصل مصحح الأخطاء.

بعد التحقق من أن الدالة تعمل بشكل صحيح على الحاسوب المحلي، حان الوقت لاستخدام Visual Studio Code لنشر المشروع مباشرة على Azure.

تسجيل الدخول إلى Azure

قبل أن تتمكن من نشر التطبيق، ينبغي تسجيل الدخول إلى Azure.

1. إذا لم تكن قد سجلت الدخول بالفعل، فاختر رمز Azure في شريط النشاط، ثم في منطقة Azure: وظائف، اختر تسجيل الدخول إلى Azure... . إذا لم يكن لديك حساب بالفعل، يمكنك إنشاء حساب Azure مجانًا . يمكن للطلاب إنشاء حساب Azure مجاني للطلاب .

   

   إذا قمت بتسجيل الدخول بالفعل، فانتقل إلى القسم التالي.

2. عندما يطلب منك في المتصفح، اختر حساب Azure الخاص بك، ثم سجل الدخول باستخدام بيانات اعتماد حساب Azure.

3. بعد تسجيل الدخول بنجاح، يمكنك إغلاق نافذة المتصفح الجديد. تُعرض الاشتراكات التي تنتمي إلى حساب Azure في الشريط الجانبي.

5. نشر المشروع إلى Azure

في هذا القسم، يمكنك إنشاء تطبيق الدالة والموارد ذات الصلة في اشتراك Azure الخاص بك، ونشر الرمز الخاص بك.

هام

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

1. اختر أيقونة Azure في شريط النشاط، ثم في Azure: منطقة الدالات اختر زر نشر على تطبيق الدالات...

2. قدّم المعلومات التالية عند المطالبات:

   • ⁧⁩حدد المجلد⁧⁩: اختر مجلدًا من مساحة عملك، أو ابحث عن مجلد يتضمن تطبيق دالتك. لن ترى هذا الخيار إذا كان لديك بالفعل تطبيق دالة صالح ومفتوح.

   • ⁧⁩حدد خيار اشتراك⁧⁩: اختر الاشتراك الذي تود استخدامه. لن ترى هذا في حالة امتلاكك اشتراك واحد فقط.

   • ⁧⁩اختر تطبيق الدالة في Azure⁧⁩: اختر⁧+ Create new Function App⁩. (تجنب اختيار ⁧Advanced⁩ الخيار الذي لا يشمله هذا المقال.)

   • ⁧⁩اكتب اسمًا فريدًا عالميًا لتطبيق الدالة:⁧⁩اكتب اسمًا صحيحًا في مسار URL. يتم التحقق من صحة الاسم الذي تكتبه للتأكد من أنه فريد في وظائف Azure.

   • ⁧⁩حدد موقعًا للموارد الجديدة:⁧ ⁩للحصول على أفضل أداء، اختر ⁧⁩منطقة⁧⁩ قريبة منك.

   يعرض الملحق حالة الموارد الفردية أثناء إنشائها في Azure في مساحة الإخطار.

   

3. عند الانتهاء، يتم إنشاء موارد Azure التالية في اشتراكك، باستخدام أسماء تستند إلى اسم تطبيق الدالة الخاص بك:

   • مجموعة موارد، وهي حاوية منطقية للموارد ذات الصلة.
   • حساب التخزين بخدمة Azure: هو مورد تخزين يحتفظ بالحالة ومعلومات أخرى حول المشروع.
   • خطة الاستهلاك: خطة الاستهلاك تحدد المضيف الأساسي لتطبيق الدالة بلا خادم.
   • تطبيق دالة، والذي يوفر البيئة لتنفيذ رمز الدالة الخاص بك. يمكنك استخدام أحد تطبيقات الدالة لتجميع الدوال في وحدة منطقية لتيسير إدارة الموارد ونشرها وتحجيمها ومشاركتها.
   • عبارات Application Insights متصل بتطبيق الدالة الذي يتتبع استخدام الدالة بلا خادم.

   يتم عرض إشعار بعد إنشاء تطبيق الدالة وتطبيق حزمة النشر.

   تلميح

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

4. حدد عرض النتائج في هذه الإشعارات لعرض نتائج الإنشاء والنشر، بما في ذلك موارد Azure التي أنشأتها. إذا فاتك الإخطار، فحدد أيقونة الجرس في الزاوية السفلية اليسرى لرؤيته مرة أخرى.

   

6. تفعيل الدالة في Azure

1. مرة أخرى في Azure: دالات المنطقة في الشريط الجانبي، وتوسيع الاشتراك الخاص بك، تطبيق دالتك الجديدة، ودالات. انقر بزر الماوس الأيمن فوق (Windows) أو اضغط على ⁦⁧⁩⁩Ctrl -⁦⁧⁩⁩ (في macOS) على الدالة HttpExample واختر ⁩⁩تنفيذ الدالة الآن..⁦.⁦⁩.

   

2. في إدخال نص الطلب، ترى قيمة نص رسالة الطلب { "name": "Azure" }.

   اضغط على "Enter" لإرسال رسالة الطلب إلى الدالة الخاصة بك.

3. عند تنفيذ الدالة في Azure وإرجاع استجابة، يتم رفع إعلام في تعليمات Visual Studio البرمجية.

5. حذف الموارد

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

بخلاف ذلك، يمكنك استخدام الخطوات التالية لحذف تطبيق الدالة والموارد المرتبطة به لتجنب تكبد أي تكاليف إضافية.

1. في فيجوال ستوديو كود، اضغط F1 لفتح لوحة الأوامر. في لوحة الأوامر، قم بالبحث والتحديدAzure Functions: Open in portal.

2. اختر تطبيق الوظائف، واضغط على زر Enter. تفتح صفحة تطبيق الوظائف في مدخل Azure.

3. في علامة التبويب "Overview" ، حدد الرابط المسمى بجوار مجموعة الموارد.

   

4. في صفحة مجموعة الموارد، راجع قائمة الموارد المضمنة، وتحقق من أنها هي التي تريد حذفها.

5. حدد "Delete resource group" ، واتبع الإرشادات.

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

لمعرفة المزيد حول تكاليف الدوال، يُرجى الاطلاع على ⁧⁩تقدير تكاليف خطة الاستهلاك⁧⁩.

الخطوات التالية

لقد استخدمت Visual Studio Code لإنشاء تطبيق دالة باستخدام دالة بسيطة تعمل بواسطة HTTP. في المقالة التالية، يمكنك توسيع هذه الدالة عن طريق إضافة ربط الإخراج. يكتب هذا الربط السلسلة من طلب HTTP إلى رسالة في قائمة انتظار تخزين Azure Queue.

⁧⁩الاتصال بقائمة انتظار Azure Storage⁧⁩