# عمليات النشر

> تابِع سجلات البناء، وارجع إلى بناء سابق، وشغّل النشر عبر رابط.

Source: https://gheima.ma/ar/docs/deployments

كل بناء هو نشر. تابِعه مباشرةً، وارجع عند الحاجة، وشغّل النشر من خارج غيمة.

### تابِع سجلات البناء والتشغيل

في صفحة الخدمة، يقدّم تبويب السجلات عرضين. «البناء» يبثّ البناء خطوة بخطوة في الزمن الحقيقي، و«التشغيل» يعرض مخرجات حاويتك العاملة. استخدم مربع البحث للتصفية، أو فعّل التمرير التلقائي، أو نزّل السجلات في ملف.

### الرجوع إلى الوراء

1. **افتح تبويب عمليات النشر** — ترى كل نشر من الأحدث إلى الأقدم، مع التزامه وحالته.
2. **أعِد نشر التزام سابق** — انقر «إعادة النشر» على عملية نشر سابقة لإعادة بناء ذلك الالتزام ونشره.

> Note: تُحدَّث القائمة تلقائيًا أثناء تقدّم بناء (في الانتظار أو البناء أو النشر).

### خطافات النشر (النشر عبر رابط)

خطاف النشر رابط سرّي يُطلق عملية نشر عندما يتلقى طلب POST. استخدمه من CI أو من أي نظام خارجي آخر. في الإعدادات، انقر «إنشاء خطاف نشر» (للمالكين والمسؤولين فقط)، ثم أرسل طلب POST إلى الرابط:

```bash
curl -X POST https://gheima.ma/api/deploy/hooks/<token>
```

يعيد { ok: true, deploymentId }. جدّد الخطاف أو عطّله في أي وقت.

### حالات النشر

- مع تقدّم البناء، تمرّ عملية النشر بالحالات: في الطابور، ثم جارٍ البناء، ثم جارٍ الرفع، ثم جارٍ النشر، وتنتهي بحالة مباشر.
- تعني حالة فشل أن خطوة ما تعثّرت. راجع سجلات البناء، وأصلِح المشكلة، ثم ادفع مجددًا.
- تُحدَّث القائمة تلقائيًا أثناء وجود نشر قيد التقدّم.

### إعادة التشغيل والإيقاف والاستئناف

- `إعادة التشغيل`: إعادة نشر (لخدمات المستودع) أو إعادة تشغيل المهام العاملة.
- `إيقاف`: إيقاف كل النسخ (التقليص إلى الصفر) من منطقة الخطر.
- `استئناف`: إعادة خدمة موقوفة بعدد نسخها السابق.

> Note: خطافات النشر محدودة بـ 30 طلبًا في الدقيقة لكل IP، وتعيد 409 إذا لم يكن للخدمة مستودع متصل.

> Result: يمكنك النشر والرجوع إلى نسخة سابقة وتشغيل عمليات النشر من لوحة التحكّم أو من أي سكربت.

---

All docs: https://gheima.ma/ar/docs.md