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

بررسی ایمیج

دستور inspect در زیربخش image برای مشاهده‌ی اطلاعات دقیق یک ایمیج خاص استفاده می‌شود. این دستور از طریق نام ایمیج، اطلاعات متادیتا مانند لایه‌ها، تگ‌ها و اطلاعات کلی را در اختیار کاربر قرار می‌دهد.

🧩 دستور کلی​

k3 image inspect [options] <image>

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

گزینه کوتاهگزینه بلندتوضیح
-c--containerImageTransport <value>تعیین نوع transport برای دریافت ایمیج (docker, docker-archive, docker-daemon, oci)
-h--helpنمایش راهنمای کامل دستور

توضیح:

  • مقدار oci ایمیج را از رجیستری لوکال بارگذاری می‌کند.
  • مقدار docker ایمیج را از رجیستری‌های ریموت دریافت می‌کند.
  • مقدار پیش فرض برای تگ latest است.

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

بررسی یک ایمیج با transport پیش‌فرض:​

k3 image inspect nginx:latest

بررسی ایمیج از رجیستری Docker:​

k3 image inspect ubuntu:22.04 --containerImageTransport docker

بررسی ایمیج از ایمیج های سیستم:​

k3 image inspect alpine --containerImageTransport oci

نکات مهم​

  • اگر transport مشخص نشود، مقدار پیش‌فرض استفاده خواهد شد (oci).
  • در صورتی که ایمیج در transport انتخاب‌شده موجود نباشد، پیام خطا نمایش داده می‌شود.

تست جامع​

echo "=== [1] Inspect from Docker registry ==="
k3 image inspect alpine:latest -c docker

echo "=== [2] Inspect from local OCI ==="
k3 image inspect alpine -c oci

echo "=== [3] Inspect unknown image ==="
k3 image inspect doesnotexist -c docker

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

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

k3 image inspect -h