وثائق

إعدادات الإصدار

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

توجد إعدادات الإصدارات مع باقي إعدادات المشروع. افتح المشروع، واختر إعدادات، ثم قم بتوسيع إصدارات. يوجد ثلاث شاشات، وكل منها تُجيب على سؤال واحد.

البيئات
إلى أين يتم نشر الإصدار؟ أضف محطات وحدد ترتيبها.
قواعد الموافقة
ما الذي يجب أن يتحقق أولاً؟ عمليات الموافقة والأدوار وقائمة التحقق وقواعد الإصلاح العاجل لكل بيئة.
خط أنابيب النشر
من يقوم بالنشر، وكيف تستقبل Coroid التقرير؟ يبدأ مسارك الخاص أو Coroid عملية النشر؛ ويسمح رمز التقرير لـ CI/CD بتأكيد النتيجة.
إعدادات المشروع ← الإصدارات تحتوي على ثلاث شاشات، كل منها يحتوي على سؤال واحد.

لا يمكن تغيير إعدادات الإصدارات إلا من قبل المالكين والمشرفين؛ بينما يمكن للآخرين قراءتها فقط. قم أولاً بربط المستودع، لأن كل إصدار يشير إلى التزام محدد فيه.

البيئات

إلى أي بيئة يتم نشر الإصدار، وبأي ترتيب؟

يبدأ كل مشروع ببيئة الإنتاج. أضف البيئات الأخرى التي تنشر إليها، مثل بيئة الاختبار أو بيئة ضمان الجودة، عبر إضافة بيئة. قم بإعطاء كل بيئة اسماً. يقترح Coroid مفتاحاً مستمداً من الاسم، على سبيل المثال staging. يستخدم CI/CD هذا المفتاح عند إرسال تقرير عن عملية النشر، لذا احرص على الحفاظ عليه ثابتاً بمجرد استخدامه في خطوط الأنابيب.

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

قواعد الموافقة

ما الذي يجب تحقيقه قبل نشر الإصدار هنا؟

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

  • الموافقات المطلوبة: عدد الأشخاص المختلفين الذين يجب أن يوافقوا. الصفر يسمح بنشر الإصدار فور اجتياز عمليات الفحص.
  • من يمكنه الموافقة: الأدوار التنظيمية المسموح لها بالموافقة.
  • فصل طالب الطلب عن الموافقين: الشخص الذي يبدأ عملية النشر لا يمكنه الموافقة عليها، وكذلك من يقوم بتحرير ملاحظات الإصدار لا يمكنه الموافقة عليها.
  • نجاح عمليات فحص الجودة: دائماً مفعّل. يعمل رسم بياني الجودة الخاص بالمشروع مع release_validation المشغّل ضد التزام محدد. قم بنشر ذلك الرسم البياني من إعدادات جودة المشروع.
  • البيئة السابقة أولاً: يجب أن يكون الإصدار قد نُشر بالفعل إلى البيئة التي يأتي بعدها هذا الإصدار.
  • ملاحظات الإصدار المُعتمدة: تحتاج الملاحظات الحالية إلى موافقة، ويتطلب أي تعديل لاحق إصدارًا جديدًا منها.
  • قائمة التحقق: خطوات يدوية يتأكد منها شخص ما في صفحة الإصدار، مثل "مراجعة ترحيل قاعدة البيانات". يمكن تحديد عنصر كضروري أو اختياري. يسمح العنصر الضروري باستثناء مؤقت. يقوم المالك أو المشرف بتسجيل السبب ومدة صلاحية تصل إلى 24 ساعة، ويقتصر الاستثناء على ذلك الالتزام والبيئة فقط.
  • قواعد الإصلاحات العاجلة: قواعد أخف للإصلاحات العاجلة: عدد عمليات الموافقة وما إذا كانت بيئة الإصدار السابقة وموافقة الملاحظات لا تزال سارية. تظل عمليات التحقق من الجودة وعناصر قائمة التحقق مطلوبة دائمًا، ولا يُسمح إلا للمالكين والمشرفين بالموافقة على الإصلاحات العاجلة.

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

خط أنابيب النشر

من يبدأ عملية النشر، وكيف يتعرف Coroid على ما حدث؟

اختر البيئة من الأعلى، ثم حدد طريقة بدء عمليات النشر:

  • ينشر خط أنابيبي تلقائيًا: احتفظ بعملية النشر الحالية. يسجل Coroid عمليات النشر عندما تبلغ عنها أداة CI/CD الخاصة بك، أو عندما يسجل مالك أو مشرف نشرًا خارجيًا في صفحة الإصدار.
  • يبدأ Coroid سير عمل GitHub Actions أو يبدأ Coroid خط أنابيب GitLab CI/CD: يظهر هذا الخيار عندما يكون مستودع المشروع على ذلك المزود. أدخل الفرع أو العلامة التي تشير إلى التزام الإصدار، وملف سير العمل الخاص بـ GitHub، واسم الوظيفة المحدد الذي يقوم بالنشر. يتحقق Coroid من المرجع قبل بدء التنفيذ، ويتحقق من الوظيفة المسماة قبل اعتبار العملية ناجحة.

تحت تقارير النشر، قم بإنشاء رمز تقرير للبيئة وخزّنه كسرّ في أداة CI/CD الخاصة بك. يعرض Coroid الرمز مرة واحدة ويحتفظ فقط بنسخة مشفرة منه. سيؤدي استبدال الرمز إلى إلغاء العمل بالرمز القديم فورًا. تُظهر الشاشة نفسها نقطة النهاية ومعرّف المشروع ومفتاح البيئة اللذين يحتاجهما خط الأنابيب، بالإضافة إلى ما إذا كانت التقارير تصل أم لا. أحداث النشر وإعدادات CI يحتوي على تنسيق الحدث وأمثلة عليه.

نقل الإعدادات بين المؤسسات

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