حذف کانتنیر
دستور remove برای حذف تعریف کانتینر استفاده میشود. این دستور کانتینر را از سامانه پاک میکند و میتواند در صورت نیاز فایلسیستم و ولومهای مرتبط را نیز حذف کند. اگر کانتینر در حال اجرا باشد، میتوانید با استفاده از گزینه --force آن را اجباری حذف کنید.
همچنین درصورتی که میخواهید چند کانتینر را با هم حذف کنید میتوانید با --regex آن ها را حذف کنید.
🧩 دستور کلی
k3 container remove [options] <containerId>
containerId: شناسه کانتینری که میخواهید حذف شود.
⚙️ گزینهها (Options)
| گزینه کوتاه | گزینه بلند | توضیح |
|---|---|---|
-f | --force | حذف اجباری حتی اگر کانتینر در حال اجرا باشد. پیشفرض: غیرفعال |
-v | --volume | حذف ولومهای متصل به کانتینر. پیشفرض: غیرفعال (درحال توسعه) |
-d | --deleteFileSystem | حذف فایلسیستم کانتینر. پیشفرض: فعال |
-r | --regex | حذف چند کانتینر با هم در صورتی که شامل آن کلمه باشد. |
-h | --help | نمایش راهنمای کامل دستور |
📥 مثالهای کاربردی
✅ حذف یک کانتینر معمولی:
k3 container remove 08a79d22
در این حالت:
- اگر کانتینر متوقف شده باشد، حذف انجام میشود.
- فایلسیستم کانتینر حذف میشود.
- ولومها باقی میمانند.
✅ حذف اجباری یک کانتینر در حال اجرا:
k3 container remove --force 08a79d22
این گزینه باعث میشود حتی اگر کانتینر فعال باشد، فوراً حذف شود.
✅ حذف کانتینر همراه با ولومهای متصل:
k3 container remove --volume 08a79d22
ولومهای مربوط به کانتینر نیز پاک میشوند.
✅ حذف کانتینر بدون پاک کردن فایلسیستم:
k3 container remove --deleteFileSystem false 08a79d22
فقط تعریف کانتینر حذف میشود ولی فایلسیستم آن باقی میماند.
✅ حذف کامل: اجباری + ولومها + فایلسیستم (درحال توسعه)
k3 container remove --force --volume 08a79d22
کانتینر به صورت کامل و بدون باقیماندن هیچ اثری حذف میشود.
نکات مهم
- پیشفرض:
فایلسیستم کانتینر حذف میشود.
ولومها حفظ میشوند مگر اینکه گزینه --volume فعال شود.(در حال توسعه)
اگر کانتینر در حال اجرا باشد، باید از گزینه --force استفاده کنید.
اگر میخواهید فقط تعریف کانتینر را بدون حذف فایلسیستم آن پاک کنید، گزینه --deleteFileSystem false را اضافه کنید.
تست جامع
#!/bin/bash
echo "Starting k3 container remove tests..."
echo "[1] Removing a normal stopped container (08a79d22)"
sudo k3 container remove 08a79d22
echo
echo "[2] Removing a running container forcibly (--force)"
sudo k3 container remove --force 08a79d22
echo
echo "[3] Removing container with volume cleanup (--volume)"
sudo k3 container remove --volume 08a79d22
echo
echo "[4] Removing container without deleting filesystem"
sudo k3 container remove --deleteFileSystem false 08a79d22
echo
echo "[5] Removing fully: --force + --volume"
sudo k3 container remove --force --volume 08a79d22
echo
echo "[6] Removing multiple containers by pattern (--regex)"
sudo k3 container remove --regex test
echo
echo "All remove tests completed."
🆘 دریافت راهنما
برای مشاهدهی راهنمای کامل این دستور در خط فرمان:
k3 container list -h