| podman-artifact-push(1) | General Commands Manual | podman-artifact-push(1) |
نام (NAME)
podman-artifact-push - ارسال یک مصنوع OCI از ذخیرهساز محلی به یک رجیستری ایمیج
خلاصه دستور (SYNOPSIS)
podman artifact push [گزینهها] ایمیج
توضیحات (DESCRIPTION)
دستور podman artifact push یک مصنوع را از مخزن مصنوعات محلی به یک رجیستری ایمیج ارسال میکند.
# ارسال مصنوع به یک رجیستری کانتینر $ podman artifact push quay.io/artifact/foobar1:latest
گزینهها (OPTIONS)
--authfile=مسیر
مسیر فایل احراز هویت. پیشفرض در لینوکس ${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=مسیر
استفاده از گواهیهای موجود در مسیر (*.crt، *.cert، *.key) برای اتصال به رجیستری (پیشفرض: /etc/containers/certs.d). برای جزئیات بیشتر به containers-certs.d(5) مراجعه کنید. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاههای مک و ویندوز (به استثنای WSL2) در دسترس نیست).
--creds=[نامکاربری[:گذرواژه]]
مقدار [نامکاربری[:گذرواژه]] برای احراز هویت در رجیستری (در صورت نیاز). اگر یک یا هر دو مقدار مشخص نشوند، اعلان خط فرمان ظاهر شده و میتوان مقدار را وارد نمود. گذرواژه بدون بازتاب (echo) وارد میشود.
توجه داشته باشید که اعتبارنامههای مشخصشده فقط برای احراز هویت در رجیستریهای هدف استفاده میشوند. آنها برای آینهها یا هنگام بازنویسی رجیستری استفاده نخواهند شد (به containers-registries.conf(5) مراجعه کنید)؛ برای احراز هویت در این موارد استفاده از فایل containers-auth.json(5) را مد نظر قرار دهید.
--digestfile=فایلدایجست
پس از کپی کردن ایمیج، دایجست ایمیج حاصل را در فایل مینویسد.
--quiet, -q
عدم نمایش پیامهای خروجی اطلاعاتی (که نشان میدهند کدام دستورالعمل در حال پردازش است و وضعیت پیشرفت آن چگونه است). فقط پیام خطای نهایی یا اطلاعات تکمیل موفقیتآمیز، مانند شناسه ایمیج یا کانتینر چاپ میشود.
--retry=دفعات
تعداد دفعات تلاش مجدد برای دریافت یا ارسال ایمیجها میان رجیستری و ذخیرهساز محلی در صورت بروز خطا. مقدار پیشفرض 3 است.
--retry-delay=مدتزمان
مدت زمان تأخیر میان دفعات تلاش مجدد در هنگام دریافت یا ارسال ایمیجها میان رجیستری و ذخیرهساز محلی در صورت بروز خطا. حالت پیشفرض شروع با دو ثانیه و سپس افزایش نمایی (exponential backoff) است. در صورت تنظیم این مقدار، تأخیر ثابت مشخصشده استفاده شده و عقبنشینی نمایی صورت نمیگیرد.
--sign-by=کلید
افزودن امضای «امضای ساده» (simple signing) در مقصد با استفاده از کلید مشخصشده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاههای مک و ویندوز (به استثنای WSL2) در دسترس نیست).
--sign-by-sigstore=فایلمولفه
افزودن امضای sigstore بر اساس گزینههای مشخصشده بیشتر در فایل پارامتر امضای sigstore کانتینر، یعنی param-file. برای جزئیات بیشتر در مورد ساختار فایل به containers-sigstore-signing-params.yaml(5) مراجعه کنید.
--sign-by-sigstore-private-key=مسیر
افزودن امضای sigstore در مقصد با استفاده از کلید خصوصی در مسیر مشخصشده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاههای مک و ویندوز (به استثنای WSL2) در دسترس نیست).
--sign-by-sq-fingerprint=اثرانگشت
افزودن امضای «امضای ساده» با استفاده از یک کلید Sequoia-PGP با اثر انگشت مشخصشده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاههای مک و ویندوز (به استثنای WSL2) در دسترس نیست).
--sign-passphrase-file=مسیر
در صورت امضای ایمیج (با استفاده از --sign-by، --sign-by-sq-fingerprint یا --sign-by-sigstore-private-key)، عبارت عبور مورد استفاده را از مسیر مشخصشده بخواند.
--tls-verify
الزام HTTPS و تایید گواهیها هنگام ارتباط با رجیستریها (پیشفرض: true). اگر به صراحت روی true تنظیم شود، اعتبارسنجی TLS اعمال میشود. اگر روی false تنظیم شود، اعتبارسنجی TLS اعمال نمیشود. اگر مشخص نشده باشد، اعتبارسنجی TLS استفاده میشود مگر اینکه رجیستری هدف در containers-registries.conf(5) به عنوان یک رجیستری ناامن ذکر شده باشد.
مثالها (EXAMPLES)
ارسال ایمیج مشخصشده به یک رجیستری کانتینر:
$ podman artifact push quay.io/baude/artifact:single Getting image source signatures Copying blob 3ddc0a3cdb61 done | Copying config 44136fa355 done | Writing manifest to image destination
همچنین ببینید (SEE ALSO)
podman(1), podman-artifact(1), podman-pull(1), podman-login(1), containers-certs.d(5)
تاریخچه (HISTORY)
ژانویه ۲۰۲۵، در ابتدا توسط Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩ گردآوری شد.