podman-search(1) General Commands Manual podman-search(1) نام (NAME) podman-search - جستجوی یک رجیستری برای یافتن ایمیج خلاصه دستور (SYNOPSIS) podman search [گزینه‌ها] term توضیحات (DESCRIPTION) دستور 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 گزینه‌ها (OPTIONS) --authfile=path مسیر فایل احراز هویت. پیش‌فرض در لینوکس ${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 انجام می‌پذیرد. --cert-dir=path استفاده از گواهی‌های موجود در path (*.crt, *.cert, *.key) برای اتصال به رجیستری (پیش‌فرض: /etc/containers/certs.d). برای جزئیات بیشتر، به containers-certs.d(5) مراجعه کنید. (این گزینه در کلاینت‌های راه دور پودمن، شامل سیستم‌های مک و ویندوز به استثنای WSL2 در دسترس نیست) --compatible نمایش شاخص‌های ستاره‌ها (stars)، رسمی (official) و خودکار (automated) پس از نام و توضیحات، همانند داکر. پودمن این شاخص‌ها را به‌طور پیش‌فرض نمایش نمی‌دهد زیرا توسط بیشتر رجیستری‌های کانتینر عمومی پشتیبانی نمی‌شوند. --creds=[username[:password]] مشخصات ورود [username[:password]] مورد استفاده برای احراز هویت در رجیستری، در صورت نیاز. اگر یک یا هر دو مقدار ارائه نشوند، اعلان خط فرمان ظاهر شده و می‌توان مقدار را وارد کرد. رمز عبور بدون نمایش نویسه‌ها (echo) دریافت می‌شود. توجه داشته باشید که مشخصات ورود تعیین‌شده تنها برای احراز هویت در برابر رجیستری‌های هدف به کار می‌روند. از این مشخصات برای آینه‌ها (mirrors) یا هنگام بازنویسی رجیستری استفاده نخواهد شد (به containers- registries.conf(5) مراجعه کنید)؛ برای احراز هویت در برابر آن‌ها استفاده از فایل containers-auth.json(5) را مد نظر قرار دهید. --filter, -f=filter فیلتر کردن خروجی بر اساس شرایط ارائه‌شده (پیش‌فرض []) فیلترهای پشتیبانی‌شده عبارتند از: • stars (عدد صحیح) - حداقل تعداد ستاره‌های لازم برای نمایش ایمیج‌ها • is-automated (بولی - true | false) - ساخت خودکار بودن ایمیج • is-official (بولی - true | false) - رسمی بودن ایمیج --format=format تغییر قالب خروجی به یک الگوی Go متغیرهای جانمای معتبر برای الگوی Go در جدول زیر فهرست شده‌اند: ┌────────────────────┬────────────────────────────────────────┐ │جانما (Placeholder) │ توضیحات │ ├────────────────────┼────────────────────────────────────────┤ │.Automated │ عبارت "[OK]" در صورت ساخت خودکار ایمیج │ ├────────────────────┼────────────────────────────────────────┤ │.Description │ توضیحات ایمیج │ ├────────────────────┼────────────────────────────────────────┤ │.Index │ رجیستری │ ├────────────────────┼────────────────────────────────────────┤ │.Name │ نام ایمیج │ ├────────────────────┼────────────────────────────────────────┤ │.Official │ عبارت "[OK]" در صورت رسمی بودن ایمیج │ ├────────────────────┼────────────────────────────────────────┤ │.Stars │ تعداد ستاره‌های ایمیج │ ├────────────────────┼────────────────────────────────────────┤ │.Tag │ برچسب مخزن │ └────────────────────┴────────────────────────────────────────┘ توجه: از .Tag تنها در صورتی استفاده کنید که گزینه --list-tags تنظیم شده باشد. --help, -h نمایش راهنمای استفاده از دستور --limit=limit محدود کردن تعداد نتایج (پیش‌فرض ۲۵). توجه: نتایج حاصل از هر رجیستری به این مقدار محدود می‌شود. برای مثال اگر محدودیت ۱۰ باشد و دو رجیستری جستجو شوند، تعداد کل نتایج حداکثر ۲۰ خواهد بود (۱۰ مورد از هر کدام، در صورتی که حداقل ۱۰ مورد مطابقت در هر یک وجود داشته باشد). ترتیب نتایج جستجو مطابق با ترتیبی است که اندپوینت API نتایج را بازمی‌گرداند. --list-tags فهرست کردن برچسب‌های موجود در مخزن برای ایمیج مشخص‌شده. توجه: گزینه --list-tags نیازمند آن است که عبارت جستجو یک نام کامل و مشخص از ایمیج باشد. نتیجه شامل نام ایمیج و برچسب آن خواهد بود؛ یک سطر به ازای هر برچسب مرتبط با ایمیج. --no-trunc عدم کوتاه‌سازی یا برش متن خروجی (پیش‌فرض false). --tls-verify الزام به استفاده از HTTPS و اعتبارسنجی گواهی‌ها هنگام ارتباط با رجیستری‌ها (پیش‌فرض: true). در صورت تنظیم صریح روی true، اعتبارسنجی TLS انجام می‌شود. در صورت تنظیم روی false، اعتبارسنجی TLS غیرفعال می‌شود. اگر مشخص نشود، اعتبارسنجی TLS فعال است مگر آنکه رجیستری هدف در فایل containers-registries.conf(5) به عنوان رجیستری ناامن ثبت شده باشد. مثال‌ها (EXAMPLES) جستجوی ایمیج‌های حاوی نام مشخص‌شده، با بازگرداندن سه ایمیج نخست از هر رجیستری تعریف‌شده: $ 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