Cron كخدمةCron كخدمة
جدول المهام بتعبيرات 5 حقول قياسية أو اختصارات @daily. أدر الإدخالات عبر REST، فعّل/علّق بدون SSH، وعيّن انتهاء صلاحية تلقائي.
# Create a cron job that runs daily at 9 AM
hoody cron create root \
--schedule "0 9 * * *" \
--command "/usr/local/bin/backup.sh" \
--comment "نسخ احتياطي يومي الساعة 9 صباحاً"
# Response
[
"id": "7d3f2a1b-8c4e-4f9a-b2d5",
"schedule_human": "At 09:00",
"enabled": true
]
# Disable a job temporarily
hoody cron update root $ENTRY_ID --enabled false
# Entry disabled
كل نمط ستحتاجه
ثمانية تعبيرات مع مكافئاتها المقروءة — مباشرة من حقل schedule_human في API.
نظرة سريعة على الجدول
أربعة إدخالات مُدارة على محور متدحرج — الإطلاقات القادمة باللون الأزرق، الإدخالات المعطّلة خافتة.
daily-backup
عند الساعة 02:00
health-check
كل 15 دقيقة
log-rotate
عند 00:00 يوم الأحد
sync-reports
عند 09:00 من الإثنين إلى الجمعة
مُدار أو خام — اخترك
إدخالات مع UUID وتبديل وانتهاء صلاحية عبر JSON API، أو وصول مباشر لملف crontab عندما تحتاج سيطرة كاملة.
الإدخالات المُدارة
5 نقاط نهايةCRUD مدعوم بـ UUID — أنشئ واقرأ وحدّث واحذف مهام cron عبر JSON. أضف تعليقات، فعّل/عطّل، وعيّن انتهاء صلاحية تلقائياً.
# Create a managed entry
POST /users/[user]/entries
[
"schedule": "0 9 * * *",
"command": "/usr/local/bin/backup.sh",
"comment": "نسخ احتياطي يومي",
"enabled": true,
"expires_at": null
Crontab الخام
3 نقاط نهايةوصول كامل للقراءة/الكتابة إلى ملف crontab لكل مستخدم نظام. استخدمه عندما تحتاج تحكماً كاملاً أو تهجير إدخالات موجودة.
# Read the raw crontab
GET /users/[user]/crontab
# Replace entire crontab
PUT /users/[user]/crontab
["crontab": "0 5 * * * /usr/local/bin/backup.sh"]
تعبيرات Cron الشائعة
انسخ والصق هذه الجداول الموثقة — كل منها مُتحقق مقابل مرجع التعبيرات أعلاه.
* * * * *
كل دقيقة
إطلاق عند كل دقيقة. مثالي لمهام الاستطلاع المستمر وجمع المقاييس وعمليات مراقبة السلامة.
0 * * * *
كل ساعة
إطلاق في أعلى كل ساعة. مناسب للملخصات الساعية وتسخين ذاكرة التخزين المؤقت والمزامنة المجدولة مع API.
0 9 * * 1-5
أيام العمل الساعة 9 صباحاً
إطلاق عند 09:00 من الإثنين إلى الجمعة فقط. مناسب لمهام ساعات العمل كإرسال الملخصات اليومية أو توليد التقارير.
0 0 1 * *
أول الشهر
إطلاق مرة واحدة شهرياً عند منتصف ليلة اليوم الأول. مثالي للملخصات الشهرية ودورات الفواتير والأرشفة.
*/5 * * * *
كل 5 دقائق
إطلاق كل 5 دقائق. مفيد لفحوصات الصحة وتفريغ الطوابير والمزامنة شبه الفورية للبيانات.
@daily
الاختصار اليومي
مكافئ لـ 0 0 * * * — منتصف الليل كل يوم. الطريقة الأوضح للتعبير عن جدول مرة يومياً.
9 نقاط نهاية. وضعان.
خمس نقاط نهاية CRUD للإدخالات المُدارة، وثلاث لـ crontab الخام، وفحص صحة واحد — كل ذلك مقيّد لكل حاوية.
الإدخالات المُدارة
5 نقاط نهايةGET /users/root/entries → [[id, schedule_human, enabled]]
Crontab الخام
3 نقاط نهايةPUT /users/root/crontab → [crontab, user]
النظام
نقطة نهاية واحدةGET /health → [status: ok]
جدول أول مهمة لك
طلب POST واحد. إدخال cron واحد. صفر SSH. Hoody Cron يعمل داخل حاويتك الآن.