مولد crontab ومنشئ تعبير cron

ما تعبير cron؟

# Linux crontab entry — runs every 15 minutes
*/15 * * * *  /usr/local/bin/poll-api.sh

# Kubernetes CronJob — weekdays at 9:00 AM UTC
apiVersion: batch/v1
kind: CronJob
metadata:
  name: daily-report
spec:
  schedule: "0 9 * * 1-5"
  timeZone: "UTC"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: report
              image: report-runner:1.0
          restartPolicy: OnFailure

# GitHub Actions workflow — hourly
on:
  schedule:
    - cron: '0 * * * *'

# AWS EventBridge — first of each month
ScheduleExpression: cron(0 0 1 * ? *)
# (Note: AWS uses the Quartz 6-field form with '?' for day-of-week)

الميزات الرئيسية

متغيرات cron والمُجدولات

أمثلة على تعبيرات cron

*/15 * * * *

0 9 * * 1-5

0 0 1 * *

*/5 9-17 * * 1-5

0 0 1 JAN,APR,JUL,OCT *

0 0 1 * 5

30 2 * * *

@daily

كيف تبني تعبير cron

1. 1

   اكتب أو الصق تعبير cron

   أدخل تعبير cron بخمسة حقول في حقل الإدخال أعلاه (مثلاً `*/15 * * * *`). تحلل الأداة وتتحقق أثناء كتابتك — علامة خضراء للصالح، وخطأ أحمر مع اسم الحقل لغير الصالح. الماكروات مثل `@daily` و`@hourly` ونحوها مقبولة أيضاً.

2. 2

   أو اضبط حقول الإدخال الخمسة

   لا تحفظ ترتيب الحقول — حرّر الدقيقة أو الساعة أو يوم الشهر أو الشهر أو يوم الأسبوع منفرداً عبر الحقول المعنونة. التعبير الكامل في الأعلى يتحدث تلقائياً. استخدم `*` للرموز العامة، و`*/N` للخطوات، و`a-b` للنطاقات، و`1,3,5` للقوائم.

3. 3

   اختر قالباً للانطلاق السريع

   اضغط أي شريحة قالب (كل 15 دقيقة، أيام الأسبوع في 9 صباحاً، إلخ) لتحميل جدول شائع، ثم اضبط الحقول لتلائم حاجتك الدقيقة. تغطي إحدى عشرة قالباً الأنماط التي ستستخدمها فعلاً في الإنتاج.

4. 4

   تحقق من معاينة التشغيل التالي

   انظر إلى المواعيد الخمسة القادمة — بدّل بين المحلي وUTC للتأكد من أن الجدول ينطلق حيث تنوي. هذه أكثر طريقة موثوقية لاكتشاف مأزق «أو» بين يوم الشهر ويوم الأسبوع في POSIX قبل أن يلدغك في الإنتاج.

5. 5

   انسخ والصق إلى مُجدولك

   انقر «نسخ» لأخذ التعبير. الصقه في crontab الخاص بك أو مؤقت systemd أو cron: في GitHub Actions أو AWS EventBridge أو schedule في Kubernetes CronJob أو أي مُجدول متوافق مع cron. لا تنسَ التحقق من المنطقة الزمنية للمُجدول المستهدف — انظر قسم أفضل الممارسات أدناه.

أخطاء cron الشائعة

# المقصود: «أول جمعة من الشهر»
0 0 1-7 * 5
# فعلياً: ينطلق في الأيام 1-7 من الشهر أو في كل جمعة — كلا الشرطين

# استخدم غلافاً لدلالة «و» الحقيقية
0 0 * * 5  [ $(date +\%d) -le 7 ] && /your-script
# أو اطرح أحد الشرطين واقبل الجدول الأوسع

# كتبه مطور بتوقيت شرق الولايات المتحدة، ونُشر على خادم UTC
0 9 * * *  /your-report.sh
# ينطلق في 9 صباحاً UTC = 4 صباحاً بتوقيت الشرق — لم يكن هذا قصد المطور

# ثبّت المنطقة، أو اكتب بـ UTC صراحة
CRON_TZ=America/New_York
0 9 * * *  /your-report.sh

# المقصود: كل 15 دقيقة
15 * * * *
# فعلياً: مرة في الساعة، عند الدقيقة 15 (4 تشغيلات/ساعة أقل من المقصود)

