نشر واجهة برمجة التطبيقات باستخدام GitHub Actions

  • 3 دقائق

أضفت واجهة برمجة التطبيقات الخاصة بك إلى تطبيق الويب الخاص بك وكلاهما يعمل محلياً. حان الوقت الآن لنشر واجهة برمجة التطبيقات والتطبيق الخاص بك على Azure Static Web Apps.

عندما أنشأت مثيل تطبيقات الويب الثابتة من Azure وطلبت منه مشاهدة فرعك الرئيسي، أُنشئَ إجراء GitHub لك. يستمع إجراء GitHub لعمليات التثبيت ويسحب الطلبات إلى الفرع الرئيسي لمستودعك. ثم عندما يكتشف إجراء GitHub هذه التغييرات، فإنه ينشئ تطبيقك وينشره.

قد تتذكر عند إنشاء مورد Azure Static Web Apps التي قمت بتوفير موقع المجلد لمشروع واجهة برمجة التطبيقات الخاصة بك. لقد قمت بتوفير القيمة الافتراضية ⁧⁩لواجهة برمجة التطبيقات⁧⁩. أنشأت Azure Static Web Apps ونشرت تطبيق Azure Functions في هذا المجلد. ومع ذلك، نظرًا لأنك لم تقم بإنشاء واجهة برمجة تطبيقات HTTP GET بعد، فإن التطبيق لم يعمل.

تشغيل إجراء GitHub

إجراء GitHub مستعد لإنشاء تطبيق الويب وواجهة برمجة التطبيقات الخاصة بك ونشرها بمجرد اكتشاف تغيير في فرعك الرئيسي. يمكنك إما التثبيت مباشرة وإما إنشاء طلب سحب إلى الفرع الرئيسي. سيؤدي كلاهما إلى تشغيل إجراء GitHub. ستؤدي التغييرات التي اكتُشفت في الفرع الرئيسي إلى تشغيل إجراء GitHub لنشر التطبيق على عنوان URL نفسه لموقع الويب المباشر الخاص بك.

بيئات ما قبل التشغيل مع عناوين URL للمعاينة

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

يوضح الجدول التالي كيف تنشر Azure Static Web Apps تطبيقك على عناوين URL مختلفة. يُنشر تطبيقك على عنوان URL واحد بينما يُنشر طلب السحب إلى الفرع نفسه على عنوان URL آخر. توفر Azure Static Web Apps عناوين URL التي يتم إنشاؤها تلقائيا لتطبيق الإنتاج وطلبات السحب. يمكنك اختياريًا تعيين مجال مخصص لتطبيق التشغيل.

المصدر الوصف عنوان URL
الفرع الرئيسي مثال على عنوان URL لموقع الويب المباشر https://purple-rain-062d03304.azurestaticapps.net/
طلب السحب رقم 5 مثال على معاينة URL https://purple-rain-062d03304-5.<location>.azurestaticapps.net/

تعمل حالياً في فرع api. ستقدم طلب سحب من فرع api الخاص بك إلى الفرع الرئيسي. عند إنشاء طلب السحب مقابل الفرع الرئيسي، ينشر إجراء GitHub التطبيق لبيئة ما قبل التشغيل.

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

بعد ذلك، ستُنشئ طلب سحب وتزور الإصدار المرحلي من تطبيقك.