همه مقالات تخصصی

سیاست restart و محدودیت منابع در Docker: unless-stopped، memory و cpus

سیاست restart مناسب را انتخاب کنید، حافظه و CPU کانتینر را محدود کنید و OOMKilled و کد 137 را بخوانید تا یک کانتینر کل سرور را زمین نزند.

سیاست restart و محدودیت منابع در Docker: unless-stopped، memory و cpus

کانتینر بدون محدودیت می‌تواند تمام حافظهٔ سرور را بخورد، و کانتینر بدون سیاست restart بعد از ریبوت یا کرش برنمی‌گردد. این راهنما دو تنظیم ساده را با روش تأیید نشان می‌دهد.

۱. سیاست‌های restart

  • no: هرگز خودکار راه‌اندازی نمی‌شود (پیش‌فرض).
  • on-failure[:N]: فقط با کد خروج غیرصفر و حداکثر N بار.
  • always: همیشه، حتی اگر دستی متوقف شده باشد، پس از ری‌استارت daemon.
  • unless-stopped: مثل always، ولی کانتینری که دستی متوقف کرده‌اید برنمی‌گردد.

برای سرویس‌های دائمی معمولاً unless-stopped انتخاب خوبی است.

۲. اجرا با محدودیت

docker run -d --name app --restart unless-stopped \
  --memory 512m --memory-swap 512m --cpus 1.0 myimage:1.0

--memory سقف حافظه و --cpus سقف CPU است. با برابر گذاشتن memory-swap با memory، کانتینر از swap سرور استفاده نمی‌کند. اعداد را از مصرف واقعی برنامه به‌دست آورید.

۳. تغییر کانتینر در حال اجرا

docker update --restart unless-stopped --memory 512m --memory-swap 512m app
docker inspect -f '{{.HostConfig.RestartPolicy.Name}}' app

docker update برای کانتینر موجود کار می‌کند. در Compose، کلیدهای restart: unless-stopped، mem_limit و cpus یا بخش deploy.resources متناسب با نسخهٔ Compose شما قابل‌استفاده‌اند.

۴. تشخیص OOM

docker inspect -f '{{.State.OOMKilled}} {{.State.ExitCode}}' app
docker stats --no-stream

مقدار true برای OOMKilled و کد خروج 137 یعنی کانتینر به‌خاطر سقف حافظه کشته شده. در این حالت سقف را بدون فهمیدن علت بالا نبرید؛ نشتی حافظهٔ برنامه ممکن است باشد. برای مفهوم OOM در خود سرور حافظه، swap و OOM را ببینید.

۵. نکات تکمیلی

سیاست restart جای healthcheck را نمی‌گیرد: کانتینر ممکن است بالا باشد ولی خراب. و restart بی‌پایان روی خطای دائمی فقط لاگ را پر می‌کند؛ on-failure با سقف تعداد مناسب‌تر است. برای نظافت دیسک، پاک‌سازی امن Docker را ببینید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید یک کانتینر پردازش هر چند ساعت به حافظهٔ زیادی می‌رسید و OOM killer سرور سرویس دیگری را می‌کشت. با سقف memory برای همان کانتینر، فقط خودش ری‌استارت شد و بقیهٔ سرویس‌ها مصون ماندند. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • استفاده از always وقتی می‌خواهید توقف دستی احترام گذاشته شود.
  • نداشتن سقف حافظه برای کانتینرهای پرمصرف.
  • بالا بردن سقف به جای پیداکردن نشتی.
  • تصور اینکه restart سلامت برنامه را تضمین می‌کند.

۸. پرسش‌های متداول

always یا unless-stopped؟ برای بیشتر سرویس‌ها unless-stopped.

کد 137 یعنی چه؟ کانتینر با SIGKILL (غالباً OOM) کشته شده.

memory-swap چه می‌کند؟ مجموع حافظه و swap مجاز را تعیین می‌کند.

۹. چک‌لیست سریع

  1. سیاست restart انتخاب شد.
  2. memory و cpus با مصرف واقعی تنظیم شد.
  3. OOMKilled بررسی شد.
  4. docker stats دیده شد.
  5. healthcheck جدا در نظر گرفته شد.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

Docker docs: start containers automatically · Docker docs: resource constraints