AI CodeOps

النشر عبر البوابات

آخر تحديث

كيف يسلم AI CodeOps تغييرا مدموجا إلى خط النشر لديك: بوابة الجودة قبل الدمج، وعناوين webhook للنشر، وقواعد السياسة لكل بيئة، وسجلات النشر.

لا ينشر AI CodeOps الكود إلى بنيتك التحتية. يطبق بواباته على التغيير قبل أن يدمج، ويستدعي خط النشر لديك حين يدمج، ويحفظ سجلا بكل عملية نشر. وخط النشر لديك هو من ينفذ البناء والإصدار.

الطريق إلى النشر

  1. يجتاز تغيير الجلسة اختباراته ومراجعة الذكاء الاصطناعي، ويوافق عليه شخص. راجع بوابات الجودة.
  2. يفتح AI CodeOps طلب السحب.
  3. تدمجه أنت من لوحة التحكم. وتعمل بوابة الجودة مرة أخرى أولا: الملاحظات المفتوحة بخطورة high أو critical، أو الاختبارات الفاشلة، أو المراجعة غير المكتملة توقف الدمج.
  4. إذا كانت لمشروع التغيير وجهة نشر، يستدعي AI CodeOps عنوان webhook الخاص بها ويسجل عملية نشر.

الدمج يحتاج إلى دور يستطيع إدارة عمليات النشر: المالكون والمسؤولون والمطورون والأعضاء ومسؤولو DevOps. وإذا تعذر تشغيل فحص البوابة، لا يجري الدمج، وتظهر الرسالة "The release check couldn't run just now. Try again in a moment."

البوابة عند الدمج تنطبق على طلبات السحب التي فتحها AI CodeOps لجلسة. أما طلب السحب الذي كتبه شخص يدويا فلا جلسة له، فليس لدى البوابة ملاحظات ولا اختبارات تحكم بها عليه.

اضبط وجهة نشر

  1. افتح Release → Deployments واختر Deploy targets (وجهات النشر).
  2. لكل مشروع، أدخل العنوان في Deploy webhook URL. ويجب أن يكون عنوان https:// عاما.
  3. أدخل البيئة التي ينشر إليها في Environment. والقيمة الافتراضية هي production.
  4. أدخل سر توقيع في Signing secret إن شئت.
  5. اختر Save (حفظ).

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

ما يتلقاه عنوان webhook لديك

حين يدمج تغيير من لوحة التحكم، يرسل AI CodeOps طلب POST بهذا الجسم:

{
  "event": "pr_merged",
  "workspaceID": "wrk_…",
  "projectID": "billing-api",
  "repo": "acme/billing-api",
  "prNumber": 42,
  "prUrl": "https://github.com/acme/billing-api/pull/42"
}

مع وجود سر توقيع، يحمل الطلب الترويسة X-CodeOps-Signature: sha256=<hex>: وهي قيمة HMAC-SHA256 للجسم الخام، بمفتاح هو سرك. تحقق منها قبل أن تنشر.

تنتهي مهلة الاستدعاء بعد 10 ثوان ولا يتبع إعادات التوجيه. والجواب 2xx يسجل عملية النشر بالحالة in progress. وأي جواب آخر يسجلها بالحالة failed، مع الرسالة "The deploy webhook answered HTTP …"، ويفتح حادثة. اختر Retry delivery (إعادة محاولة التسليم) في الصف لإرساله من جديد؛ وكل إعادة محاولة سجل جديد.

لا يستطيع خط النشر لديك إبلاغ AI CodeOps بالنتيجة النهائية، ولذلك يبقى النشر المرسل عبر webhook بالحالة in progress في السجل التاريخي. ولتسجيل نشر منته مع نتيجته، سجله يدويا (أدناه).

السماح بالنشر التلقائي أو رفضه

يتبع النشر التلقائي قواعد release.deploy في سياسة مساحة عملك، وتطابق باسم البيئة. فمثلا، هذه القاعدة توقف النشر التلقائي إلى الإنتاج:

{ "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" }

النشر المرفوض لا يرسل أبدا. ويسجل بالحالة canceled، ويعرض الصف العبارة "not deployed" مع السبب. وإذا تعذر تحميل السياسة، يلغى النشر بالطريقة نفسها. وهذه القواعد لا تستطيع إلا السماح أو الرفض؛ ولا تستطيع انتظار موافقة. والشخص الذي يختار Retry delivery يحكمه دوره، لا هذه القواعد. راجع الموافقات والسياسات.

سجل عملية نشر يدويا

لعمليات النشر التي تجري خارج AI CodeOps:

  1. افتح Release → Deployments واختر Record deployment (تسجيل عملية نشر).
  2. اختر المشروع في Project وأدخل البيئة في Environment.
  3. اضبط الحالة في Status: succeeded أو in progress أو queued أو failed.
  4. أضف إصدارا في Version وقيمة في Commit SHA (7 أحرف على الأقل) إن شئت.
  5. اختر Record deployment.

سجلات النشر

في كل سجل المشروع والبيئة ورقم تسلسلي لكل بيئة، والإيداع أو الإصدار، والحالة، ووقتا البدء والانتهاء، والجلسة التي أنتجت التغيير. والحالات هي queued و in progress و succeeded و failed و rolled back و canceled.

عملية النشر التي تنجح لتغيير جلسة تسم التغيير بالحالة deployed في Develop → Changes. وتغذي السجلات مقاييس التسليم في لوحة المعلومات، وحزمة الأدلة الخاصة بالتغيير.

افحص إصدارا من CI

يستطيع خط CI لديك أن يسأل بوابة الإصدار قبل أن ينشر. استدع POST /api/release/check بمفتاح API لمساحة العمل، وعنوان طلب السحب أو قيمة SHA للإيداع، وخيارات مثل requireDeployedTo. ومع "requireDeployedTo": "staging"، يرفض الإصدار ما لم تكن للتغيير من قبل عملية نشر ناجحة في staging، وتظهر الرسالة "Not yet deployed to "staging" — promote there before releasing". افحص allowed في الرد. والحقول موجودة في صفحة API، وفي بوابة الإصدار في CI مهام جاهزة للنسخ.

ويمكنك تشغيل الفحص نفسه يدويا من Review & Gate → Release gate: أدخل عنوان طلب سحب أو قيمة SHA لإيداع واختر Evaluate gate (تقييم البوابة).

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

الأسئلة الشائعة

هل ينشر AI CodeOps إلى خوادمي؟

لا. يستدعي عنوان webhook للنشر تضبطه لكل مشروع، وخط النشر لديك هو من ينفذ النشر. ولا يحتفظ AI CodeOps بأي بيانات اعتماد لبنيتك التحتية.

هل يمكن لسياسة أن توقف النشر التلقائي إلى الإنتاج؟

نعم. تستطيع قاعدة release.deploy رفض النشر التلقائي لكل بيئة. والنشر المرفوض يسجل بالحالة canceled، مع السبب، ولا يرسل شيء.

هل يمكن أن ينتظر النشر موافقة بشرية؟

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

هل كانت هذه الصفحة مفيدة؟