دعم API في تطبيقات الويب الثابتة Azure with دالات Azure

غالبا ما تستدعي تطبيقات الويب الأمامية واجهات برمجة التطبيقات الخلفية للبيانات والخدمات. بشكل افتراضي، يوفر تطبيقات الويب الثابتة Azure نقاط نهاية API مدمجة بدون خادم عبر دالات Azure.

تتوفر واجهات برمجة التطبيقات دالات Azure في Static Web Apps بتكوينين محتملين اعتمادا على plan:

  • Managed functions: بشكل افتراضي، واجهة برمجة التطبيقات لتطبيق ويب ثابت هي تطبيق دالات Azure تدار وتنشر بواسطة تطبيقات الويب الثابتة Azure مرتبطة ببعض القيود.

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

يتباين الجدول التالي بين الاختلافات بين استخدام الدالات المدارة والحالية.

ميزة الدالات المدارة إحضار الوظائف الخاصة بك
الوصول إلى دالات Azure triggers and bindings HTTP فقط الكل
مدعوم دالات Azure runtimes1 راجع اللغات وأوقات التشغيل المدعومة. الكل
مدعوم دالات Azure <خطط استضافة c0> الاستهلاك‬ الاستهلاك‬
متميز
مخصصة
أمان متكامل مع الوصول المباشر إلى مصادقة المستخدم وبيانات التخويل المستندة إلى الدور
تكامل التوجيه الذي يجعل /api المسار متاحا لتطبيق الويب بشكل آمن دون الحاجة إلى قواعد CORS مخصصة.
نموذج البرمجة Durable Functions
الهوية المدارة
"Azure App Service" المصادقة والتفويض إدارة الرموز
وظائف API المتوفرة خارج تطبيقات الويب الثابتة Azure
Key Vault المراجع

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

تشمل خيارات واجهة برمجة التطبيقات ل Static Web Apps خدمات Azure التالية:

راجع نظرة عامة على واجهات برمجة التطبيقات لمزيد من المعلومات.

التكوين

تتوفر نقاط نهاية واجهة برمجة التطبيقات لتطبيق الويب من api خلال المسار.

الوظائف المدارة إنشاء الوظائف الخاصة بك
/api أثناء إصلاح المسار، يمكنك التحكم في موقع مجلد التعليمات البرمجية المصدر لتطبيق الوظائف المدارة. يمكنك تغيير هذا الموقع عن طريق تحرير ملف YAML لسير العمل الموجود في مجلد .github/workflows الخاص بالمستودع. ترسل طلبات مسار /api إلى تطبيق دالات Azure الحالي الخاص بك.

استكشاف الأخطاء وإصلاحها والسجلات

تتوفر السجلات فقط إذا أضفت Application Insights.

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

القيود

بالإضافة إلى واجهة برمجة التطبيقات Static Web Apps constraints، تنطبق القيود التالية أيضا على واجهات برمجة التطبيقات دالات Azure:

الوظائف المدارة إنشاء الوظائف الخاصة بك
  • تقتصر المشغلات والروابط على HTTP.
  • يجب أن يكون تطبيق دالات Azure إما في Node.js 12، Node.js 14، Node.js 16، Node.js 18، Node.js 20 (معاينة)، .NET Core 3.1، .NET 6.0، .NET 7.0، .NET 8.0، Python 3.8، Python 3.9، أو Python 3.10.
  • تتم إدارة بعض إعدادات التطبيق بواسطة الخدمة، لذلك يتم حجز البادئات التالية بحلول وقت التشغيل:
    • APPSETTING_، AZUREBLOBSTORAGE_، AZUREFILESSTORAGE_، AZURE_FUNCTION_، CONTAINER_، DIAGNOSTICS_، DOCKER_، FUNCTIONS_، IDENTITY_، MACHINEKEY_، MAINSITE_، MSDEPLOY_، SCMSITE_، SCM_، WEBSITES_، WEBSITE_، WEBSOCKET_، AzureWeb
  • تستخدم الخدمة بعض علامات التطبيق داخليا. لذلك، يتم حجز العلامات التالية:
    • AccountId، EnvironmentId، FunctionAppId.
  • أنت مسؤول عن إدارة نشر تطبيق Functions.

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