پرش به مطلب اصلی

توقف موقتی کانتینر

دستور pause برای فریز (freeze) کردن موقتی یک کانتینر در حال اجرا به کار می‌رود. این دستور، پردازش‌های داخل کانتینر را بدون پایان دادن به آن‌ها متوقف می‌کند، به طوری که بعداً بتوان با دستور resume ادامه داد.


🧩 دستور کلی

k3 container pause [options] <containerId>

آرگومان‌ها:

  • containerId: شناسه‌ی کانتینری که می‌خواهید موقتاً متوقف کنید

⚙️ گزینه‌ها (Options)

گزینه کوتاهگزینه بلندتوضیح
-t--time <seconds>مدت‌زمان (به ثانیه) که سیستم برای متوقف کردن کانتینر منتظر می‌ماند
-h--helpنمایش راهنمای کامل دستور

📥 مثال‌های کاربردی

✅ متوقف‌سازی موقتی کانتینر با شناسه:

k3 container pause cont5

⏱ متوقف‌سازی با زمان انتظار مشخص:

k3 container pause --time 5 cont5

⚠️ خطا در صورت اجرای دستور روی کانتینر غیر‌فعال:

اگر کانتینر در حال اجرا نباشد یا وجود نداشته باشد، اجرای دستور pause با خطا همراه خواهد شد. پیشنهاد می‌شود ابتدا با دستور زیر وضعیت آن را بررسی کنید:

k3 container list --status running

نکات مهم

  • این دستور فقط روی کانتینرهایی با وضعیت running عمل می‌کند.

  • پس از توقف موقتی، برای ادامه اجرای کانتینر از دستور k3 container resume استفاده کنید.

  • این قابلیت در سناریوهایی مثل دیباگ، مدیریت منابع، یا زمان‌بندی اجرای پردازش‌ها بسیار مفید است.

  • کانتینری که pause شده است، منابع سیستمی را هنوز اشغال می‌کند اما هیچ CPU مصرف نمی‌کند.


تست جامع

#!/bin/bash

echo "Starting k3 container pause tests..."

echo "[1] Pausing cont5 (basic container)"
sudo k3 container pause cont5
echo

echo "[2] Pausing cont5 with --time 5"
sudo k3 container pause --time 5 cont5
echo

echo "[3] Trying to pause nonexistentContainer (should fail)"
sudo k3 container pause nonexistentContainer
echo

echo "[4] Checking running containers"
sudo k3 container list --status running
echo

echo "[5] Checking paused containers"
sudo k3 container list --status paused
echo

echo "All pause tests completed."

🆘 دریافت راهنما

برای مشاهده‌ی راهنمای کامل این دستور در خط فرمان:

k3 container pause -h