podman-search(1) General Commands Manual podman-search(1)

podman-search - جستجوی یک رجیستری برای یافتن ایمیج

podman search [گزینه‌ها] term

دستور podman search یک رجیستری یا فهرستی از رجیستری‌ها را برای یافتن ایمیج مطابق جستجو می‌کند. کاربر می‌تواند با افزودن نام رجیستری در ابتدای عبارت جستجو (مانند registry.fedoraproject.org/fedora)، رجیستری مورد نظر را مشخص کند. به‌طور پیش‌فرض، تمام رجیستری‌های جستجوی بدون صلاحیت (unqualified-search) در containers-registries.conf(5) استفاده می‌شوند.

تعداد پیش‌فرض نتایج ۲۵ است. تعداد نتایج را می‌توان با استفاده از گزینه --limit محدود کرد. اگر بیش از یک رجیستری جستجو شود، محدودیت برای هر رجیستری اعمال می‌گردد. خروجی را می‌توان با استفاده از گزینه --filter فیلتر کرد. برای دریافت تمامی ایمیج‌های موجود در یک رجیستری بدون تعیین عبارت جستجوی خاص، کاربر می‌تواند فقط نام رجیستری را همراه با یک "/" در انتها وارد کند (مانند registry.fedoraproject.org/).

توجه داشته باشید که podman search راه مطمئنی برای تعیین وجود یا عدم وجود یک ایمیج نیست. رفتار جستجو در نسخه‌های ۱ و ۲ رابط برنامه‌نویسی توزیع داکر (Docker distribution API)، به پیاده‌سازی هر رجیستری بستگی دارد. برخی رجیستری‌ها ممکن است اصلاً از قابلیت جستجو پشتیبانی نکنند. همچنین توجه داشته باشید که جستجو بدون وارد کردن عبارت جستجو، تنها برای رجیستری‌هایی کار می‌کند که API نسخه ۲ را پیاده‌سازی کرده باشند.

podman [GLOBAL OPTIONS]

podman search [GLOBAL OPTIONS]

podman search [OPTIONS] TERM

مسیر فایل احراز هویت. پیش‌فرض در لینوکس ${XDG_RUNTIME_DIR}/containers/auth.json و در ویندوز/مک‌او‌اس $HOME/.config/containers/auth.json است. این فایل با دستور podman login ایجاد می‌شود. اگر وضعیت اعتبار در آنجا یافت نشود، مسیر $HOME/.docker/config.json که با دستور docker login تنظیم می‌شود بررسی خواهد شد.

توجه: این امکان نیز وجود دارد که مسیر پیش‌فرض فایل احراز هویت را با تنظیم متغیر محیطی REGISTRY_AUTH_FILE بازنویسی کرد. این کار با دستور export REGISTRY_AUTH_FILE=path انجام می‌پذیرد.

استفاده از گواهی‌های موجود در path (*.crt, *.cert, *.key) برای اتصال به رجیستری (پیش‌فرض: /etc/containers/certs.d). برای جزئیات بیشتر، به containers-certs.d(5) مراجعه کنید. (این گزینه در کلاینت‌های راه دور پودمن، شامل سیستم‌های مک و ویندوز به استثنای WSL2 در دسترس نیست)

نمایش شاخص‌های ستاره‌ها (stars)، رسمی (official) و خودکار (automated) پس از نام و توضیحات، همانند داکر. پودمن این شاخص‌ها را به‌طور پیش‌فرض نمایش نمی‌دهد زیرا توسط بیشتر رجیستری‌های کانتینر عمومی پشتیبانی نمی‌شوند.

مشخصات ورود [username[:password]] مورد استفاده برای احراز هویت در رجیستری، در صورت نیاز. اگر یک یا هر دو مقدار ارائه نشوند، اعلان خط فرمان ظاهر شده و می‌توان مقدار را وارد کرد. رمز عبور بدون نمایش نویسه‌ها (echo) دریافت می‌شود.

توجه داشته باشید که مشخصات ورود تعیین‌شده تنها برای احراز هویت در برابر رجیستری‌های هدف به کار می‌روند. از این مشخصات برای آینه‌ها (mirrors) یا هنگام بازنویسی رجیستری استفاده نخواهد شد (به containers-registries.conf(5) مراجعه کنید)؛ برای احراز هویت در برابر آن‌ها استفاده از فایل containers-auth.json(5) را مد نظر قرار دهید.

فیلتر کردن خروجی بر اساس شرایط ارائه‌شده (پیش‌فرض [])

فیلترهای پشتیبانی‌شده عبارتند از:

  • stars (عدد صحیح) - حداقل تعداد ستاره‌های لازم برای نمایش ایمیج‌ها
  • is-automated (بولی - true | false) - ساخت خودکار بودن ایمیج
  • is-official (بولی - true | false) - رسمی بودن ایمیج

تغییر قالب خروجی به یک الگوی Go

