تمرين - إنشاء دالة مشغل HTTP

  • 7 دقائق

يتكون هذا المشروع الإرشادي من التدريبات التالية:

  • إنشاء تطبيق الوظيفة
  • نشر دالة HTTP-trigger
  • نقاط النهاية وسجلات المراجعة

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

يشمل هذا التمرين المهام التالية:

  • فتح Cloud Shell
  • إنشاء مشروع الدالة
  • نشر الدالة في Azure

النتيجة: نقطة نهاية HTTP قابلة للاستدعاء يتم نشرها على تطبيق الوظائف الخاص بك باستخدام Cloud Shell.

المهمة 1: فتح غلاف السحابة

شغل Azure Cloud Shell حتى تتمكن من استخدام سطر الأوامر لإنشاء ونشر دالة.

  1. في بوابة Azure، اختر أيقونة Cloud Shell في شريط الأدوات العلوي (يبدو كأنه موجه >أوامر _).
  2. إذا طلب منك اختيار Bash أو PowerShell، اختر Bash. إذا فتح Cloud Shell دون توجيه، انظر في الزاوية العلوية اليسرى من لوحة Cloud Shell. إذا رأيت زر التبديل إلى الباش ، اختر ذلك. إذا رأيت التحول إلى PowerShell، فأنت بالفعل في Bash. قد يستغرق الأمر دقيقة حتى يتم تهيئة Cloud Shell.
  3. إذا طلب مني إنشاء التخزين، اختر إنشاء التخزين وانتظر تهيئة Cloud Shell.
  4. تأكد من رؤية موجه أوامر Bash في أسفل البوابة.

ملحوظة

خطوة التحقق: تأكد من أن جهاز Cloud Shell مفتوح ويظهر تنبيه $ .

المهمة 2: إنشاء مشروع الدالة

استخدم أدوات Azure Functions الأساسية في Cloud Shell لدعم مشروع دالة جديد باستخدام مشغل HTTP.

  1. عند موجه Cloud Shell، شغل الأمر التالي لإنشاء مجلد وظيفة جديد لمشروع الوظيفة ثم انتقل إليه:

    mkdir func-gp-endpoint && cd func-gp-endpoint

  2. شغل الأمر التالي لتهيئة مشروع وظائف جديد باستخدام وقت التشغيل Node.js. قد يستغرق هذا دقيقة أثناء تثبيت الطرود المطلوبة.

    func init --worker-runtime node --language javascript --model V4

  3. شغل الأمر التالي لإضافة دالة يتم تفعيلها عبر HTTP باسم GetStatus:

    func new --name GetStatus --template "HTTP trigger" --authlevel anonymous

    ملحوظة

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

  4. تأكد من أن الإخراج يظهر أن الدالة تم إنشاؤها عن طريق تشغيل:

    ls src/functions/

    يجب أن ترى ملفا اسمه GetStatus.js.

ملحوظة

خطوة التحقق: تأكد من أنك ترى GetStatus.js في src/functions/ الدليل.

المهمة 3: نشر الدالة على Azure

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

  1. شغل الأمر التالي للبحث عن اسم تطبيق الوظيفة الخاص بك وتخزينه في متغير:

    FUNC_APP_NAME=$(az functionapp list --resource-group rg-gp-functions-endpoint --query "[0].name" -o tsv)
echo $FUNC_APP_NAME

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

  2. شغل الأمر التالي لنشر مشروع الدالة في تطبيق الوظائف الخاص بك:

    func azure functionapp publish $FUNC_APP_NAME

  3. انتظر حتى يكتمل التوزيع. يعرض المخرج عنوان URL العام للوظيفة، والذي يبدو كالتالي:

    Functions in <your-function-app-name>:
    GetStatus - [httpTrigger]
        Invoke url: https://<your-function-app-name>.azurewebsites.net/api/getstatus

  4. انسخ رابط Invoke من المخرج. تستخدم هذا الرابط في التمرين التالي لاختبار الدالة.

ملحوظة

خطوة التحقق: تأكد من أن مخرجات النشر تظهر دالة GetStatus مع عنوان URL لاستدعاء.