نشر واجهة برمجة التطبيقات مع إجراءات GitHub Actions
أضفت واجهة برمجة التطبيقات الخاصة بك إلى تطبيق الويب الخاص بك وكلاهما يعمل محلياً. الآن حان الوقت لنشر واجهة برمجة التطبيقات والتطبيق الخاص بك إلى Azure Static Web Apps.
عندما أنشأت مثيل تطبيقات الويب الثابتة من Azure وطلبت منه مشاهدة فرعك الرئيسي، أُنشئَ إجراء GitHub لك. يستمع GitHub Action إلى الفرع الرئيسي للمستودع الخاص بك للتثبيتات وطلبات السحب. ثم عندما يكتشف إجراء GitHub Action هذه التغييرات، فإنه يقوم بإنشاء التطبيق الخاص بك ونشره.
عند إنشاء مورد Azure Static Web Apps، قمت بتوفير موقع المجلد لمشروع API الخاص بك عن طريق قبول القيمة الافتراضية لواجهة برمجة التطبيقات. أنشأت Azure Static Web Apps ونشرت تطبيق Azure Functions في هذا المجلد. ومع ذلك، لم يعمل التطبيق لأنه لم يتم إنشاء واجهة برمجة تطبيقات HTTP GET بعد.
تشغيل إجراء GitHub Action
إجراء GitHub مستعد لإنشاء تطبيق الويب وواجهة برمجة التطبيقات الخاصة بك ونشرها بمجرد اكتشاف تغيير في فرعك الرئيسي. يمكنك إما التثبيت مباشرة وإما إنشاء طلب سحب إلى الفرع الرئيسي. يؤدي كل من هذين التغييرين إلى تشغيل إجراء GitHub. عند الكشف عن التغييرات على الفرع الرئيسي ، فإنه يؤدي إلى إجراء GitHub لنشر التطبيق على نفس عنوان URL لموقع الويب المباشر الخاص بك.
بيئات ما قبل الإنتاج مع عناوين URL للمعاينة
قد ترغب أحياناً في رؤية التغييرات التي أجريتها في موقع مرحلي قبل النشر على موقع الويب المباشر. تتيح لك Azure Static Web Apps رؤية تغييراتك من خلال بيئات ما قبل الإنتاج التي يكون لكل منها عنوان URL للمعاينة الخاصة به. يمكنك إنشاء بيئة ما قبل الإنتاج عن طريق إنشاء طلب سحب مقابل الفرع الذي يراقبه إجراء GitHub. لا يتأثر موقع الويب المباشر الخاص بك. بدلا من ذلك، يتم إنشاء إصدار جديد من تطبيقك في بيئة ما قبل الإنتاج الخاصة به. إذا عدت وتحققت من طلب السحب على GitHub، فستلاحظ أنه يتم نشر ارتباط إلى إصدار ما قبل الإنتاج في علامة التبويب المحادثة.
يوضح الجدول التالي كيفية نشر Azure Static Web Apps لتطبيقك إلى عناوين URL مختلفة. يُنشر تطبيقك على عنوان URL واحد بينما يُنشر طلب السحب إلى الفرع نفسه على عنوان URL آخر. يتم توفير عناوين URL التي تم إنشاؤها تلقائيا بواسطة Azure Static Web Apps لتطبيق الإنتاج وطلبات السحب. يمكنك اختياريًا تعيين مجال مخصص لتطبيق التشغيل.
| Source | الوصف | URL |
|---|---|---|
| الفرع الرئيسي | مثال على عنوان URL لموقع ويب مباشر | https://purple-rain-062d03304.azurestaticapps.net/ |
| طلب السحب رقم 5 | مثال على عنوان URL للمعاينة | https://purple-rain-062d03304-5.<location>.azurestaticapps.net/ |
تعمل حالياً في فرع api. يمكنك إجراء طلب سحب من فرع api الخاص بك إلى الفرع الرئيسي. عند إنشاء طلب السحب مقابل الفرع الرئيسي ، ينشر إجراء GitHub التطبيق إلى بيئة ما قبل الإنتاج.
بمجرد اكتمال سير العمل من إنشاء تطبيقك ونشره، يضيف روبوت GitHub تعليقا إلى طلب السحب الخاص بك. يحتوي هذا التعليق على ارتباط إلى عنوان URL لبيئة ما قبل الإنتاج. يمكنك تحديد هذا الارتباط لمشاهدة التغييرات المرحلية.
بعد ذلك، يمكنك إنشاء طلب سحب وتزور الإصدار المرحلي من تطبيقك.