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

حذف حجم

دستور remove برای حذف یک Volume خاص از سیستم استفاده می‌شود. این دستور زمانی کاربرد دارد که دیگر به آن Volume نیاز نداشته باشید.

🧩 دستور کلی​

k3 volume remove [options] <volumeName>
  • volumeName: نام حجمی که قصد حذف آن را دارید.

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

گزینه کوتاهگزینه بلندتوضیح
-f--forceدر حال توسعه – اجبار به حذف حتی اگر Volume در حال استفاده باشد
-h--helpنمایش راهنمای کامل دستور

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

✅ حذف ساده یک Volume:​

k3 volume remove myDataVolume

✅ حذف اجباری (در حال توسعه):​

k3 volume remove -f myDataVolume

💡 گزینه --force هنوز در مرحله توسعه است و ممکن است در نسخه فعلی به درستی کار نکند.

نکات مهم​

در حالت عادی، Volume هایی که توسط کانتینرهای در حال اجرا استفاده می‌شوند قابل حذف نیستند.

حذف Volume باعث پاک شدن تمام اطلاعات ذخیره شده در آن می‌شود، پس با احتیاط از این دستور استفاده کنید.

اگر Volume در حال استفاده باشد، حذف آن بدون استفاده از --force ممکن نیست.

تست جامع​

#!/bin/bash

echo "Starting k3 volume remove tests..."
echo

echo "[1] Remove existing volume 'myDataVolume'"
k3 volume remove myDataVolume
echo

echo "[2] Remove non-existing volume 'ghostVolume' (should error)"
k3 volume remove ghostVolume
echo

echo "[3] Force remove volume 'myDataVolume' (may not be supported)"
k3 volume remove -f myDataVolume
echo

echo "All volume remove tests completed."

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

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

k3 volume remove -h