AI CodeOps

نشر عبر بوابات لتغييرات الذكاء الاصطناعي، مع سجلات التراجع

لا يستدعي AI CodeOps عنوان webhook للنشر لديك إلا بعد أن يجتاز تغيير الذكاء الاصطناعي البوابة ويدمج، ويسجل كل نشر وتراجع، ويفتح حادثة عند الفشل.

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

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

الوكلاء الذين يعملون

النشر ينفذه خط النشر لديك، لا وكيل. ويعمل الوكلاء على التغييرات المؤدية إليه وعلى ما يحدث بعده:

  • وكيل DevOps Engineer: يخطط تغييرات البنية التحتية وخطوط النشر ويطبقها في DevOps Change، بما فيها خطوات الطرح والتراجع، مع مراجعة مخاطر يجريها Security Auditor بينهما.
  • الوكيلان E2E Tester و Dependency Auditor وقرار go/no-go من Architect: سير العمل Release Readiness قبل الإصدار.
  • الوكيلان Incident Responder و Site Reliability: الفرز وتحليل ما بعد الحادثة في Incident Response، مع كتابة Builder لإجراء التخفيف.

الإصلاح الصادر عن Incident Response يمر بالبوابة والموافقة نفسيهما كأي تغيير آخر.

صفحة Deploys في AI CodeOps تعرض مقاييس DORA الأربعة وأحدث عمليات النشر في production و staging، إحداها موسومة بحالة rolled back

عرض توضيحي تفاعلي، ببيانات نموذجية.

المسار من التغيير إلى النشر

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

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

عناوين webhook للنشر

يمكن أن يكون لكل مشروع عنوان webhook للنشر، يضبط في صفحة Deployments (ضمن Release): عنوان HTTPS عام، والبيئة التي ينشر إليها، مثل staging أو production، وسر HMAC اختياري. وترفض العناوين الواقعة على شبكات خاصة قبل إرسال أي شيء.

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

POST /hooks/deploy HTTP/1.1
Content-Type: application/json
X-CodeOps-Signature: sha256=5c1f0e9a7b2d4c6e8f0a1b3c5d7e9f2a4b6c8d0e1f3a5b7c9d2e4f6a8b0c1d3e

{"event":"pr_merged","workspaceID":"wrk_01JA8X2B4D6F8H0K2M4P6R8T0V","projectID":"checkout","repo":"acme/checkout","prNumber":42,"prUrl":"https://github.com/acme/checkout/pull/42"}

ترويسة التوقيع لا توجد إلا إذا ضبطت سرا. وهي قيمة HMAC-SHA256 بالترميز الست عشري للجسم الخام، بمفتاح هو سرك، ليتحقق المستقبل لديك من أن الاستدعاء جاء من AI CodeOps. إذا أجاب المستقبل بحالة 2xx، تسجل عملية النشر بحالة in progress؛ وإلا تسجل بحالة failed، ويمكنك إعادة محاولتها. وكل إعادة محاولة سجل مستقل. ويسجل الإصدار قبل خروج الاستدعاء، فالدمج الذي يبلغ عنه مرتين لا ينشر مرتين.

سجلات النشر

كل عملية نشر، تلقائية كانت أم مدخلة يدويا، تصبح سجلا فيه المشروع والبيئة وقيمة SHA للإيداع ومرجع Git والإصدار، ومن أو ما أطلقها، والجلسة التي أنتجت التغيير. وحالتها queued أو in progress أو succeeded أو failed أو rolled back أو canceled. ويمكنك إضافة عمليات نشر جرت خارج AI CodeOps من صفحة Deployments أو عبر API، ليغطي السجل التاريخي عملية الإصدار لديك كلها.

صفحة كل تغيير تربط طلب السحب وعملية النشر الخاصين به، ويدخل كلاهما في حزمة الأدلة الموقّعة للتغيير.

التراجع يجري في خط النشر لديك. ولا يعيد AI CodeOps نشر نسخة أقدم. وزر Mark as rolled back في صفحة Deployments يضع عملية نشر بحالة succeeded أو failed في حالة rolled back، وتحتسب في معدل فشل التغييرات لديك. ولا يستطيع تغيير السجل إلا الأعضاء الذين يتيح لهم دورهم إدارة عمليات النشر.

النشر الفاشل يفتح حوادث. حين تفشل عملية نشر، يفتح AI CodeOps حادثة مرتبطة بها. وحالات الفشل في البيئات المسماة prod أو production أو live أو main تحصل على درجة خطورة أعلى. وحين يدمج إصلاح الحادثة، لا تحل الحادثة إلا بعد نشر الإصلاح.

بوابات الجودة المعنية

  • بوابة الإصدار قبل الدمج. طلب السحب الذي فتحته جلسة لا يدمج من لوحة التحكم إلا إذا ظلت بوابته ناجحة: المراجعة مكتملة، ولا ملاحظات مانعة، ولا اختبارات فاشلة على النسخة الحالية.
  • الموافقة أولا. جرت الموافقة على التغيير قبل فتح طلب السحب الخاص به، وتعديل كوده بعد ذلك يعيد تلك الموافقة إلى البداية.
  • سياسة النشر. يمكن لقاعدة release.deploy أن تسمح بالنشر التلقائي أو ترفضه لكل بيئة، مثل production. والنشر المرفوض يسجل بحالة canceled مع السبب. أما الشخص الذي يعيد محاولة النشر يدويا فيحكمه دوره.
  • الترقية بين البيئات من CI. استدعاء /api/release/check مع requireDeployedTo يرفض إصدارا ليست له بعد عملية نشر ناجحة في تلك البيئة.

مقاييس التسليم

تعرض لوحة المعلومات مقاييس DORA الأربعة لآخر 30 يوما، محسوبة من سجلات النشر والحوادث لديك: وتيرة النشر، والمهلة من الجلسة التي بدأت التغيير إلى نشره، ومعدل فشل التغييرات، وزمن الاستعادة. والنشر المرسل عبر webhook يبقى بحالة in progress إلى أن تحدث حالته، فأبق الحالات محدثة وإلا جاءت المقاييس أقل من الواقع.

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

إلى أين ينشر AI CodeOps؟

لا ينشر بنفسه إلى البنية التحتية. يستدعي عنوان webhook للنشر تضبطه لكل مشروع، موقّعا بسر HMAC اختياري، وخط النشر لديك هو من ينفذ النشر.

هل يتراجع AI CodeOps تلقائيا عن نشر فاشل؟

لا. التراجع يجري في خط النشر لديك. ثم تسم عملية النشر بحالة rolled back في AI CodeOps، الذي يحفظ السجل ويحتسبه في معدل فشل التغييرات لديك.

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

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

هل يمكن اشتراط موافقة بشرية على عمليات النشر؟

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

هل يمكن منع بيئة الإنتاج (production) إلى أن ينجح النشر في staging؟

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