.nh
.TH podman-login 1
.SH "نام (NAME)"
podman-login \- ورود به یک مخزن کانتینر

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

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman login\fP با استفاده از نام کاربری و گذرواژهٔ صحیح، به یک سرور مخزن (registry) مشخص وارد می‌شود. اگر مخزن مشخص نشده باشد، اولین مخزن زیر بخش [registries.search] در فایل registries.conf به کار گرفته می‌شود. \fBpodman login\fP نام کاربری و گذرواژه را از STDIN می‌خواند.
نام کاربری و گذرواژه را می‌توان با فلگ‌های \fBusername\fP و \fBpassword\fP نیز تنظیم کرد.
مسیر فایل احراز هویت را می‌توان توسط کاربر با تنظیم فلگ \fBauthfile\fP تعیین کرد. مسیر پیش‌فرض برای خواندن و نوشتن اطلاعات کاربری (credentials) برابر با \fB${XDG_RUNTIME_DIR}/containers/auth.json\fP است.
اگر کاربر نام کاربری را وارد نکند، پادمن از اطلاعات کاربری موجود استفاده می‌کند.
پادمن ابتدا نام کاربری و گذرواژه را در \fB${XDG_RUNTIME_DIR}/containers/auth.json\fP جستجو می‌کند، و اگر معتبر نباشند، پادمن از هرگونه اطلاعات کاربری موجود در \fB$HOME/.docker/config.json\fP استفاده می‌نماید.
اگر این اطلاعات کاربری موجود نباشند، پادمن فایل \fB${XDG_RUNTIME_DIR}/containers/auth.json\fP را (در صورت عدم وجود) ایجاد کرده و سپس نام کاربری و گذرواژهٔ خوانده‌شده از STDIN را به‌صورت یک رشته با کدگذاری base64 در آن ذخیره می‌کند.
برای جزئیات بیشتر در مورد قالب و پیکربندی‌های فایل auth.json، به containers-auth.json(5) مراجعه کنید.

.PP
\fBpodman [گزینه‌های سراسری]\fP

.PP
\fBpodman login [گزینه‌های سراسری]\fP

.PP
\fBpodman login [گزینه‌ها] [مخزن] [گزینه‌های سراسری]\fP

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--authfile\fP=\fIمسیر\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=\fIمسیر\fP\fP انجام شود.

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

.SS \fB--compat-auth-file\fP=\fIمسیر\fP
به‌جای به‌روزرسانی فایل پیش‌فرض اطلاعات کاربری، فایل موجود در \fIمسیر\fP را به‌روزرسانی کرده و از قالبی سازگار با داکر استفاده می‌کند.

.SS \fB--get-login\fP
نام کاربری واردشده برای مخزن را برمی‌گرداند. در صورت عدم یافتن ورود، خطا بازمی‌گرداند.

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

.SS \fB--password\fP, \fB-p\fP=\fIگذرواژه\fP
گذرواژه برای مخزن

.SS \fB--password-stdin\fP
دریافت گذرواژه از stdin

.SS \fB--secret\fP=\fIنام\fP
خواندن گذرواژهٔ مخزن از سکرت پادمن با \fBنام\fR مشخص‌شده.
اگر username-- مشخص نشده باشد، username=\fBنام\fR-- استفاده می‌شود.

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

.SS \fB--username\fP, \fB-u\fP=\fIنام‌کاربری\fP
نام کاربری برای مخزن

.SS \fB--verbose\fP, \fB-v\fP
چاپ اطلاعات تفصیلی دربارهٔ مخزن اطلاعات کاربری (credential store)

.SH "مثال‌ها (EXAMPLES)"
افزودن اطلاعات کاربری ورود برای مخزن مشخص‌شده به فایل پیش‌فرض احراز هویت؛
توجه داشته باشید که بر خلاف پیش‌فرض \fBdocker\fR، اطلاعات کاربری پیش‌فرض در \fB$XDG_RUNTIME_DIR\fR
که یک زیردایرکتوری از \fB/run\fR (یک دایرکتوری زودگذر) است قرار می‌گیرد و بنابراین پس از راه‌اندازی مجدد سیستم باقی نمی‌ماند.

.EX
$ podman login quay.io
Username: umohnani
Password:
Login Succeeded!
.EE

.PP
برای نگهداری صریح اطلاعات کاربری در سراسر راه‌اندازی‌های مجدد سیستم، باید مسیر دائمی پیش‌فرض را مشخص کنید:

.EX
$ podman login --authfile ~/.config/containers/auth.json quay.io
Username: umohnani
Password:
Login Succeeded!
.EE

.PP
افزودن اطلاعات کاربری ورود با استفاده از نام کاربری و گذرواژهٔ مشخص‌شده برای مخزن محلی به فایل پیش‌فرض احراز هویت:

.EX
$ podman login -u testuser -p testpassword localhost:5000
Login Succeeded!
.EE

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

.EX
$ podman login --authfile authdir/myauths.json quay.io
Username: umohnani
Password:
Login Succeeded!
.EE

.PP
افزودن اطلاعات کاربری ورود با استفاده از یک سکرت پادمن برای گذرواژه:

.EX
$ echo -n MySecret! | podman secret create secretname -
a0ad54df3c97cf89d5ca6193c
$ podman login --secret secretname -u testuser quay.io
Login Succeeded!
.EE

.PP
افزودن اطلاعات کاربری ورود برای کاربر test با گذرواژهٔ test به مخزن localhost:5000 با غیرفعال کردن الزام اعتبارسنجی TLS:

.EX
$ podman login --tls-verify=false -u test -p test localhost:5000
Login Succeeded!
.EE

.PP
افزودن اطلاعات کاربری ورود برای کاربر foo با گذرواژهٔ bar به مخزن localhost:5000 با استفاده از دایرکتوری گواهی /etc/containers/certs.d:

.EX
$ podman login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
Login Succeeded!
.EE

.PP
افزودن اطلاعات کاربری ورود برای مخازن مشخص‌شده به فایل پیش‌فرض احراز هویت برای کاربر مورد نظر با اطلاعات گذرواژهٔ ارائه‌شده از طریق stdin از یک فایل روی دیسک:

.EX
$ podman login -u testuser  --password-stdin < testpassword.txt docker.io
Login Succeeded!
.EE

.PP
افزودن اطلاعات کاربری ورود برای مخزن مشخص‌شده به فایل پیش‌فرض احراز هویت برای کاربر مورد نظر با اطلاعات گذرواژهٔ ارائه‌شده از طریق stdin از یک پایپ:

.EX
$ echo $testpassword | podman login -u testuser --password-stdin quay.io
Login Succeeded!
.EE

.PP
افزودن اطلاعات کاربری ورود برای مخزن مشخص‌شده به فایل پیش‌فرض احراز هویت در حالت پرحرف (verbose):

.EX
$ podman login quay.io --verbose
Username: myusername
Password:
Used: /run/user/1000/containers/auth.json
Login Succeeded!
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-logout(1)\fP, \fBcontainers-auth.json(5)\fP, \fBcontainers-certs.d(5)\fP, \fBcontainers-registries.conf(5)\fP, \fBpodman-secret(1)\fP, \fBpodman-secret-create(1)\fP

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