كل المقالات التقنية

كتابة خدمة systemd لتطبيقكم: إعادة التشغيل والسجلات وإعدادات آمنة

أنشئوا خدمة systemd لتطبيق بمستخدم مخصص وسياسة إعادة تشغيل وملف متغيرات وسجلات وتقوية أساسية ثم تحققوا منها.

كتابة خدمة systemd لتطبيقكم: إعادة التشغيل والسجلات وإعدادات آمنة

تشغيل التطبيق من طرفية أو جلسة screen يتوقف بخروجكم أو بإعادة تشغيل الخادم. وخدمة systemd تحل ذلك: تشغّل التطبيق عند الإقلاع وتعيد تشغيله بعد الانهيار وتشغّله بمستخدم محدود وتوجّه مخرجاته إلى journal. يبني هذا الدليل ملف وحدة صغيراً وآمناً ويبين كيف تحمّلونه وتتحققون منه ويسرد الأخطاء التي تسبب “يعمل يدوياً ولا يعمل كخدمة”.

١. ملف وحدة أدنى

أنشئوا مستخدماً مخصصاً أولاً ثم ملف الوحدة في /etc/systemd/system/. يشغّل المثال أدناه تطبيق Node لكن البنية تصلح لأي برنامج:

# /etc/systemd/system/myapp.service
[Unit]
Description=My web app
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/opt/myapp
EnvironmentFile=/etc/myapp.env
ExecStart=/usr/bin/node /opt/myapp/server.js
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

استخدموا دائماً مساراً مطلقاً في ExecStart لأن systemd لا يستعمل PATH الخاص بصدفتكم. وأبقوا الأسرار في ملف المتغيرات بأذونات مقيّدة لا في الوحدة نفسها.

٢. التحميل والتحقق والتشغيل

بعد كل تعديل على ملف الوحدة أعيدوا تحميل systemd ليقرأ الملفات من جديد. ثم تحققوا من الصياغة قبل التشغيل:

sudo systemctl daemon-reload
sudo systemd-analyze verify /etc/systemd/system/myapp.service
sudo systemctl enable --now myapp
systemctl status myapp --no-pager

يشغّل enable --now الخدمة فوراً وعند كل إقلاع.

٣. قراءة السجلات والحالة

يجمع journal المخرجات القياسية والأخطاء فلا تحتاجون ملف سجل خاصاً في الحالات البسيطة:

journalctl -u myapp -n 50 --no-pager
journalctl -u myapp -f
systemctl show myapp -p ExecMainStatus -p NRestarts
sudo systemctl cat myapp

يساعد عداد إعادة التشغيل على ملاحظة حلقة انهيار قد تبدو خدمة سليمة.

٤. سياسة إعادة التشغيل والاعتماديات

يعيد Restart=on-failure التشغيل بعد الانهيار لا بعد الإيقاف العادي. أضيفوا RestartSec حتى لا يطرق تطبيق معطوب المعالج. واستخدموا After= وWants= للاعتماديات الحقيقية كالشبكة أو قاعدة البيانات. وإن كان تطبيقكم ينتظر قاعدة بيانات فليعد المحاولة بنفسه ولا يعتمد على ترتيب البدء وحده. ولجدولة المهام بدل الخدمات الدائمة راجعوا دليل مؤقتات systemd.

٥. أخطاء شائعة

الأخطاء المعتادة أدناه، وإصلاحها يحل معظم الإخفاقات التي تظهر تحت systemd فقط:

ExecStart=node server.js      # relative path, may not be found
User=root                    # runs everything as root
Restart=always               # hides a crash loop without RestartSec

وافحصوا أيضاً مجلد العمل وملكية الملفات وقدرة المستخدم على قراءة ملفات التطبيق. والمتغيرات التي ضبطتموها في صدفتكم غير موجودة في الخدمة.

٦. مثال توضيحي وليس قياساً حقيقياً

افترضوا تطبيقاً (مختلقاً) يعمل بـ node server.js في الطرفية ويفشل كخدمة. يظهر journal العبارة “node: command not found” لأن الوحدة استخدمت أمراً نسبياً. تغييره إلى المسار المطلق مع daemon-reload يحلها. وحلقة إعادة التشغيل الثانية تبين أنها ملف متغيرات مفقود ظهر في مخرجات status.

٧. أخطاء شائعة

  • نسيان daemon-reload بعد تعديل الوحدة.
  • مسارات نسبية في ExecStart.
  • تشغيل الخدمة بـ root دون حاجة.
  • وضع الأسرار مباشرة في ملف الوحدة.
  • Restart=always دون RestartSec.
  • افتراض وجود متغيرات الصدفة.

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

أين أضع ملف وحدتي؟ في /etc/systemd/system/. وتستخدم الحزم /usr/lib/systemd/system/.

كيف أعرف سبب الفشل؟ شغّلوا systemctl status وjournalctl -u مع اسم الوحدة.

ما الفرق بين enable وstart؟ start يشغّلها الآن وenable يفعّلها عند الإقلاع وenable –now يفعل الاثنين.

هل أعدّل وحدة حزمة بأمان؟ استخدموا systemctl edit لإنشاء drop-in بدل تعديل الأصل.

٩. قائمة تحقق سريعة

  1. أنشئوا مستخدماً مخصصاً.
  2. اكتبوا الوحدة بمسارات مطلقة.
  3. شغّلوا daemon-reload.
  4. شغّلوا systemd-analyze verify.
  5. فعّلوا الخدمة وشغّلوها.
  6. افحصوا status وjournal.
  7. اختبروا إعادة تشغيل أو انهياراً متعمداً.

إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.

تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

systemd.service manual · systemd.unit manual · systemd-analyze manual · journalctl manual