السابق

التالي

تمرين - إنشاء دالة Azure تُشغّل من خلال خطاف ويب

مكتمل

في هذا التمرين الأول، ستُنشئ التعليمة البرمجية الخاصة بك لتحليل رسائل حدث GitHub wiki في Azure Functions. ستُكون دالتك حتى تعمل عند تلقي رسالة خطاف الويب.

إنشاء Function App

1. سجّل الدخول إلى "مدخل Azure" باستخدام حساب MS Learn الخاص بك.

2. حدد Create a resource. يظهر إنشاء جزء مصدر.

3. في جزء القائمة الأيسر، ضمن Categories، حدد Compute، وفي مربع البحث Search services and marketplace، ابحث عن Function App وحدده. يظهر الجزء Function App.

4. حدد إنشاء. يظهر جزء Create Function App.

5. في علامة التبويب "Basics"، أدخل القِيم التالية لكل إعداد.

   إشعار

   يجب أن يكون اسم تطبيق الوظائف مُميزًا. نقترح استخدام شيء مثل <اسمك أو الأحرف الأولى من اسمك>triggerapp. استخدم هذا الاسم حيثما ترى <your-functionapp-name> في هذا التمرين.

   الإعداد	القيمة‬
   تفاصيل المشروع
   الوصف	اشتراك Concierge
   مجموعة الموارد	من القائمة المنسدلة، حدد مجموعة موارد بيئة الاختبار المعزولة [اسم مجموعة موارد بيئة الاختبار المعزولة].
   تفاصيل المثيل
   اسم Function App	<your-functionapp-name>
   نشر	الرمز
   مكدس وقت التشغيل	Node.js
   ‏‏الإصدار	اقبل افتراضيا
   المنطقة	اختر أقرب موقع لك والذي يُعد أيضاً إحدى مناطق بيئة الاختبار المعزولة المسموح بها.
   نظام التشغيل
   نظام تشغيل	Windows
   استضافه
   خيارات الاستضافة وخططها	الاستهلاك (دون خادم)

   تُتيح لك بيئة الاختبار المعزولة المجانية إنشاء موارد في مجموعة فرعية من مناطق Azure العالمية. حدد منطقة من القائمة التالية عند إنشاء الموارد:

   • West US 2
   • South Central US
   • Central US
   • شرق الولايات المتحدة
   • أوروبا الغربية

   • جنوب شرق آسيا
   • شرق اليابان
   • جنوب البرازيل
   • جنوب شرق أستراليا
   • وسط الهند‬

6. حدد Next : Storage لفتح علامة التبويب Storage . أدخل القيم التالية لكل إعداد.

   الإعداد	القيمة‬
   التخزين
   حساب التخزين	(جديد)، ووافق على الاسم الافتراضي.

7. حدد "Review + create".

8. يتحقق Azure من إدخالاتك. عند أنتهاء التحقق، اختر Create.

إنشاء دالة تُشغّل من خلال خطاف ويب

1. عند اكتمال عملية التوزيع، حدد Go to resource. يظهر جزء Overview من أجل Function App خاصتك.

2. ضمن Functions، حدد Create in Azure portal.

3. يظهر جزء Create Function.

4. ضمن Select a template، اختر HTTP trigger، ثم اختر Add. يظهر جزء HttpTrigger1 من أجل Function خاصتك، ويعرض الأساسيات للمشغّل الجديد لديك.

5. في جزء القائمة الأيسر، ضمن Developer، حدد Code + Test. سيظهر جزء Code + Test من أجل Function خاصتك، ويعرض ملف JavaScript الذي تم إنشاؤه من القالب. يجب أن يبدو مثل التعليمات البرمجية التالية.

   module.exports = async function (context, req) {
       context.log('JavaScript HTTP trigger function processed a request.');
   
       const name = (req.query.name || (req.body && req.body.name));
       const responseMessage = name
           ? "Hello, " + name + ". This HTTP triggered function executed successfully."
           : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";
   
       context.res = {
           // status: 200, /* Defaults to 200 */
           body: responseMessage
       };
   }
   

   ملف index.js هو دالة JavaScript التي أنشأها المدخل. يقرأ الطلب الاسم إما بتمريره كسلسلة استعلامات أو كجزء من نص الطلب، ويُجيب برسالة "Hello".

6. أعلى التعليمات البرمجية هو المسار مع قائمة منسدلة تظهر اسم الملف. من القائمة المنسدلة اختر function.json. يظهر ملف JSON الذي أنشأه القالب. يجب أن يبدو مثل التعليمات البرمجية التالية.

   {
       "bindings": [
           {
               "authLevel": "function",
               "type": "httpTrigger",
               "direction": "in",
               "name": "req",
               "methods": [
                   "get",
                   "post"
               ]
           },
           {
               "type": "http",
               "direction": "out",
               "name": "res"
           }
       ]
   }
   

   تحدد روابط JSON أن الوظيفة يتم تشغيلها بواسطة طلبات HTTP GET وPOST المُوجهة نحو عنوان URL لتطبيق الوظائف.

اختبار تشغيل دالتك

1. في شريط القوائم العلوي، حدد Get function URL.

2. في مربع الحوار Get function URL في القائمة المنسدلة Key، أسفل Function key، حدد default. في حقل URL حدد الأيقونة Copy to clipboard. سيبدو شكل عنوان URL شبيهاً بهذا:

   https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==
   

3. الصق عنوان URL هذا في مستعرض، وفي نهاية عنوان URL، ألحق معلمة سلسلة الاستعلام: &name=<yourname>، على سبيل المثال name=Dick و Jane.

4. لتنفيذ الطلب، اضغط على Enter. يظهر الرد الذي أعادته الدالة في المتصفح. سيبدو شيئاً شبيهاً بهذا:

   Hello Dick and Jane. This HTTP triggered function executed successfully.
   

تهانينا! لديك الآن دالة يمكن تشغيلها من خلال عنوان URL.

متابعة