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

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

المصدر: https://aicodeops.dev/ar/docs/gated-deploys · آخر تحديث: 2026-10-18

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

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

1. يجتاز تغيير الجلسة اختباراته ومراجعة الذكاء الاصطناعي، ويوافق عليه شخص. راجع [بوابات الجودة](https://aicodeops.dev/ar/docs/quality-gates).
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` بهذا الجسم:

```json
{
  "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` في سياسة مساحة عملك، وتطابق باسم البيئة. فمثلا، هذه القاعدة توقف النشر التلقائي إلى الإنتاج:

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

النشر المرفوض لا يرسل أبدا. ويسجل بالحالة **canceled**، ويعرض الصف العبارة "not deployed" مع السبب. وإذا تعذر تحميل السياسة، يلغى النشر بالطريقة نفسها. وهذه القواعد لا تستطيع إلا السماح أو الرفض؛ ولا تستطيع انتظار موافقة. والشخص الذي يختار **Retry delivery** يحكمه دوره، لا هذه القواعد. راجع [الموافقات والسياسات](https://aicodeops.dev/ar/docs/approvals-and-policies).

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

لعمليات النشر التي تجري خارج 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**. وتغذي السجلات مقاييس التسليم في لوحة المعلومات، و[حزمة الأدلة](https://aicodeops.dev/ar/docs/evidence-packs) الخاصة بالتغيير.

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

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

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

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

- [التراجع](https://aicodeops.dev/ar/docs/rollback)
- [بوابات الجودة](https://aicodeops.dev/ar/docs/quality-gates)
- [النشر عبر البوابات وتتبع التراجع](https://aicodeops.dev/ar/product/deploy)

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

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

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

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

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

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

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