'\" t
.nh
.TH podman-search 1
.SH "نام (NAME)"
podman-search \- جستجوی یک رجیستری برای یافتن ایمیج

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman search\fP [\fIگزینه‌ها\fP] \fIterm\fP

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman search\fP یک رجیستری یا فهرستی از رجیستری‌ها را برای یافتن ایمیج مطابق جستجو می‌کند.
کاربر می‌تواند با افزودن نام رجیستری در ابتدای عبارت جستجو (مانند \fBregistry.fedoraproject.org/fedora\fP)، رجیستری مورد نظر را مشخص کند. به‌طور پیش‌فرض، تمام رجیستری‌های جستجوی بدون صلاحیت (unqualified-search) در \fBcontainers-registries.conf(5)\fR استفاده می‌شوند.

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

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

.PP
\fBpodman [GLOBAL OPTIONS]\fP

.PP
\fBpodman search [GLOBAL OPTIONS]\fP

.PP
\fBpodman search [OPTIONS] TERM\fP

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--authfile\fP=\fIpath\fP
مسیر فایل احراز هویت. پیش‌فرض در لینوکس \fB${XDG_RUNTIME_DIR}/containers/auth.json\fR و در ویندوز/مک‌او‌اس \fB$HOME/.config/containers/auth.json\fR است.
این فایل با دستور \fBpodman login\fP ایجاد می‌شود. اگر وضعیت اعتبار در آنجا یافت نشود، مسیر \fB$HOME/.docker/config.json\fR که با دستور \fBdocker login\fP تنظیم می‌شود بررسی خواهد شد.

.PP
توجه: این امکان نیز وجود دارد که مسیر پیش‌فرض فایل احراز هویت را با تنظیم متغیر محیطی \fBREGISTRY_AUTH_FILE\fR بازنویسی کرد. این کار با دستور \fBexport REGISTRY_AUTH_FILE=\fIpath\fP\fP انجام می‌پذیرد.

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

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

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

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

.SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP
فیلتر کردن خروجی بر اساس شرایط ارائه‌شده (پیش‌فرض [])

.PP
فیلترهای پشتیبانی‌شده عبارتند از:
.IP \(bu 2
stars (عدد صحیح) - حداقل تعداد ستاره‌های لازم برای نمایش ایمیج‌ها
.IP \(bu 2
is-automated (بولی - true | false) - ساخت خودکار بودن ایمیج
.IP \(bu 2
is-official (بولی - true | false) - رسمی بودن ایمیج

.SS \fB--format\fP=\fIformat\fP
تغییر قالب خروجی به یک الگوی Go

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

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

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

.SS \fB--help\fP, \fB-h\fP
نمایش راهنمای استفاده از دستور

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

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

.SS \fB--no-trunc\fP
عدم کوتاه‌سازی یا برش متن خروجی (پیش‌فرض \fIfalse\fP).

.SS \fB--tls-verify\fP
الزام به استفاده از HTTPS و اعتبارسنجی گواهی‌ها هنگام ارتباط با رجیستری‌ها (پیش‌فرض: \fBtrue\fP).
در صورت تنظیم صریح روی \fBtrue\fP، اعتبارسنجی TLS انجام می‌شود.
در صورت تنظیم روی \fBfalse\fP، اعتبارسنجی TLS غیرفعال می‌شود.
اگر مشخص نشود، اعتبارسنجی TLS فعال است مگر آنکه رجیستری هدف در فایل \fBcontainers-registries.conf(5)\fP به عنوان رجیستری ناامن ثبت شده باشد.

.SH "مثال‌ها (EXAMPLES)"
جستجوی ایمیج‌های حاوی نام مشخص‌شده، با بازگرداندن سه ایمیج نخست از هر رجیستری تعریف‌شده:

.EX
$ 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
.EE

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

.EX
$ 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
.EE

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

.EX
$ 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
.EE

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

.SH "فایل‌ها (FILES)"
\fBregistries.conf\fP (\fB/etc/containers/registries.conf\fR)

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

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBcontainers-registries(5)\fP

.SH "تاریخچه (HISTORY)"
ژانویه ۲۰۱۸، در ابتدا توسط Urvashi Mohnani umohnani@redhat.com گردآوری شد
\[la]mailto:umohnani@redhat.com\[ra]