متغیرهای جانمای معتبر برای الگوی Go در جدول زیر فهرست شده‌اند:

جانما (Placeholder) توضیحات
.Automated عبارت "[OK]" در صورت ساخت خودکار ایمیج
.Description توضیحات ایمیج
.Index رجیستری
.Name نام ایمیج
.Official عبارت "[OK]" در صورت رسمی بودن ایمیج
.Stars تعداد ستاره‌های ایمیج
.Tag برچسب مخزن

توجه: از .Tag تنها در صورتی استفاده کنید که گزینه --list-tags تنظیم شده باشد.

نمایش راهنمای استفاده از دستور

محدود کردن تعداد نتایج (پیش‌فرض ۲۵). توجه: نتایج حاصل از هر رجیستری به این مقدار محدود می‌شود. برای مثال اگر محدودیت ۱۰ باشد و دو رجیستری جستجو شوند، تعداد کل نتایج حداکثر ۲۰ خواهد بود (۱۰ مورد از هر کدام، در صورتی که حداقل ۱۰ مورد مطابقت در هر یک وجود داشته باشد). ترتیب نتایج جستجو مطابق با ترتیبی است که اندپوینت API نتایج را بازمی‌گرداند.

فهرست کردن برچسب‌های موجود در مخزن برای ایمیج مشخص‌شده. توجه: گزینه --list-tags نیازمند آن است که عبارت جستجو یک نام کامل و مشخص از ایمیج باشد. نتیجه شامل نام ایمیج و برچسب آن خواهد بود؛ یک سطر به ازای هر برچسب مرتبط با ایمیج.

عدم کوتاه‌سازی یا برش متن خروجی (پیش‌فرض false).

الزام به استفاده از HTTPS و اعتبارسنجی گواهی‌ها هنگام ارتباط با رجیستری‌ها (پیش‌فرض: true). در صورت تنظیم صریح روی true، اعتبارسنجی TLS انجام می‌شود. در صورت تنظیم روی false، اعتبارسنجی TLS غیرفعال می‌شود. اگر مشخص نشود، اعتبارسنجی TLS فعال است مگر آنکه رجیستری هدف در فایل containers-registries.conf(5) به عنوان رجیستری ناامن ثبت شده باشد.

جستجوی ایمیج‌های حاوی نام مشخص‌شده، با بازگرداندن سه ایمیج نخست از هر رجیستری تعریف‌شده:

$ podman search --limit 3 fedora
NAME                                           DESCRIPTION
registry.fedoraproject.org/f29/fedora-toolbox
registry.fedoraproject.org/f30/fedora-toolbox
registry.fedoraproject.org/f31/fedora-toolbox
docker.io/library/fedora                       Official Docker builds of Fedora
docker.io/kasmweb/fedora-37-desktop            Fedora 37 desktop for Kasm Workspaces
docker.io/kasmweb/fedora-38-desktop            Fedora 38 desktop for Kasm Workspaces
quay.io/fedora/fedora
quay.io/containerdisks/fedora                  # Fedora Containerdisk Images  <img src="htt...
quay.io/fedora/fedora-minimal

توجه داشته باشید که شاخص‌های Stars، Official و Automated تنها در داکر هاب در دسترس هستند و بنابراین به‌طور پیش‌فرض نمایش داده نمی‌شوند:

$ podman search --format "{{.Name}}\t{{.Stars}}\t{{.Official}}" alpine --limit 3
docker.io/library/alpine       7956        [OK]
docker.io/alpine/git           192
docker.io/anapsix/alpine-java  474
quay.io/libpod/alpine          0
quay.io/vqcomms/alpine-tools   0
quay.io/wire/alpine-deps       0

جستجو و فهرست کردن برچسب‌ها برای ایمیج مشخص‌شده با بازگرداندن چهار برچسب نخست از هر رجیستری تعریف‌شده:

$ podman search --list-tags registry.access.redhat.com/ubi8 --limit 4
NAME                             TAG
registry.access.redhat.com/ubi8  8.4-211
registry.access.redhat.com/ubi8  8.4-206.1626828523-source
registry.access.redhat.com/ubi8  8.4-199
registry.access.redhat.com/ubi8  8.4-211-source

توجه: این قابلیت تنها با رجیستری‌هایی کار می‌کند که API نسخه ۲ را پیاده‌سازی کرده باشند. در صورت تلاش با یک رجیستری نسخه ۱، خطا برگردانده می‌شود.

registries.conf (/etc/containers/registries.conf)

فایل registries.conf فایل پیکربندی است که مشخص می‌کند هنگام تکمیل نام ایمیج‌هایی که فاقد بخش رجیستری یا دامنه هستند، به کدام رجیستری‌های کانتینر مراجعه شود.

podman(1), containers-registries(5)

ژانویه ۲۰۱۸، در ابتدا توسط Urvashi Mohnani umohnani@redhat.com گردآوری شد ⟨mailto:umohnani@redhat.com⟩