إنشاء نقطة نهاية HTTP باستخدام Azure Functions في المدخل

تتيح لك Azure Functions تشغيل التعليمات البرمجية في بيئة بدون خادم دون الحاجة إلى إنشاء جهاز ظاهري (VM) أولاً أو نشر تطبيق ويب. في هذه المقالة، يمكنك التعرف على كيفية استخدام وظائف Azure لإنشاء وظيفة مشغل "hello world" HTTP في مدخل Azure.

اختر لغة البرمجة المفضلة لديك في أعلى المقالة.

Note

يتم حاليا دعم تحرير التعليمات البرمجية لدالة C# في مدخل Microsoft Azure فقط لوظائف البرنامج النصي C# (.csx). لمعرفة المزيد حول القيود المفروضة على تحرير التعليمات البرمجية للدالة في مدخل Microsoft Azure، راجع قيود التطوير في مدخل Microsoft Azure.

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

• استوديو مرئي
• Visual Studio Code

• المحطة الطرفية / موجه الأوامر

Note

تحرير التعليمات البرمجية لوظيفة Java في مدخل Microsoft Azure غير مدعوم حاليا. لمزيد من المعلومات، راجع قيود التطوير في مدخل Microsoft Azure.

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

• Eclipse
• Gradle
• فكرة IntelliJ

• Maven

• Quarkus
• سحابة الربيع
• Visual Studio Code

Note

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

• Visual Studio Code

• المحطة الطرفية / موجه الأوامر

Note

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

• Visual Studio Code

• المحطة الطرفية / موجه الأوامر

Note

تحرير التعليمات البرمجية لدالة TypeScript في مدخل Microsoft Azure غير مدعوم حاليا. لمزيد من المعلومات، راجع قيود التطوير في مدخل Microsoft Azure.

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

• Visual Studio Code

• المحطة الطرفية / موجه الأوامر

Note

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

• Visual Studio Code

• المحطة الطرفية / موجه الأوامر

يرجى مراجعة المشكلات المعروفة لتطوير Azure Functions باستخدام Python في مدخل Microsoft Azure.

Prerequisites

إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.

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

سجل الدخول إلى مدخل Microsoft Azure باستخدام حساب Azure الخاص بك.

قم بإنشاء تطبيق دالة

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

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

لكي تتمكن من إنشاء تطبيق برنامج نصي C# يمكنك تحريره في المدخل، اختر 8 (LTS)، نموذج قيد المعالجة لإصدار .NET.

1. من قائمة مدخل Microsoft Azure أو الصفحة الرئيسية ، حدد إنشاء مورد.

2. في صفحة جديد ، حدد تطبيق الوظائف.

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

4. في صفحة الأساسيات ، استخدم إعدادات تطبيق الوظائف كما هو محدد في الجدول التالي:

   Setting	القيمة المقترحة	Description
   Subscription	اشتراكك	الاشتراك الذي تقوم بموجبه بإنشاء تطبيق الوظائف الجديد.
   مجموعة الموارد	myResourceGroup	اسم مجموعة الموارد الجديدة التي تقوم فيها بإنشاء تطبيق الوظائف. يجب إنشاء مجموعة موارد جديدة بسبب وجود قيود معروفة عند إنشاء تطبيقات وظائف جديدة في مجموعة موارد موجودة.
   اسم تطبيق الوظائف	اسم فريد عالميًا	الاسم الذي يحدد تطبيق الوظائف الجديد. الأحرف الصالحة هي a-z (غير حساسة لحالة الأحرف)، و0-9، و-. لضمان اسم تطبيق فريد، يمكنك اختياريا تمكين اسم المضيف الافتراضي الفريد الآمن، وهو قيد المعاينة حاليا.
   مكدس وقت التشغيل	اللغة المفضلة	اختر وقت تشغيل يدعم لغة برمجة الوظائف المفضلة لك. يتوفر التحرير في المدخل فقط لبرنامج JavaScript وPowerShell وPython وTypeScript وC# النصي. لإنشاء تطبيق C# Script يدعم التحرير داخل المدخل، يجب عليك اختيار إصدار وقت التشغيل الذي يدعم النموذج قيد المعالجة. يجب تطوير مكتبة فئة C # ووظائف Java محليا.
   Version	رقم الإصدار	اختر إصدار وقت التشغيل المثبت.
   Region	المنطقة المفضلة	حدد منطقة قريبة منك أو بالقرب من الخدمات الأخرى التي يمكن لوظائفك الوصول إليها.
   نظام التشغيل	Windows	يتم تحديد نظام التشغيل مسبقا لك استنادا إلى تحديد مكدس وقت التشغيل، ولكن يمكنك تغيير الإعداد إذا لزم الأمر. يتم اعتماد التحرير في المدخل فقط على نظام Windows.

