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

  • مقالة
  • قراءة خلال 6 دقائق

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

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

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

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

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


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

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

    Choose Create a new project

  2. اختر موقع دليل لمساحة عمل مشروعك واختر ⁧⁩تحديد⁧⁩. يوصى بإنشاء مجلد جديد أو اختيار مجلد فارغ كمساحة عمل المشروع.

    ملاحظة

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

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

    • ⁧⁩حدد اللغة الخاصة بمشروع الدالة:⁧⁩اختر ⁧Python⁩.

    • ⁧⁩حدد اسم مستعار للغة Python لإنشاء بيئة افتراضية⁧⁩: اختر موقع مترجم Python الخاص بك. إذا لم يتم عرض الموقع، فاكتب المسار الكامل إلى نظام Python الثنائي الخاص بك.

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

    • أدخل اسم دالة:"Type"HttpExample.

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

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


لا يمكنك إنشاء مشروع وظيفة؟

المشكلات الأكثر شيوعًا التي يجب حلها عند إنشاء مشروع دوال محلي هي:

  • لا يوجد ملحق دوال Azure مثبت لديك.

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

  1. اضغط ⁧⁩F5⁧⁩ لبدء مشروع تطبيق الدالة.

  2. في ⁧⁩اللوحة⁩ الطرفية، راجع نقطة النهاية لـ URL الخاص بدالتك التي تعمل محليًا.

    Local function VS Code output

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

    Execute function now from Visual Studio Code

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

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

  6. اضغط ⁧⁩«Ctrl + C»⁧⁩ لإيقاف «Core Tools»، وفصل مصحح الأخطاء.


لا يمكنك تشغيل الوظيفة محليا؟

المشكلات الأكثر شيوعًا التي يجب حلها عند تشغيل مشروع دوال محلي هي:

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

4. تسجيل الدخول إلى خدمة Azure

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

  1. اختر أيقونة Azure في شريط النشاط، ثم في ⁧منطقة ⁩⁩Azure: Functions⁦⁦، اختر ⁩⁩Sign in to Azure...⁦⁦

    Sign in to Azure within VS Code

  2. عندما يُطلب منك ذلك في المستعرض، ⁧⁩اختر حساب Azure خاصتك⁧⁩ و⁧⁩⁩سجل الدخول⁦⁦⁩ باستخدام بيانات اعتماد حساب Azure خاصتك.

  3. بعد تسجيل الدخول بنجاح، أغلق نافذة المتصفح الجديدة وارجع إلى Visual Studio Code.


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

يتضمن النشر الأول للتعليمة البرمجية الخاصة بك إنشاء مورد دالة في اشتراك Azure الخاص بك.

  1. اختر أيقونة Azure الموجودة في شريط النشاط، ثم في ⁧منطقة ⁩⁩Azure: Functions⁦⁦، اختر زر ⁩⁩Deploy to function app...⁦⁦

    Publish your project to Azure

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

    • ⁧⁩⁩⁩Select folder⁦⁦⁩: اختر المجلد الذي يحتوي على تطبيق دالتك.

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

    • ⁧⁩اختر تطبيق الدوال في خدمة Azure⁧⁩: اختر ⁧+ Create new Function App⁩.

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

    • ⁧⁩اختر وقت التشغيل:⁧⁩اختر إصدار Python الذي تقوم بتشغيله محليًا. يمكنك استخدام ⁧python --version⁩ الأمر للتحقق من الإصدار الخاص بك.

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

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

    Notification of Azure resource creation

  3. يتم عرض الإشعار بعد إنشاء تطبيق الدوال وتشغيل حزمة النشر. حدد ⁧⁩مخرجات العرض⁩ لعرض نتائج الإنشاء والنشر.

    Create complete notification


لا يمكنك نشر الوظيفة؟

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

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

ما هي الموارد التي تم إنشاؤها؟

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

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

6. تشغيل الدالة في منصة خدمة Azure

  1. بالعودة مرة أخرى إلى ⁧⁩منصة خدمة Azure: دوال⁧⁩ الشريط الجانبي، قم بتوسيع تطبيق الدالة الجديدة.

  2. قم بتوسيع ⁧⁩الدوال⁩ ثم انقر بزر الماوس الأيمن (Windows) أو⁧⁩ Ctrl - ⁧⁩انقر فوق الدالة (macOS) ⁧HttpExample⁩ واختر ⁧⁩تنفيذ الدالة الآن....⁧⁩.

    Execute function now in Azure from Visual Studio Code

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

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

  4. عند تنفيذ الدالة في منصة خدمة Azure وإرجاع استجابة، يتم إرسال إشعار في كود Visual Studio.

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

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

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

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

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

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

    Select the resource group to delete from the function app page.

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

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

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

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

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

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

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

هل تواجه مشكلات؟ أخبرنا.