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

لیست ایمیج ها

دستور list در زیربخش image برای مشاهده‌ی لیستی از ایمیج‌های موجود در سیستم استفاده می‌شود. این دستور امکان فیلتر بر اساس نام ایمیج یا تگ را در اختیار شما قرار می‌دهد.

🧩 دستور کلی​

k3 image list [options]

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

گزینه کوتاهگزینه بلندتوضیح
-t--tag <tag>فیلتر بر اساس تگ ایمیج (مثلاً latest)
-i--image <image>فیلتر بر اساس نام ایمیج (مثلاً nginx)
-h--helpنمایش راهنمای کامل دستور

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

لیست کامل ایمیج‌ها:​

k3 image list

فیلتر بر اساس نام ایمیج:​

k3 image list --image nginx

فیلتر بر اساس تگ خاص:​

k3 image list --tag latest

فیلتر همزمان بر اساس نام ایمیج و تگ:​

k3 image list --image ubuntu --tag 22.04

نکات مهم​

  • برای فیلتر دقیق‌تر می‌توانید از هر دو گزینه --image و --tag به صورت همزمان استفاده کنید.
  • اگر هیچ گزینه‌ای ارائه ندهید، تمام ایمیج‌های موجود لیست خواهند شد.

تست جامع​

echo "=== [1] All images ==="
k3 image list
echo

echo "=== [2] Filter by image name: nginx ==="
k3 image list --image nginx
echo

echo "=== [3] Filter by tag: latest ==="
k3 image list --tag latest
echo

echo "=== [4] Filter by image and tag: ubuntu:22.04 ==="
k3 image list --image ubuntu --tag 22.04
echo

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

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

k3 image list -h