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

منع امتلاء القرص عبر تدوير سجلات Docker

قد يملأ حاوي كثير المخرجات قرص المضيف من دون زيادة بيانات التطبيق.

منع امتلاء القرص عبر تدوير سجلات Docker

السبب الشائع سجلات json-file بلا تدوير. حدّد الحمل المسؤول واضبط ميزانية للسجل؛ حذف Volume أو اقتطاع ملف تديره Docker ليس الخطوة الأولى للإصلاح.

النطاق والمتطلبات

حدّد هل تدير Compose أو Swarm أو جهة أخرى الحمل. المثال يستخدم Compose. تحقق من توافق driver مع جامع السجلات المركزي. حافظ على اسم الخدمة والصورة والمنافذ وVolumes؛ أضف قسم logging إلى التعريف الحالي ولا تستبدل الخدمة.

١. اجمع الأدلة

افصل استهلاك الصور وVolumes عن السجلات باستخدام docker system df. اقرأ LogPath وLogConfig وقِس نظام ملفات المضيف. قد يختلف data root عن /var/lib/docker. قارن نمو السجلات بفترة الاحتفاظ المطلوبة قبل اختيار الحجم والعدد.

docker system df
docker inspect --format "{{.LogPath}} {{json .HostConfig.LogConfig}}" web
df -h

٢. نفّذ تغييراً مضبوطاً

يدوّر driver من نوع local السجلات افتراضياً. يختار المثال ثلاثة ملفات بحد 10m لكل منها مع وجود كلفة إضافية فعلية. تغييرات daemon الافتراضية تؤثر في الحاويات الجديدة. تحتاج الحالية إلى إعادة إنشاء مخططة؛ restart وحده لا يغيّر إعداد logging.

# Merge into the existing compose service; keep other fields.
services:
  web:
    logging:
      driver: local
      options:
        max-size: "10m"
        max-file: "3"

٣. تحقّق من النتيجة

قبل إعادة الإنشاء تحقق من البيانات الدائمة وجهوزية النسخ. افحص Compose ثم إعداد driver الفعلي والسجلات الحديثة وصحة التطبيق ومعدل نمو القرص. يعمل docker logs مع local، أما الاحتفاظ الطويل فيحتاج وجهة مُدارة مستقلة.

docker compose config -q
# Planned recreation may interrupt a single-instance service.
docker compose up -d --no-deps --force-recreate web
docker logs --tail 50 web
docker inspect --format "{{json .HostConfig.LogConfig}}" web

التراجع والوقاية

للتراجع استعد قسم logging وأعد إنشاء الخدمة المتأثرة فقط. تجنب compose down -v وتنظيف Volumes لأنهما قد يحذفان بيانات مهمة. أصلح كثرة المخرجات؛ التدوير يحد الأثر لكنه لا يعالج حلقة retry أو سيل debug.

لفحص الجوانب المرتبطة بهذا المسار، راجع سجلات journald الدائمة والاحتفاظ الآمن في Linux وHealthcheck في Docker: التشغيل لا يعني الصحة.

المراجع التقنية