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

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

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

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

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

يوضح لك هذا الفيديو كيفية إنشاء دالة Python في Azure باستخدام Visual Studio Code.

يتم أيضا وصف الخطوات الواردة في الفيديو في الأقسام التالية.

تكوين بيئتك

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

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

• إصدار Python الذي تدعمه Azure Functions. لمزيد من المعلومات، راجع كيفية تثبيت Python.

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

• ملحق Python لـ Visual Studio Code.

• ملحق Azure Functions ل Visual Studio Code، الإصدار 1.8.1 أو أحدث.

• محاكي التخزين المحلي لملحق Azurite V3. بينما يمكنك أيضا استخدام حساب تخزين Azure فعلي، تفترض هذه المقالة أنك تستخدم محاكي Azurite.

تثبيت الأدوات الأساسية أو تحديثها

يتكامل ملحق Azure Functions ل Visual Studio Code مع Azure Functions Core Tools بحيث يمكنك تشغيل وتصحيح وظائفك محليا في Visual Studio Code باستخدام وقت تشغيل Azure Functions. قبل البدء، من الجيد تثبيت Core Tools محليا أو تحديث تثبيت موجود لاستخدام أحدث إصدار.

في Visual Studio Code، حدد F1 لفتح لوحة الأوامر، ثم ابحث عن الأمر Azure Functions وتشغيله: تثبيت أو تحديث Core Tools.

يبدأ هذا الأمر تثبيتا مستندا إلى الحزمة لأحدث إصدار من Core Tools.

إنشاء مشروعك المحلي

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

1. حدد رمز Azure في شريط "النشاط". ثم في منطقة «مساحة العمل» (محلية)، حدد الزر +، واختر "إنشاء دالة" في القائمة المنسدلة. اختر إنشاء مشروع جديد حين يُطلب منك.

   

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

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

   المطالبة	التحديد
   تحديد لغة	اختر Python (Programming Model V2).
   حدد مترجم Python لإنشاء بيئة افتراضية	اختر مترجم Python المفضل لديك. إذا لم يتم عرض الموقع، فاكتب المسار الكامل إلى نظام Python الثنائي الخاص بك.
   تحديد قالب للدالة الأولى لمشروعك	اختر HTTP trigger.
   اسم الدالة التي تريد إنشاءها	أدخل HttpExample.
   مستوى التخويل	اختر ANONYMOUS بحيث يتمكن أي شخص من استدعاء نقطة النهاية للدالة الخاصة بك. لمزيد من المعلومات حول مستوى التخويل، راجع مفاتيح التخويل.
   تحديد الطريقة التي تريد فتح مشروعك بها	اختر Open in current window.

4. يستخدم Visual Studio Code المعلومات المقدمة وينشئ مشروع Azure Functions بمشغّل HTTP. يمكنك عرض ملفات المشروع المحلي في المستكشف. يحتوي ملف المشروع الذي تم function_app.py إنشاؤه على الوظائف الخاصة بك.

5. افتح ملف مشروع local.settings.json وتحقق من أن AzureWebJobsFeatureFlags الإعداد يحتوي على قيمة EnableWorkerIndexing. هذا مطلوب للدالات لتفسير مشروعك بشكل صحيح كنموذج Python v2 عند التشغيل محليا.

6. في ملف local.settings.json، قم بتحديث AzureWebJobsStorage الإعداد كما في المثال التالي:

   "AzureWebJobsStorage": "UseDevelopmentStorage=true",
   

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

بدء تشغيل المحاكي

1. لفتح لوحة الأوامر في تعليمة Visual Studio البرمجية، اضغط على F1. في لوحة الأوامر، ابحث عن Azurite: Start واختره.

2. تحقق من الشريط السفلي وتحقق من تشغيل خدمات محاكي Azurite. إذا كان الأمر كذلك، يمكنك الآن تشغيل الدالة محليا. ::: zone-end

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

يتكامل Visual Studio Code مع أدوات Azure Functions Core للسماح لك بتشغيل هذا المشروع على كمبيوتر التطوير المحلي قبل النشر إلى Azure.

1. لبدء الدالة محليا، اضغط على F5 أو أيقونة Run and Debug في شريط Activity على الجانب الأيسر. تعرض لوحة Terminal عملية الإخراج من Core Tools. يبدأ تطبيقك في لوحة المحطة الطرفية. يمكنك مشاهدة نقطة نهاية URL للوظيفة التي تم تشغيلها بواسطة HTTP وتعمل محليًا.

   

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

2. اختر، مع استمرار تشغيل Core Tools في Terminal، رمز Azure في شريط "النشاط". في منطقة "مساحة العمل"، يمكنك توسيع "مشروع محلي>وظائف". انقر بزر الماوس الأيمن (Windows) أو Ctrl - انقر فوق (macOS) الدالة الجديدة واختر Execute Function Now....

   

3. في Enter request body سترى قيمة نص رسالة الطلب الخاصة { "name": "Azure" }. اضغط فوق Enter لإرسال رسالة الطلب هذه إلى الوظيفة الخاصة بك.

4. عند تنفيذ الوظيفة محليًا وإرجاع استجابة، يرفع تنبيه في Visual Studio التعليمات البرمجية. تعرض معلومات حول تنفيذ الوظيفة في لوحة Terminal.

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

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

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

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

1. إذا لم تُسجل الدخول بالفعل، فاختر رمز Azure في شريط "النشاط". ثم في منطقة "الموارد"، اختر "تسجيل الدخول إلى Azure...".

   

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

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

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

إنشاء تطبيق الوظائف في Azure

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

1. حدد رمز Azure في شريط "النشاط". ثم في منطقة "الموارد"، حدد الرمز + وحدد الخيار "إنشاء تطبيق الوظائف في Azure".

   

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

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

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

   

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

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

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

   تلميح

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

نشر المشروع في Azure

هام

يستبدل التوزيع إلى تطبيق وظائف موجود دائمًا محتويات هذا التطبيق في Azure.

1. في منطقة الموارد لنشاط Azure، حدد موقع مورد تطبيق الدالة الذي أنشأته للتو، وانقر بزر الماوس الأيمن فوق المورد، وحدد Deploy to function app....

2. عند مطالبتك بالكتابة فوق عمليات التوزيع السابقة، حدد Deploy لنشر التعليمات البرمجية للدالة إلى مورد تطبيق الوظائف الجديد.

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

   

تشغيل الوظيفة في Azure

1. بالعودة إلى منطقة Resources في الشريط الجانبي قم بتوسيع الاشتراك الخاص بك، وتطبيق الوظائف الجديد وFunctions. انقر بزر الماوس الأيمن (Windows) أو Ctrl - انقر فوق الدالة (macOS) HttpExample واختر تنفيذ الدالة الآن....

   

2. في Enter request body سترى قيمة نص رسالة الطلب الخاصة { "name": "Azure" }. اضغط فوق Enter لإرسال رسالة الطلب هذه إلى الوظيفة الخاصة بك.

3. عند تنفيذ الوظيفة محليًا وإرجاع استجابة، يتم طرح تنبيه في تعليمة Visual Studio البرمجية.

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

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

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

1. لفتح لوحة الأوامر في تعليمة Visual Studio البرمجية، اضغط على F1. في لوحة الأوامر، ابحث عن Azure: Open in portal واختره.

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

3. في علامة التبويب نظرة عامة حدد الارتباط المسمى بجوار Resource group.

   

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

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

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

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

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

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

الاتصال إلى Azure Cosmos DB

الاتصال بقائمة انتظار التخزين على منصة خدمة Azure

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