# الصحيح
*/15 * * * *
# كل 15 دقيقة: الدقيقة 0 و15 و30 و45 من كل ساعة

# Quartz بستة حقول نُسخ إلى crontab على Linux
0 0 9 * * 1-5
# يقرأ Linux: الدقيقة=0، الساعة=0، يوم الشهر=9، الشهر=*، يوم الأسبوع=1-5
# = منتصف الليل في اليوم 9 من أشهر تطابق أيام الأسبوع — فوضى

# POSIX بخمسة حقول، اطرح الثواني
0 9 * * 1-5
# = أيام الأسبوع في 9:00 صباحاً

# 30 أو 31 فبراير — لا يعمل أبداً
0 0 30 2 *
0 0 31 2 *
# يُحلَّل لكن لا ينطلق أي جدول

# استخدم نمط 'آخر يوم عمل من فبراير' عبر سكربت
0 0 28-29 2 *  [ $(date -d tomorrow +\%m) = 03 ] && /your-script

# Quartz: 'آخر جمعة من الشهر' — غير صالح في POSIX
0 0 ? * 6L *

# نهج سكربت غلاف POSIX لآخر جمعة
0 0 25-31 * 5  /your-script
# يعمل يوم الجمعة بين 25-31 من أي شهر

حالات استخدام شائعة

مهام crontab على Linux

أنشئ مدخلات وتحقق منها لـ`/etc/crontab` أو `/etc/cron.d/*` أو ملفات `crontab -e` لكل مستخدم. استخدم معاينة التشغيل التالي للتأكد من أن الجدول يقع في الوقت الصحيح ضمن المنطقة الزمنية المُعدّة لخادمك قبل الحفظ.

جداول Kubernetes CronJob

أنشئ حقل `spec.schedule` لـKubernetes CronJob. يدعم Kubernetes 1.27+ أيضاً `spec.timeZone` — استخدم مفتاح UTC لتصميم جدولك بـUTC، ثم اضبط `timeZone` صراحة لتجنب الوقت المحلي لعقدة العامل.

سير عمل مجدول في GitHub Actions

أنشئ مدخل `cron:` تحت `on.schedule`. يعمل GitHub Actions دوماً بـUTC — بدّل المعاينة إلى UTC للتأكد من جدولك. تجنّب الفترات الأقصر من 15 دقيقة؛ يتخطى مُجدول GitHub المهام قصيرة الفاصل تحت الحِمل.

قواعد AWS EventBridge

أنشئ تعبير cron لقاعدة مجدولة في EventBridge. ملاحظة: يستخدم AWS صيغة Quartz بستة حقول مع `?` ليوم الأسبوع — تُصدر هذه الأداة POSIX بخمسة حقول، فستحتاج إلى التحويل ببَدء الثواني (`0`) واستبدال `*` في أحد حقلي اليوم بـ`?`.

أنابيب CI مجدولة في GitLab

تحقق من تعبير cron لأنبوب CI مجدول في GitLab. يستخدم GitLab صيغة POSIX بخمسة حقول — وهو ما تُصدره هذه الأداة — ومنتقي تاريخ في الواجهة، لكن صيغة cron تعطيك تحكماً أدق للفترات غير القياسية.

Cloudflare Workers Cron Triggers

أنشئ مدخل `[triggers.crons]` في `wrangler.toml`. يستخدم Cloudflare صيغة POSIX بخمسة حقول. أصغر فاصل دقيقة واحدة؛ ويعمل العامل بـUTC. استخدم المعاينة للتأكد من أن المُطلِق ينطلق ضمن نافذتك المتوقعة.

جداول node-cron في Node.js

أنشئ تعبيرات لمكتبة node-cron، التي تدعم POSIX بخمسة حقول وأيضاً حقل ثواني اختياري في المقدمة. التزم بخمسة حقول إلا إذا احتجت دقة تحت الدقيقة تحديداً — تعبيرات الحقول الستة لا تُنقَل إلى crontab على Linux.

مراجعة الكود والتوثيق

الصق تعبير cron من طلب سحب أو دليل تشغيل لتفهم ما يفعله فوراً — لا مزيد من التخمين في `30 7 * * 1-5` ولا إخراج بطاقة مرجع. الوصف بلغة طبيعية رائع أيضاً للتعليقات داخل الكود وملفات README.

مرجع صيغة cron

ترتيب الحقول: M H D M W

