أحداث النشر وإعدادات نظام التكامل المستمر

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

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

أدوات GitHub Actions وGitLab CI/CD#

إذا كنت ترغب في نشر إلى… زر على صفحة الإصدار، اختر Coroid يبدأ سير عمل GitHub Actions أو Coroid يبدأ خط أنابيب GitLab CI/CD في إعدادات خط أنابيب النشر الخاصة بالبيئة. أدخل اسم مهمة النشر الدقيق، ومرجع الفرع أو العلامة، واسم ملف سير العمل الخاص بـ GitHub عند الاقتضاء. يجب أن يشير هذا المرجع إلى التزام الإصدار وقت الطلب. يتلقى سير عمل GitHub coroid_release_id، coroid_attempt_id، coroid_commit_sha، و coroid_environment مدخلات، بالإضافة إلى coroid_version، coroid_build_number و coroid_release_name عندما يعلن سير العمل عن وجودها. يتلقى GitLab القيم المطابقة بأحرف كبيرة COROID_* متغيرات. استخدم هذه القيم لنشر الإصدار والإبلاغ عن الالتزام الدقيق وعدد المحاولات. وضع رقم الإصدار في بناء البرنامج يوضح كيفية وضع رقم الإصدار في بناء البرنامج.

احفظ رمز رد الاتصال الخاص بالبيئة في قيم سرية لأدوات GitHub Actions أو متغيرات مشفرة من GitLab CI/CD. أرسل running حدث عند بدء مهمة النشر وحدث نهائي succeeded، failed، أو cancelled حدث عند انتهائه. يتحقق Coroid من تشغيل مزود الخدمة والالتزام ومهمة التسمية قبل قبول النجاح لخط أنابيب مُهيأ. يظل عنوان URL الخاص بتشغيل مزود الخدمة هو المكان المناسب لفحص السجلات. سير عمل إنتاج Coroid يحتوي على مثال عملي لأدوات GitHub Actions؛ قم بتعديل أسماء القيم السرية والمهمة لتتناسب مع مستودعك.

رد اتصال تكامل مستمر عام#

يمكن لخط أنابيب خارجي إرسال نفس الأحداث دون تفعيل ميزة الإرسال. قم بالمصادقة باستخدام رمز الوصول المقيد الخاص بالبيئة. يقبل نقطة النهاية JSON بهذا الشكل المُرقّم:

POST /api/v1/release-deployment-events
Authorization: Bearer <environment-callback-token>
Content-Type: application/json

{
  "schemaVersion": 1,
  "eventId": "ci:run-812:production:succeeded",
  "providerRunId": "run-812",
  "projectId": "<project-uuid>",
  "environmentKey": "production",
  "repository": "owner/repository",
  "commitSha": "0123456789abcdef0123456789abcdef01234567",
  "status": "succeeded",
  "occurredAt": "2026-09-24T12:00:00Z",
  "runUrl": "https://ci.example.com/runs/812"
}

تضمين releaseId و attemptId عند الإبلاغ عن تشغيل طلبه Coroid. أضف version و buildNumber لتسجيل ما تم نشره. بالنسبة لمشروع مضيف على Coroid، repository هو معرف المشروع. failureReason يمكنه شرح سبب فشل التشغيل. استخدم queued، running، succeeded، failed، أو cancelled من أجل status. احتفظ بـ واحد providerRunId خلال عملية التشغيل وأعطِ كل انتقال حالة معرفًا فريدًا eventId. يجب أن يحتفظ إعادة محاولة نفس الحدث بمعرفه؛ بينما يحتاج تشغيل التكامل المستمر الجديد إلى معرف تشغيل جديد. يجب أن يكون طابع زمني للحدث حديثًا. يتحقق Coroid من المستودع والبيئة والالتزام ونطاق الاعتمادات وحالة النهاية قبل تطبيقه؛ وتُحتفظ بالأحداث المتعارضة للمراجعة. يمكن لعملية نشر صالحة بدون إصدار مُعدّ أن تُنشئ إصدارًا ملاحظًا، وهو منفصل بوضوح عن المرشح المُعتمد مسبقًا.

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

ذات صلة#

• إعدادات الإصدار
• إصدارات
• عمليات الاستعادة وخطوط إصدار البرامج
• أضف رقم الإصدار إلى عملية البناء