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

podman-login - ورود به یک مخزن کانتینر

podman login [گزینه‌ها] [مخزن]

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

podman [گزینه‌های سراسری]

podman login [گزینه‌های سراسری]

podman login [گزینه‌ها] [مخزن] [گزینه‌های سراسری]

مسیر فایل احراز هویت. پیش‌فرض در لینوکس ${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=مسیر انجام شود.

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

به‌جای به‌روزرسانی فایل پیش‌فرض اطلاعات کاربری، فایل موجود در مسیر را به‌روزرسانی کرده و از قالبی سازگار با داکر استفاده می‌کند.

نام کاربری واردشده برای مخزن را برمی‌گرداند. در صورت عدم یافتن ورود، خطا بازمی‌گرداند.

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

گذرواژه برای مخزن

دریافت گذرواژه از stdin

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

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

نام کاربری برای مخزن

چاپ اطلاعات تفصیلی دربارهٔ مخزن اطلاعات کاربری (credential store)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

podman(1), podman-logout(1), containers-auth.json(5), containers-certs.d(5), containers-registries.conf(5), podman-secret(1), podman-secret-create(1)

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