# مهام كرون

> شغّل أوامر وفق جدول زمني، وأطلقها عند الطلب، وراجع سجلّ التشغيل.

Source: https://gheima.ma/ar/docs/cron-jobs

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

### أنشئ مهمة

1. **مهمة مجدولة جديدة** — في صفحة المهام المجدولة، انقر «مهمة مجدولة جديدة» وسمِّها.
2. **اضبط جدولًا** — اختر إعدادًا جاهزًا مثل «كل ساعة» أو «يوميًا»، أو اكتب تعبير cron مثل 0 * * * *. يبيّن وصف بلغة واضحة متى تعمل المهمة. تعمل الجداول بتوقيت UTC.
3. **اضبط الأمر** — أدخِل الأمر المراد تشغيله، مثل npm run task. يمكنك تشغيله بصورة خدمة وبيئتها، أو بالصورة الأساسية.

```
0 * * * *
```

تعمل عند بداية كل ساعة. تحدّد خطتك أدنى فاصل زمني مسموح.

### التشغيل الآن والسجلّ

- انقر «تشغيل الآن» لتشغيل مهمة فورًا.
- أوقِف مهمة مؤقتًا بمفتاحها دون حذفها.
- يعرض سجلّ التشغيل عمليات التشغيل الأخيرة بحالتها ومدتها ورمز خروجها وسجلاتها.

### خيارات الجدول وحدوده

- `أدنى فاصل`: تحدّد خطتك أصغر فجوة مسموحة بين عمليات التشغيل.
- `المنطقة الزمنية`: التوقيت الافتراضي UTC، ولوحة التحكّم تنشئ كل المهام بتوقيت UTC. اضبط timezone عبر API لتقييم الجدول بمنطقة زمنية أخرى.
- `المهلة`: يُوقَف التشغيل الذي يتجاوز مهلته. المهلة الافتراضية 300 ثانية، والحد الأقصى 3600. اضبط timeoutSeconds عبر API.
- `الهدف`: التشغيل بصورة خدمة وبيئتها، أو بالصورة الأساسية.

> Result: يعمل أمرك وفق الجدول، وعند الطلب حين تحتاج، مع سجلّ كامل لعمليات التشغيل السابقة.

---

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