الدقيقة (0-59)، الساعة (0-23)، يوم الشهر (1-31)، الشهر (1-12)، يوم الأسبوع (0-6، 7 أيضاً = الأحد). ذكرى: «My Hat Doesn't Match Wendy's». يقبل حقل يوم الأسبوع كلاً من الرموز الرقمية (0-6) والمسماة (SUN-SAT، غير حساس لحالة الأحرف).

العوامل

`*` = أي قيمة؛ `,` = فاصل قائمة (`1,3,5`)؛ `-` = نطاق (`1-5`)؛ `/` = خطوة (`*/15`، `5/10`)؛ الأسماء: JAN-DEC للشهر، وSUN-SAT ليوم الأسبوع (غير حساسة لحالة الأحرف).

الماكروات (الاختصارات)

`@yearly` = `0 0 1 1 *`؛ `@annually` = `0 0 1 1 *`؛ `@monthly` = `0 0 1 * *`؛ `@weekly` = `0 0 * * 0`؛ `@daily` = `0 0 * * *`؛ `@midnight` = `0 0 * * *`؛ `@hourly` = `0 * * * *`. أما `@reboot` فهو حالة خاصة غير زمنية (يعمل عند الإقلاع فقط) ويُرفَض بخطأ توضيحي.

دلالة يوم POSIX (قاعدة «أو»)

حين يكون كلٌّ من يوم الشهر ويوم الأسبوع مقيَّداً (لا أحد منهما `*`)، يعمل الجدول حين يطابق أيُّهما — دلالة «أو». حين يُقيَّد أحدهما فقط، يقرر ذلك الواحد. وحين يكون كلاهما `*`، يطابق كل يوم. تنطبق هذه القاعدة على vixie cron وBSD cron ومعظم تطبيقات POSIX؛ ويستخدم Quartz `?` للتمييز بين «و» و«أو».

وضع الحقول الستة (Quartz-Lite)

إذا احتوى إدخالك على ستة رموز مفصولة بمسافة، تعامل الأداة الأول كحقل ثواني (0-59). مفيد لـQuartz وSpring `@Scheduled(cron=...)` وnode-cron. غير قابل للنقل إلى crontab على Linux أو مُجدولات POSIX — ستعامل ثوانيك دقائق وتُزيح كل شيء بموضع واحد.

تثبيت عامل الخطوة

`*/N` مرتبط بأدنى قيمة في الحقل: `*/15` في الدقيقة = `0,15,30,45`، لا «كل 15 بدءاً من الآن». بقاعدة غير رمز عام: `5/15` في الدقيقة = `5,20,35,50`. قيم الخطوة التي لا تقسم نطاق الحقل بالتساوي ستتخطى قرب الالتفاف — هذا صحيح، لا خلل.

حدود التحقق

الدقيقة ∈ [0,59]، الساعة ∈ [0,23]، يوم الشهر ∈ [1,31]، الشهر ∈ [1,12]، يوم الأسبوع ∈ [0,7]. القيم خارج النطاق تنتج خطأً على مستوى الحقل. لا يُتحقَّق من يوم الشهر مقابل الشهر (`0 0 31 2 *` يُحلَّل بشكل جيد لكنه لا يطابق أبداً لأن فبراير لا يوم 31 له — ستعرض معاينة التشغيل التالي «لا توجد عمليات تشغيل قادمة»).

رفض عوامل Quartz

لا يدعم POSIX cron عوامل Quartz: `?` (بلا قيمة محددة)، و`L` (الأخير)، و`W` (أقرب يوم عمل)، و`#` (اليوم النوني). ترفضها هذه الأداة برسالة واضحة «Quartz operators not supported» بدلاً من تحليلها صامتاً كـPOSIX غير صالح. لجداول Quartz، استخدم أداة واعية بـQuartz أو مُجدول Spring بدلاً منها.

سقف سنوات البحث عن التشغيل التالي

يبحث حساب التشغيل التالي حتى 4 سنوات قُدماً؛ التعبيرات التي تطابق بأقل من ذلك (مثل أنماط «29 فبراير») ستعرض «لا توجد عمليات تشغيل قادمة خلال 4 سنوات». هذا مقصود لتجنب التكرار اللامحدود على أنماط مستحيلة.

أفضل الممارسات لجداول cron

استخدم UTC على الخوادم، وحوّل عند العرض

