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

دریافت ایمیج

دستور pull در زیربخش image برای دریافت (دانلود) یک ایمیج از ریجیستری استفاده می‌شود. با مشخص‌کردن نام ایمیج، سیستم تلاش می‌کند نسخهٔ مورد نظر را دریافت و در سیستم ذخیره کند.


🧩 دستور کلی

k3 image pull [options] <image>

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

گزینه کوتاهگزینه بلندتوضیح
-h--helpنمایش راهنمای کامل دستور

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

دریافت یک ایمیج مشخص:

k3 image pull ubuntu:22.04

مشاهده راهنمای دستور:

k3 image pull --help

نکات مهم

  • اگر نسخه‌ای از ایمیج از قبل وجود داشته باشد، پیام خطای مناسب را میدهد.
  • اتصال فعال به اینترنت و دسترسی به رجیستری الزامی است.
  • معماری برنامه به طوری است که اگر این ایمیج از لایه ای استفاده کند که قبلا وجود داشته، آن را دوباره دانلود نمیکند.
  • این دستور شامل progress bar است و میزان دریافت شده را نشان میدهد

تست جامع

echo "=== [1] Pull nginx:latest ==="
k3 image pull nginx:latest

echo "=== [2] Pull with invalid image name ==="
k3 image pull not/real:image

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

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

k3 image pull -h