دليل مطور دالات Azure

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

تفترض هذه المقالة أنك قد قرأت بالفعل نظرة عامة على دالات Azure.

إذا كنت تفضل الانتقال مباشرة، يمكنك إكمال برنامج تعليمي للتشغيل السريع باستخدام Visual Studio أو تعليمة Visual Studio برمجية أو من المطالبة command.

إذا كنت تفضل الانتقال مباشرة، يمكنك إكمال برنامج تعليمي للبدء السريع باستخدام Maven (سطر الأوامر)، Eclipse، IntelliJ IDEA، Gradle، Quarkus، Spring Cloud، أو تعليمة Visual Studio برمجية.

إذا كنت تفضل الانتقال مباشرة، يمكنك إكمال برنامج تعليمي للبدء السريع باستخدام تعليمة Visual Studio برمجية أو من المطالبة command.

مشروع كود

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

تعتمد طريقة تخطيط مشروع التعليمات البرمجية وكيفية الإشارة إلى الأساليب في مشروعك على لغة تطوير مشروعك. للحصول على إرشادات مفصلة خاصة باللغة، راجع دليل مطوري C#‎.

تعتمد طريقة تخطيط مشروع التعليمات البرمجية وكيفية الإشارة إلى الأساليب في مشروعك على لغة تطوير مشروعك. للحصول على إرشادات خاصة باللغة، راجع دليل مطوري Java.

تعتمد طريقة تخطيط مشروع التعليمات البرمجية وكيفية الإشارة إلى الأساليب في مشروعك على لغة تطوير مشروعك. للحصول على إرشادات خاصة باللغة، راجع دليل مطوري Node.js.

تعتمد طريقة تخطيط مشروع التعليمات البرمجية وكيفية الإشارة إلى الأساليب في مشروعك على لغة تطوير مشروعك. للحصول على إرشادات خاصة باللغة، راجع دليل مطوري PowerShell.

تعتمد طريقة تخطيط مشروع التعليمات البرمجية وكيفية الإشارة إلى الأساليب في مشروعك على لغة تطوير مشروعك. للحصول على إرشادات خاصة باللغة، راجع دليل مطوري Python.

تعتمد طريقة تخطيط مشروع التعليمات البرمجية وكيفية الإشارة إلى الأساليب في مشروعك على لغة تطوير مشروعك. للحصول على إرشادات خاصة باللغات، راجع دليل مطوري Go.

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

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

أدوات التطوير

توفر الأدوات التالية تجربة تطوير ونشر محلية ومتكاملة ل دالات Azure بلغتك المفضلة:

فيجوال ستوديو

تعليمة Visual Studio برمجية
دالات Azure Core Tools (موجه الأوامر)

تتكامل هذه الأدوات مع دالات Azure Core Tools بحيث يمكنك تشغيل وتصحيح الأخطاء على الكمبيوتر المحلي باستخدام وقت تشغيل Functions. لمزيد من المعلومات، راجع Code دالات Azure واختبارها محليا.

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

يتم دعم تحرير المدخل للإصدار 3 Node.js فقط، والذي يستخدم ملف function.json.

Deployment

عند نشر مشروع التعليمات البرمجية الخاص بك إلى Azure، فإنك تقوم بشكل أساسي بنشر مشروعك إلى مورد تطبيق دالة موجود. يوفر تطبيق الوظائف سياق تنفيذ في Azure التي تعمل فيها وظائفك. على هذا النحو، إنها وحدة التوزيع والإدارة لوظائفك. من منظور مورد Azure، يعادل تطبيق الوظائف مورد موقع (Microsoft.Web/sites) في "Azure App Service"، وهو ما يعادل تطبيق ويب.

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

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

أثناء النشر Visual Studio

استخدام تعليمة Visual Studio برمجية
برمجيا باستخدام Azure CLI أو Azure PowerShell أو قوالب ARM أو ملفات Bicep
في المدخل Azure

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

الاتصال بالخدمات

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

سواء كنت تستخدم امتدادات الربط المقدمة من Functions أو تعمل مباشرة مع SDKs للعميل، فإنك تخزن بيانات الاتصال بأمان ولا تدرجها في الكود.

التخزين الافتراضي للمضيف

تتطلب دالات Azure حساب تخزين Azure عند إنشاء مثيل تطبيق الوظائف. يستخدم هذا الحساب الافتراضي داخليا من قبل مضيف الوظائف وبعض امتدادات الربط.

للتعرف على كيفية تعريف الاتصالات بأمان إلى حساب التخزين الافتراضي، راجع تعريف الاتصالات.

Bindings

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

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

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

الخصائص الشائعة للاتصالات المستندة إلى الهوية

تستخدم الاتصالات القائمة على الهوية ل دالات Azure الهويات المدارة للمصادقة. الهوية المعينة من النظام تستخدم افتراضيا، لكن يمكنك تحديد هوية معينة من قبل المستخدم باستخدام credential خصائص و clientId . للحصول على التفاصيل الكاملة حول تكوين الاتصالات القائمة على الهوية، بما في ذلك إعدادات التطبيقات المطلوبة وأمنيات RBAC، انظر تعريف اتصالات الهوية المدارة.

التطوير النحلي باستخدام الاتصالات المستندة إلى الهوية

عند التشغيل محليا، تستخدم الاتصالات القائمة على الهوية هوية المطور (مثل تسجيل الدخول إلى Azure CLI) بدلا من هوية مدارة. لا تحتاج إلى تحديد credentialclientId العقارات أثناء التطوير المحلي. لمزيد من المعلومات، راجع التطوير المحلي مع الاتصالات المستندة إلى الهوية.

SDKs العميل

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

ضع في اعتبارك هذه القضايا عند إنشاء واستخدام SDKs للعميل في كود الدالة الخاص بك:

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

عند إنشاء نسخة SDK للعميل في وظائفك، احصل على معلومات الاتصال المطلوبة من متغيرات البيئة.

عند إنشاء نسخة SDK للعميل في وظائفك، احصل على معلومات الاتصال المطلوبة من متغيرات البيئة.

عند إنشاء نسخة SDK للعميل في وظائفك، احصل على معلومات الاتصال المطلوبة من متغيرات البيئة.

عند إنشاء نسخة SDK للعميل في وظائفك، احصل على معلومات الاتصال المطلوبة من متغيرات البيئة.

عند إنشاء نسخة SDK للعميل في وظائفك، احصل على معلومات الاتصال المطلوبة من متغيرات البيئة.

الإبلاغ عن المشكلات

Item	Description	Link
Runtime	مضيف البرنامج النصي، المشغلات والروابط، دعم اللغة	إصدار مشكلة
Templates	مشاكل في التعليمات البرمجية مع قالب الإنشاء	إصدار مشكلة