دعم واجهة برمجة التطبيقات في Azure Static Web Apps باستخدام Azure Container Apps
Azure Container Apps هو نظام أساسي مدار لاستضافة حاويات بلا خادم وخدمات مصغرة.
عند ربط تطبيق الحاوية بتطبيق الويب الثابت الخاص بك، فإن أي طلبات لتطبيق الويب الثابت الخاص بك مع مسار يبدأ به /api تكون مدعومة بنفس المسار على تطبيق الحاوية.
بشكل افتراضي، عندما يتم ربط تطبيق حاوية بتطبيق ويب ثابت، يقبل تطبيق الحاوية فقط الطلبات التي يتم تثبيتها من خلال تطبيق الويب الثابت المرتبط. يمكن ربط تطبيق الحاوية بتطبيق ويب ثابت واحد في كل مرة.
تتضمن خيارات واجهة برمجة التطبيقات لتطبيقات الويب الثابتة خدمات Azure التالية:
راجع نظرة عامة على واجهات برمجة التطبيقات لمزيد من المعلومات.
إشعار
يتطلب التكامل مع Azure Container Apps خطة Static Web Apps Standard.
تكامل الواجهة الخلفية غير مدعوم في بيئات طلب سحب Static Web Apps.
المتطلبات الأساسية
لربط تطبيق حاوية بتطبيق الويب الثابت، تحتاج إلى مورد Container Apps موجود وتطبيق ويب ثابت.
| مورد | الوصف |
|---|---|
| Azure Container Apps | إذا لم يكن لديك واحد بالفعل، فاتبع الخطوات الواردة في دليل توزيع تطبيق الحاوية الأول. |
| تطبيق ويب ثابت موجود | إذا لم يكن لديك واحد بالفعل، فاتبع الخطوات الواردة في دليل البدء لإنشاء تطبيق ويب ثابت No Framework . |
مثال
ضع في اعتبارك مثيل Azure Container App موجود يعرض نقطة نهاية عبر الموقع التالي.
https://my-container-app.red-river-123.eastus2.azurecontainerapps.io/api/getProducts
بمجرد الربط، يمكنك الوصول إلى نفس نقطة النهاية هذه من خلال api المسار من تطبيق الويب الثابت، كما هو موضح في عنوان URL هذا المثال.
https://red-sea-123.azurestaticapps.net/api/getProducts
يشير كلا عنواني URL إلى نفس نقطة نهاية واجهة برمجة التطبيقات. يجب أن تحتوي نقطة النهاية على تطبيق الحاوية على البادئة /api ، نظرا لأن Static Web Apps تطابق الطلبات المقدمة إلى /api المورد المرتبط وتوكله.
ربط تطبيق حاوية
لربط تطبيق حاوية كواجهة خلفية لواجهة برمجة التطبيقات لتطبيق ويب ثابت، اتبع الخطوات التالية:
في مدخل Microsoft Azure، انتقل إلى تطبيق الويب الثابت.
حدد واجهات برمجة التطبيقات من قائمة التنقل.
حدد موقع البيئة التي تريد ربط مثيل APIM بها. حدد ارتباط.
في Backend resource type، حدد Container App.
في Subscription، حدد الاشتراك الذي يحتوي على تطبيق الحاوية الذي تريد ربطه.
في Resource name، حدد تطبيق الحاوية.
حدد ارتباط.
عند اكتمال عملية الربط، يتم نقل الطلبات إلى المسارات التي تبدأ بتطبيق /api الحاوية المرتبطة.
إدارة الوصول إلى تطبيق الحاوية
يتم تكوين تطبيق الحاوية الخاص بك مع موفر هوية يسمى Azure Static Web Apps (Linked) يسمح فقط بنسبة استخدام الشبكة التي يتم نقلها من خلال تطبيق الويب الثابت. لجعل تطبيق الحاوية الخاص بك متاحا للتطبيقات الأخرى، قم بتحديث تكوين المصادقة الخاص به لإضافة موفر هوية آخر أو تغيير إعدادات الأمان للسماح بالوصول غير المصادق عليه.
إلغاء ربط تطبيق حاوية
لإلغاء ربط تطبيق حاوية بتطبيق ويب ثابت، اتبع الخطوات التالية:
في مدخل Microsoft Azure، انتقل إلى تطبيق الويب الثابت.
حدد واجهات برمجة التطبيقات من قائمة التنقل.
حدد موقع البيئة التي تريد إلغاء ارتباطها وحدد اسم تطبيق الحاوية.
حدد إلغاء الارتباط.
عند اكتمال عملية إلغاء الربط، لم تعد الطلبات إلى المسارات التي تبدأ بها /api موصولة بتطبيق الحاوية.
إشعار
لمنع تعريض تطبيق الحاوية عن طريق الخطأ لنسبة استخدام الشبكة المجهولة، لا يتم حذف موفر الهوية الذي تم إنشاؤه بواسطة عملية الربط تلقائيا. يمكنك حذف موفر الهوية المسمى Azure Static Web Apps (Linked) من إعدادات مصادقة تطبيق الحاوية.
إزالة المصادقة من مورد Container Apps
لتمكين مورد Container Apps من تلقي نسبة استخدام الشبكة المجهولة، اتبع الخطوات التالية لإزالة موفر الهوية:
في مدخل Microsoft Azure، انتقل إلى مورد Container Apps.
حدد Authentication من قائمة التنقل.
من قائمة موفري الهوية، احذف موفر الهوية المرتبط بمورد Static Web Apps.
حدد إزالة المصادقة لإزالة المصادقة والسماح بنسبة استخدام الشبكة المجهولة إلى مورد Container Apps.
أصبح مورد Container Apps الخاص بك قادرا الآن على تلقي نسبة استخدام الشبكة المجهولة.