5. اقبل الخيارات الافتراضية في علامات التبويب المتبقية، بما في ذلك السلوك الافتراضي لإنشاء حساب تخزين جديد في علامة التبويب التخزين ومثيل Application Insight جديد في علامة التبويب المراقبة . يمكنك أيضا اختيار استخدام حساب تخزين موجود أو مثيل Application Insights.

6. حدد Review + create لمراجعة تكوين التطبيق الذي اخترته، ثم حدد Create لتوفير تطبيق الوظائف ونشره.

7. حدد أيقونة الإعلامات في الزاوية العلوية اليمنى من المدخل وراقب رسالة نجاح النشر .

8. حدد الانتقال إلى المورد لعرض تطبيق الوظيفة الجديد. يمكنك أيضًا تحديدتثبيت في لوحة المعلومات. يُسهل التثبيت العودة إلى مورد تطبيق الوظيفة هذا من لوحة المعلومات الخاصة بك.

   

بعد ذلك، قم بإنشاء وظيفة في تطبيق الوظائف الجديد.

إنشاء دالة مشغل HTTP

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

2. ضمن تحديد قالب، قم بالتمرير لأسفل واختر قالب مشغل HTTP.

3. في تفاصيل القالب، استخدم HttpExample وظيفة جديدة، حدد مجهول من القائمة المنسدلة مستوى التخويل ، ثم حدد إنشاء.

   ينشئ Azure وظيفة مشغل HTTP. الآن، يمكنك تشغيل الوظيفة الجديدة عن طريق إرسال طلب HTTP.

إنشاء وظائفك محليا

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

1. في تطبيق الوظائف الخاص بك، حدد نظرة عامة، ثم في إنشاء وظائف في بيئتك المفضلة ضمن الوظائف.

2. اختر بيئة التطوير المحلية المفضلة لديك واتبع الخطوات الواردة في المقالة المرتبطة لإنشاء مشروع Azure Functions الأول ونشره.

   Tip

   عند نشر مشروعك الجديد، تأكد من استخدام تطبيق الوظائف والموارد ذات الصلة التي أنشأتها للتو.

اختبر الدَالة.

Tip

تعمل وظيفة Code + Test في المدخل حتى مع الوظائف للقراءة فقط ولا يمكن تحريرها في المدخل.

1. في صفحة نظرة عامة لتطبيق الوظائف الجديد، حدد دالة HTTP الجديدة التي تم تشغيلها في علامة التبويب الوظائف .

2. في القائمة اليمنى، قم بتوسيع المطور، وحدد التعليمات البرمجية + الاختبار، ثم حدد اختبار/تشغيل.

3. في مربع الحوار اختبار/تشغيل ، حدد تشغيل.

   يتم إرسال طلب HTTP POST إلى الدالة الجديدة الخاصة بك مع حمولة تحتوي على name قيمة Azure. يمكنك أيضا اختبار الدالة عن طريق تحديد GETلأسلوب HTTP وإضافة معلمة name بقيمة YOUR_NAME.

   Tip

   للاختبار في مستعرض خارجي، بدلا من ذلك حدد Get function URL، وانسخ القيمة الافتراضية (Function key)، وأضف قيمة &name=<YOUR_NAME> سلسلة الاستعلام إلى نهاية عنوان URL هذا، ثم أرسل عنوان URL في شريط العناوين في مستعرض الويب.

4. عند تشغيل الوظيفة، تتم كتابة معلومات التتبع إلى السجلات. لمشاهدة إخراج التتبع، ارجع إلى صفحة Code + Test في البوابة وقم بتوسيع سهم Logs في أسفل الصفحة. اتصل بوظيفتك مرة أخرى لترى ناتج التتبع مكتوبًا في السجلات.

تنظيف الموارد

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

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

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

1. في مدخل Microsoft Azure، انتقل إلى صفحة مجموعة الموارد .

   للوصول إلى هذه الصفحة من صفحة تطبيق الوظائف، حدد علامة التبويب نظرة عامة ، ثم حدد الارتباط ضمن مجموعة الموارد.

   

   للوصول إلى هذه الصفحة من لوحة المعلومات، حدد مجموعات الموارد، ثم حدد مجموعة الموارد التي استخدمتها لهذه المقالة.

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

3. حدد حذف مجموعة الموارد واتبع الإرشادات.

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

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

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

إضافة رسائل إلى قائمة انتظار تخزين Azure باستخدام الوظائف