اضبط خوادمك على UTC (`/etc/timezone` أو `TZ=UTC`) واكتب كل تعبيرات cron بـUTC. حوّل إلى الوقت المحلي وقت العرض فقط في لوحاتك وتقاريرك. هذا يلغي صنفاً كاملاً من أخطاء المناطق الزمنية التي تضرب بأقسى صورها أثناء انتقالات التوقيت الصيفي، حين تتضاعف جداول الوقت المحلي صامتةً أو تتخطى تشغيلاً. استخدم مفتاح UTC في هذه الأداة لتصميم جدولك بـUTC من البداية.

تجنّب فخ «أو» بين يوم الشهر ويوم الأسبوع في POSIX

لا تُقيّد كلاً من يوم الشهر ويوم الأسبوع إلا إذا أردت دلالة «أو». إذا أردت «كل إثنين في يناير»، فاكتب `0 0 * 1 1` (يوم الشهر `*`)؛ وإذا أردت «الأول من كل شهر»، فاكتب `0 0 1 * *` (يوم الأسبوع `*`). قاعدة «أو» في POSIX تعني أن `0 0 1 * 1` يعمل في الأول وأيضاً في كل إثنين — تقريباً ليس ما قصدته. ستلتقط معاينة التشغيل التالي ذلك إن تحققت قبل النشر.

ثبّت منطقة الجدول الزمنية صراحة

تدعم المُجدولات الحديثة تثبيت المنطقة الزمنية في تعريف الجدول: `CRON_TZ=America/New_York` أعلى crontab (vixie cron 3.0+)، و`spec.timeZone: "America/New_York"` لـKubernetes CronJobs 1.27+، وتعبير جدول بـ`ScheduleExpressionTimezone` لـAWS EventBridge Scheduler. ثبّت المنطقة صراحة بدل الاعتماد على افتراضي الخادم — يمكن أن تتغير مناطق الخوادم دون إنذار خلال نقل البنية التحتية.

وزّع الحِمل عبر الدقائق، لا عند :00

تجنّب `0 * * * *` (كل ساعة عند الدقيقة 0) للمهام غير الحرجة — على مستوى التوسع، تكدّس جدولة الأشياء عند :00 بالضبط يخلق طفرات حِمل. اختر إزاحة دقيقة عشوائية (`23 * * * *`، `41 * * * *`) لكل مهمة لتوزيع الحِمل. ينطبق ذلك على المهام اليومية: `30 3 * * *` أرفق بقاعدة بياناتك من `0 3 * * *` حين تتجمع مهام كثيرة عند 3:00.

اجعل المهام لا تتأثر بالتكرار

لا يوجد في cron إعادة محاولة مدمجة ولا منع تداخل ولا تعافٍ من التشغيلات الفائتة. يجب أن تكون مهمتك آمنة لتُشغَّل مرات عدة (لا تتأثر بالتكرار) وفاحصة لذاتها. بدلاً من «أرسل التقرير في 9 صباحاً»، صمّمها كـ«أرسل تقرير اليوم إن لم يُرسَل بعد» — هذا يداوي نفسه بعد التوقف، ومضاعفة الجدولة العرضية، والتشغيلات المتزامنة. عدم التأثر بالتكرار خاصية المهمة لا المُجدول، وهو الممارسة الأهم للموثوقية.

أضف نبضاً للجداول الحرجة

وضع الإخفاق الصامت في cron أكبر ضعفه — إذا لم ينطلق الجدول، لا شيء يخبرك. للمهام الحرجة، اجعل المهمة تستدعي خدمة نبض (Healthchecks.io، Cronitor، Dead Man's Snitch) في نهاية كل تشغيل؛ تنبهك الخدمة إذا لم يصل النبض المتوقع. يلتقط ذلك إخفاق المهمة وإخفاق الجدول نفسه. الطبقة المجانية تغطي معظم احتياجات الأفراد والفرق الصغيرة.

تحقق بمعاينة التشغيل التالي قبل الشحن

قبل نشر جدول cron جديد، انظر إلى المواعيد الخمسة القادمة في معاينة هذه الأداة. بدّل بين المحلي وUTC. تأكد من أن الجدول يقع حيث تنوي — لا قبل خمس دقائق، ولا في يوم خاطئ، ولا متخطياً عطلة نهاية الأسبوع التي اهتممت بها. المعاينة هي أرخص اختبار إنتاجي ممكن.

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