مراجعة طلبات السحب في بيئات ما قبل الإنتاج

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

إشعار

لا يتم دعم بيئات طلب السحب تلقائيا ل Azure DevOps، ولكن يمكنك استخدام البيئات المسماة لإعدادها يدويا.

تنشئ Azure Static Web Apps سير عمل YAML في المستودع. عند إنشاء طلب سحب مقابل فرع يراقبه سير العمل، يتم إنشاء بيئة ما قبل الإنتاج. تعمل بيئة ما قبل الإنتاج على مراحل التطبيق، بحيث يمكنك مراجعة التغييرات قبل دفعها إلى الإنتاج. ترتبط دورة حياة بيئة ما قبل الإنتاج بطلب السحب. بمجرد إغلاق طلب السحب، يتم حذف بيئة ما قبل الإنتاج تلقائيا.

يمكنك القيام بالمهام التالية داخل بيئات ما قبل الإنتاج:

  • مراجعة التغييرات المرئية بين الإنتاج والتقسيم المرحلي، مثل تحديثات المحتوى والتخطيط
  • إظهار التغييرات التي تم إجراؤها على فريقك
  • مقارنة إصدارات مختلفة من التطبيق الخاص بك
  • التحقق من صحة التغييرات باستخدام اختبارات القبول
  • إجراء عمليات التحقق من السلامة قبل التوزيع إلى الإنتاج

المتطلبات الأساسية

  • مستودع GitHub موجود تم تكوينه باستخدام Azure Static Web Apps. راجع إنشاء أول تطبيق ثابت إذا لم يكن لديك تطبيق.

إجراء تغيير

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

  1. انتقل إلى مستودع مشروعك على GitHub، ثم حدد Branch.

    Create new branch using GitHub interface

  2. أدخل اسم فرع وحدد إنشاء فرع.

  3. انتقل إلى مجلد التطبيق وقم بتغيير بعض محتويات النص، مثل عنوان أو فقرة. حدد تحرير لإجراء التغيير في الملف.

    Edit file button in GitHub interface

  4. حدد Commit changes عند الانتهاء.

    Screenshot showing the Commit changes button in the GitHub interface.

إنشاء طلب سحب

إنشاء طلب سحب لنشر التحديث الخاص بك.

  1. افتح علامة تبويب طلب السحب لمشروعك على GitHub.

    Screenshot showing the pull request tab in a GitHub repo.

  2. حدد مقارنة طلب السحب.

  3. بشكل اختياري، أدخل تفاصيل حول التغييرات التي أجريتها، ثم حدد إنشاء طلب سحب.

    Screenshot showing the pull request creation in GitHub.

قم بتعيين المراجعين وإضافة تعليقات لمناقشة التغييرات التي أجريتها، إذا لزم الأمر.

يمكن أن تتعايش بيئات متعددة قبل الإنتاج في نفس الوقت عند استخدام Azure Static Web Apps. في كل مرة تقوم فيها بإنشاء طلب سحب مقابل الفرع الذي تتم مراقبته، يتم نشر إصدار مرحلي مع تغييراتك في بيئة متميزة قبل الإنتاج.

يمكنك إجراء تغييرات متعددة ودفع عمليات تثبيت جديدة إلى فرعك. يتم تحديث طلب السحب تلقائيا ليعكس جميع التغييرات.

مراجعة التغييرات

يعمل سير عمل نشر GitHub Actions وينشر تغييرات طلب السحب إلى بيئة ما قبل الإنتاج.

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

  1. حدد عنوان URL قبل الإنتاج لمشاهدة التغييرات المرحلية.

    Screenshot of pull request comment with the pre-production URL.

    يتم إنشاء عنوان URL على النحو التالي: https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.net. بالنسبة لطلب سحب معين، يبقى عنوان URL كما هو، حتى إذا قمت بدفع تحديثات جديدة. يتم أيضا إعادة استخدام نفس بيئة ما قبل الإنتاج طوال عمر طلب السحب.

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

نشر التغييرات

دمج طلب السحب للنشر إلى الإنتاج.

  1. حدد Merge pull request.

    Screenshot showing the Merge pull request button in GitHub interface.

    يتم نسخ التغييرات إلى الفرع المتعقب (فرع "الإنتاج"). ثم يبدأ سير عمل التوزيع على الفرع المتعقب وتنتقل التغييرات مباشرة بعد إعادة بناء التطبيق الخاص بك.

  2. افتح عنوان URL للإنتاج لتحميل الإصدار المباشر من موقع الويب والتحقق.

القيود

  • يمكن لأي شخص الوصول إلى الإصدارات المرحلية من التطبيق الخاص بك عبر عنوان URL الخاص به، حتى إذا كان مستودع GitHub الخاص بك خاصا.

    تحذير

    كن حذرا مع المحتوى الحساس، حيث يمكن لأي شخص الوصول إلى بيئات ما قبل الإنتاج.

  • يعتمد عدد بيئات ما قبل الإنتاج المتوفرة لكل تطبيق تم نشره باستخدام Static Web Apps على خطة الاستضافة الخاصة بك. على سبيل المثال، مع المستوى المجاني، يمكنك الحصول على ثلاث بيئات ما قبل الإنتاج جنبا إلى جنب مع بيئة الإنتاج.

  • لا يتم توزيع بيئات ما قبل الإنتاج جغرافيا.

  • تدعم عمليات نشر GitHub Actions فقط بيئات ما قبل الإنتاج.

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