.nh
.TH podman-artifact-push 1
.SH "نام (NAME)"
podman-artifact-push \- ارسال یک مصنوع OCI از ذخیره‌ساز محلی به یک رجیستری ایمیج

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

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman artifact push\fP یک مصنوع را از مخزن مصنوعات محلی به یک رجیستری ایمیج ارسال می‌کند.

.EX
# ارسال مصنوع به یک رجیستری کانتینر
$ podman artifact push quay.io/artifact/foobar1:latest
.EE

.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=\fIpath\fP\fP امکان‌پذیر است.

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

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

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

.SS \fB--digestfile\fP=\fIفایل‌دایجست\fP
پس از کپی کردن ایمیج، دایجست ایمیج حاصل را در فایل می‌نویسد.

.SS \fB--quiet\fP, \fB-q\fP
عدم نمایش پیام‌های خروجی اطلاعاتی (که نشان می‌دهند کدام دستورالعمل در حال پردازش است و وضعیت پیشرفت آن چگونه است). فقط پیام خطای نهایی یا اطلاعات تکمیل موفقیت‌آمیز، مانند شناسه ایمیج یا کانتینر چاپ می‌شود.

.SS \fB--retry\fP=\fIدفعات\fP
تعداد دفعات تلاش مجدد برای دریافت یا ارسال ایمیج‌ها میان رجیستری و ذخیره‌ساز محلی در صورت بروز خطا. مقدار پیش‌فرض \fB3\fP است.

.SS \fB--retry-delay\fP=\fIمدت‌زمان\fP
مدت زمان تأخیر میان دفعات تلاش مجدد در هنگام دریافت یا ارسال ایمیج‌ها میان رجیستری و ذخیره‌ساز محلی در صورت بروز خطا. حالت پیش‌فرض شروع با دو ثانیه و سپس افزایش نمایی (exponential backoff) است. در صورت تنظیم این مقدار، تأخیر ثابت مشخص‌شده استفاده شده و عقب‌نشینی نمایی صورت نمی‌گیرد.

.SS \fB--sign-by\fP=\fIکلید\fP
افزودن امضای «امضای ساده» (simple signing) در مقصد با استفاده از کلید مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--sign-by-sigstore\fP=\fIفایل‌مولفه\fP
افزودن امضای sigstore بر اساس گزینه‌های مشخص‌شده بیشتر در فایل پارامتر امضای sigstore کانتینر، یعنی \fIparam-file\fP\&.
برای جزئیات بیشتر در مورد ساختار فایل به \fBcontainers-sigstore-signing-params.yaml(5)\fP مراجعه کنید.

.SS \fB--sign-by-sigstore-private-key\fP=\fIمسیر\fP
افزودن امضای sigstore در مقصد با استفاده از کلید خصوصی در مسیر مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--sign-by-sq-fingerprint\fP=\fIاثرانگشت\fP
افزودن امضای «امضای ساده» با استفاده از یک کلید Sequoia-PGP با اثر انگشت مشخص‌شده.
(این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--sign-passphrase-file\fP=\fIمسیر\fP
در صورت امضای ایمیج (با استفاده از \fB--sign-by\fP، \fB--sign-by-sq-fingerprint\fP یا \fB--sign-by-sigstore-private-key\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 artifact push quay.io/baude/artifact:single
Getting image source signatures
Copying blob 3ddc0a3cdb61 done   |
Copying config 44136fa355 done   |
Writing manifest to image destination
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-artifact(1)\fP, \fBpodman-pull(1)\fP, \fBpodman-login(1)\fP, \fBcontainers-certs.d(5)\fP

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