تخطيط تطبيق Static Web App الخاص بك من Azure
هدفك المطلق هو استضافة التطبيق الخاص بك في Azure. تراعي Azure Static Web Apps توفير جميع موارد Azure الضرورية لك.
ومع ذلك، قبل استضافة تطبيقك، تحتاج إلى شيء لإنشاء تطبيقك في أثناء إجراء التغييرات. يمكن أن تكون هذه التغييرات عن طريق الطلبات أو سحب الطلبات إلى المستودع الخاص بك. إحدى السمات الرئيسية لAzure Static Web Apps هو أنه يقوم بإعداد سير عمل GitHub Actionsb لإنشاء ونشر التطبيق الخاص بك.
عند إنشاء مورد Azure Static Web Apps، فإنه يقوم بإنشاء سير عمل GitHub Actions. يعمل سير العمل على الفور ويهتم بإنشاء التطبيق الخاص بك ونشره. كما يعمل سير العمل أيضًا في كل مرة تقوم فيها بإجراء تغيير على الفرع الذي تمت مراقبته في المستودع.
Azure Static Web Apps
إليك جانبين آليين لنشر تطبيق ويب. الأول منها يتضمن موارد Azure الأساسية التي تشكل التطبيق الخاص بك. والثاني هو سير عمل GitHub Actions الذي يقوم بإنشاء التطبيق الخاص بك ونشره.
عند نشر تطبيقك على الويب باستخدام Azure Static Web Apps، فإنك تحصل على استضافة سريعة لتطبيق الويب الخاص بك وواجهات برمجة التطبيقات القابلة للتطوير. كما أنك تحصل على سير عمل موحد للإنشاء والنشر وتقدمه من خلال GitHub Actions.
توصيل مثيل تطبيقات Static Web Apps بـ GitHub
تم تصميم Azure Static Web Apps لاستضافة التطبيقات بينما توجد التعليمات البرمجية المصدر على GitHub. عند إنشاء مثيل تطبيقات Static Web Apps، فسوف تقوم بتسجيل الدخول إلى GitHub وتحديد المستودع الذي يحتوي على رمز التطبيق.
كما تحتاج أيضًا إلى تحديد مجلد ذي ثلاثة مسارات داخل المستودع حتى يمكن إنشاء التطبيق ونشره تلقائيًا:
| الموقع | مثال على الموقع | الوصف | مطلوب |
|---|---|---|---|
| موقع التطبيق | العمیل | موقع رمز المصدر لتطبيق الويب الخاص بك | نعم |
| “Output location” | wwwroot | موقع البيانات الصناعية لتطبيقك | لا |
| موقع واجهة برمجة التطبيقات | Api | موقع رمز المصدر لواجهة برمجة التطبيقات الخاص بك | لا |
يُعد موقع البيانات الصناعية للتطبيق مسارًا نسبيًا إلى دليل النشر الخاص بالتطبيق. على سبيل المثال، اعتبر أن لدينا تطبيقًا على Client والذي يخرج أصول إنشائه في مجلد bin/<build profile>/<framework>/publish/wwwroot. في هذه الحالة، لا تحتاج إلا لتحديد wwwroot هذا الموقع، حيث إن نظام النشر سوف يعتني ببقية البادئة.
من رمز المصدر إلى الأصول الثابتة مع GitHub Actions
يحتوي GitHub repo على رمز مصدري، وليس أصولاً ثابتة، ولذلك يجب إنشاؤه قبل نشره.
عند إنشاء مثيل تطبيقات Static Web Apps، يقوم Azure بإنشاء سير عمل GitHub Actions في المستودع. في كل مرة تقوم فيها بإجراء تغييرات أو إنشاء طلب سحب مقابل الفرع الذي تحرر منه، يقوم سير العمل بإنشاء التطبيق، وتحويل رمز المصدر إلى أصول ثابتة يمكن أن تقدمها Azure. بمجرد اكتمال الإنشاء، يقوم الإجراء بنشر الأصول.
تتم إضافة GitHub Action إلى المستودع في المجلد .github/workflows. يمكنك مراجعة أو تعديل هذا الملف كما يتطلب. يتم تخزين الإعدادات التي تقوم بإدخالها عند إنشاء المورد في ملف GitHub Action.
واجهة برمجة التطبيقات المتكاملة مع وظائف Azure
إذا كان تطبيقك يتطلب “API”، فإنه يمكنك تنفيذه كـ”Azure Functions project” في المستودع الخاص بك. وتلقائيًا سيتم نشره واستضافته من قِبل مثيل “Static Web Apps”. سير عمل GitHub Actions الذي يقوم بإنشاء ونشر تطبيقك يحدد موقع واجهة برمجة التطبيقات داخل الريبو باسم المجلد الذي تحدده.
عادةً ما تقوم بتسمية المشروع من أجل “API” الخاص بك Api بداخله، وعلى هذا النحو ستحتاج إلى التأكد من تعيين ذلك إلى “API location” لملف سير العمل.
ماذا لو ليس لديك واجهة برمجة التطبيقات؟ لا تخف. إذا لم تتمكن Azure Static Web Apps من العثور على واجهة برمجة تطبيقات في المجلد الذي تشير إليه، فلن تنشر واجهة برمجة تطبيقات، ولكنها ستظل تنشر تطبيقك.
الخطوات التالية
فما الذي تحتاجه لتتمكن من نشر تطبيق الويب الخاص بك إلى “Azure Static Web Apps”؟ كل ما تحتاجه هو وجود تطبيقك في مستودع GitHub الخاص بك.
هل تحتاج إلى مساعدة؟ راجع دليل استكشاف الأخطاء وإصلاحها الذي نقدمه أو يمكنك توفير ملاحظات معينة عبر الإبلاغ عن مشكلة.