وثائق

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

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

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

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

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

البيئات

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

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

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

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

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

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

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

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

خط نشر العملية

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

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

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

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

تحديد الإصدار

ما هو إصدار هذا الإصدار، وكيف يتم تعيينه أثناء عملية البناء؟

اختر مصدر إصدار كل إصدار: يقترح Coroid الإصدار التالي، ويقرأه Coroid من ملف في المستودع، أو تبلغ عنه خطتك الزمنية. يحصل كل إصدار أيضًا على رقم بناء يتزايد دائمًا. تعرض الشاشة القيم التي يمررها Coroid إلى خطتك الزمنية، ويمكنك فتح عمل جديد لطلب إضافتها إلى عملية البناء، كما تأخذ عنوان URL للإصدار لكل بيئة حتى يتحقق Coroid من الإصدار الذي يعمل عليه كل منها. إدراج الإصدار في عملية البناء يحتوي على التفاصيل وخطوات البناء للويب والخوادم وDocker وتطبيقات iOS وAndroid.

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

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