Lorixen.
AR

مهمة cron تعمل يدوياً وتفشل في موعدها: البيئة والنسبة المئوية

باختصار: إذا كتب المطور مهمة مجدولة على الخادم، كنسخ احتياطي ليلي أو إرسال تقرير الطلبات صباحاً أو تحديث أسعار الصرف، وكانت تعمل تماماً عند تشغيلها يدوياً لكنها لا تعمل من cron، فالسبب غالباً أن cron يشغّلها في بيئة مختلفة عن جلستك. حسب دليل crontab، يضبط cron مجموعة صغيرة من المتغيرات فقط ويستخدم ‎/bin/sh افتراضياً. وهناك فخ آخر شائع: علامة النسبة المئوية في الأمر تتحول إلى سطر جديد ما لم تُسبق بشرطة مائلة عكسية، وهي موجودة في معظم أوامر تسمية ملفات النسخ بالتاريخ.

المشكلة التي تضيع ساعات

شركة توزيع في عمّان لديها سكربت يصدّر طلبات اليوم إلى ملف ويرسله إلى قسم المحاسبة كل صباح. المطور يجربه من سطر الأوامر فيعمل. يضيفه إلى cron ليعمل في السادسة صباحاً. في اليوم التالي لا يصل شيء، ولا رسالة خطأ في أي مكان. يجربه يدوياً مرة أخرى فيعمل. هذا النمط مألوف لكل من أدار خادماً، ويستهلك وقتاً لأن كل شيء «يعمل».

السر أن «يعمل يدوياً» و«يعمل من cron» ليسا الشيء نفسه. عندما تشغّل السكربت بنفسك، أنت تشغّله في بيئتك أنت، بكل ما ضبطته فيها عبر السنين، وcron لا يعرف شيئاً عن تلك البيئة، فيبدأ كل مهمة من الصفر تقريباً.

البيئة التي يشغّل فيها cron المهام

عندما تفتح جلسة على الخادم، تُحمّل إعدادات كثيرة: مسارات البرامج التي أضفتها، ونسخة PHP أو Python التي اخترتها، ومتغيرات خاصة بمشروعك. cron لا يحمّل هذه الإعدادات.

يقول دليل crontab إن عدة متغيرات بيئة يضبطها cron تلقائياً: SHELL يُضبط على ‎/bin/sh، وLOGNAME وHOME يُؤخذان من سطر مالك الجدول في ملف المستخدمين. ويمكن تغيير HOME وSHELL من داخل جدول المهام، أما LOGNAME فلا. ويتيح الدليل كتابة إعدادات بيئة في جدول المهام بالشكل «اسم = قيمة».

ما يعنيه ذلك عملياً:

  • الأوامر قد لا تُوجد: إذا كان السكربت يستدعي برنامجاً بالاسم فقط، وكان هذا البرنامج في مسار أضفته لجلستك، فقد لا يجده cron. استخدم المسارات الكاملة للبرامج في الأمر، أو اضبط متغير المسار في أول جدول المهام.
  • نسخة مختلفة من اللغة: إذا كان على الخادم أكثر من نسخة PHP، فقد يستخدم cron نسخة غير التي جربت بها. اكتب المسار الكامل لنسخة PHP التي تريدها.
  • المجلد الحالي مختلف: السكربت الذي يقرأ ملفاً بمسار نسبي يعمل عندما تكون في مجلد المشروع، ويفشل من cron. استخدم مسارات كاملة، أو انتقل إلى مجلد المشروع في بداية الأمر.
  • الصدفة مختلفة: الأمر يُنفّذ عبر ‎/bin/sh أو الصدفة المحددة في المتغير SHELL. بعض الصيغ التي تعمل في صدفتك اليومية قد لا تعمل فيها.

فخ علامة النسبة المئوية

يذكر دليل crontab أن الجزء الخاص بالأمر في السطر يُنفّذ حتى نهاية السطر أو حتى علامة «%». وأن علامة النسبة المئوية في الأمر، ما لم تُسبق بشرطة مائلة عكسية، تتحول إلى سطر جديد، وكل ما بعد أول علامة يُرسل إلى الأمر كمدخلات.

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

فخ اليوم والتاريخ

يوضح الدليل أيضاً أن يوم التنفيذ يمكن تحديده بحقلين: يوم الشهر ويوم الأسبوع. وإذا كان الحقلان كلاهما محددين، لا يحتويان النجمة، فإن الأمر يُنفّذ عندما يطابق أي منهما. أي أن مهمة كُتبت لتعمل «يوم 1 من الشهر إذا كان أحداً» ستعمل في كل يوم 1 وفي كل أحد. إذا احتجت شرطاً مركباً، فضعه داخل السكربت.

اعرف ماذا حدث: المخرجات

أكبر سبب لضياع الوقت أنك لا ترى ما حدث. يذكر الدليل المتغير MAILTO: إذا كان محدداً وغير فارغ، تُرسل مخرجات المهام إلى العنوان المحدد، وإذا كان فارغاً لا يُرسل شيء، وإلا تُرسل إلى مالك الجدول. على كثير من الخوادم لا يوجد نظام بريد مضبوط، فتضيع هذه الرسائل.

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

جرّب في بيئة cron نفسها

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

هل تعرف أن المهمة فشلت؟

المهمة التي تعمل كل ليلة قد تتوقف يوماً ما لسبب آخر: قرص ممتلئ، أو كلمة مرور تغيرت، أو خدمة خارجية تعطلت. اجعل المهام المهمة كالنسخ الاحتياطي تنبهك عند الفشل، أو اجعل الشخص المسؤول يراجع وصول التقرير اليومي. السكوت ليس دليلاً على النجاح.

المنطقة الزمنية للمهام

موعد «السادسة صباحاً» في جدول المهام يُحسب حسب المنطقة الزمنية التي يعمل بها الخادم، لا حسب توقيت عمّان بالضرورة. كثير من الخوادم السحابية تعمل افتراضياً بالتوقيت العالمي، فتعمل المهمة التي توقعتها في السادسة صباحاً قبل ذلك أو بعده بساعات. تحقق من المنطقة الزمنية للخادم قبل أن تكتب المواعيد، واكتبها في تعليق داخل جدول المهام بجانب كل مهمة: «06:00 بتوقيت الخادم». وإذا كان التقرير يعتمد على «طلبات اليوم»، فتأكد أن السكربت يحسب اليوم بالمنطقة الزمنية الصحيحة أيضاً، وإلا ستصل إلى المحاسبة طلبات يوم ناقص أو مكرر.

مثال توضيحي: شركة توزيع وتقرير الصباح

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

أسئلة شائعة

ليش السكربت بيشتغل يدوي وما بيشتغل من cron؟

لأن cron يشغّله في بيئة مختلفة: صدفة ‎/bin/sh ومتغيرات قليلة كما يذكر دليل crontab. استخدم مسارات كاملة للبرامج والملفات.

أمر النسخة بالتاريخ ما بيشتغل بـ cron، ليش؟

لأن علامة % في أمر cron تتحول إلى سطر جديد ما لم تُسبق بشرطة مائلة عكسية.

كيف بعرف ليش فشلت المهمة؟

وجّه مخرجات المهمة وأخطاءها إلى ملف سجل، وافتحه بعد موعدها.

كتبت يوم بالشهر ويوم بالأسبوع، ليش بتشتغل أكثر؟

لأنه إذا حُدد الحقلان معاً، تعمل المهمة عندما يطابق أي منهما.

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

المصادر

WhatsAppاحجز مكالمة