.nh
.TH podman-manifest-push 1
.SH "نام (NAME)"
podman-manifest-push \- ارسال یک فهرست مانیفست یا نمایه ایمیج به یک رجیستری

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman manifest push\fP [\fIoptions\fP] \fIlistnameorindexname\fP [\fIdestination\fP]

.SH "توضیحات (DESCRIPTION)"
یک فهرست مانیفست یا نمایه ایمیج را به یک رجیستری ارسال می‌کند.

.SH "مقدار بازگشتی (RETURN VALUE)"
شناسه ایمیج فهرست و دایجست مانیفست ایمیج.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--add-compression\fP=\fIcompression\fP
اطمینان حاصل می‌کند که نوع فشرده‌سازی درخواستی برای هر بستر به فهرست مانیفست اضافه شود، در حالی که نمونه اصلی در همان فهرست مانیفست دست‌نخورده باقی می‌ماند. مقادیر پشتیبانی‌شده عبارتند از (\fBgzip\fR، \fBzstd\fR و \fBzstd:chunked\fR). این گزینه می‌تواند چندین بار استفاده شود.

.PP
توجه داشته باشید که \fB--compression-format\fR قالب فشرده‌سازی هر نمونه در فهرست مانیفست را کنترل می‌کند. گزینه \fB--add-compression\fR نوع دیگری را برای هر نمونه در فهرست با فشرده‌سازی‌های مشخص‌شده اضافه می‌کند. برای مثال، ترکیب \fB--compression-format\fR gzip و \fB--add-compression\fR zstd یک فهرست مانیفست ارسال می‌کند که در آن هر نمونه با gzip فشرده شده، به همراه یک نوع اضافی از هر نمونه که با zstd فشرده شده است.

.SS \fB--all\fP
علاوه بر خود فهرست یا نمایه، ایمیج‌های ذکرشده در فهرست مانیفست یا نمایه ایمیج را نیز ارسال می‌کند. (پیش‌فرض true است)

.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\fR انجام‌پذیر است.

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

.SS \fB--compression-format\fP=\fBgzip\fP | \fIzstd\fP | \fIzstd:chunked\fP
قالب فشرده‌سازی مورد استفاده را مشخص می‌کند. مقادیر پشتیبانی‌شده عبارتند از: \fBgzip\fR، \fBzstd\fR و \fBzstd:chunked\fR\&. مقدار پیش‌فرض \fBgzip\fR است، مگر اینکه در فایل containers.conf بازنویسی شده باشد.
گزینه \fBzstd:chunked\fR با رمزنگاری ایمیج‌ها ناسازگار است و در این حالت به عنوان \fBzstd\fR همراه با یک هشدار در نظر گرفته خواهد شد.

.SS \fB--compression-level\fP=\fIlevel\fP
سطح فشرده‌سازی مورد استفاده را مشخص می‌کند. این مقدار به الگوریتم فشرده‌سازی استفاده‌شده بستگی دارد؛ برای مثال برای zstd مقادیر پذیرفته‌شده در محدوده ۱ تا ۲۰ (شامل هر دو) با مقدار پیش‌فرض ۳ هستند، در حالی که برای gzip در محدوده ۱ تا ۹ (شامل هر دو) با مقدار پیش‌فرض ۵ است.

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

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

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

.SS \fB--force-compression\fP
در صورت تنظیم، عملیات ارسال از الگوریتم فشرده‌سازی مشخص‌شده استفاده می‌کند حتی اگر مقصد در حال حاضر شامل گونه‌ای با فشرده‌سازی متفاوت باشد.
اگر \fB--compression-format\fR به‌صراحت در خط فرمان مشخص شده باشد، مقدار پیش‌فرض \fBtrue\fR و در غیر این صورت \fBfalse\fR است.

.SS \fB--format\fP, \fB-f\fP=\fIformat\fP
نوع فهرست مانیفست (oci یا v2s2) جهت استفاده هنگام ارسال فهرست (پیش‌فرض oci است).

.SS \fB--quiet\fP, \fB-q\fP
هنگام نوشتن مانیفست، از نمایش خروجی‌های پیشرفت جلوگیری می‌کند.

.SS \fB--remove-signatures\fP
هنگام ارسال ایمیج‌ها، امضاها کپی نشوند.

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

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

.SS \fB--rm\fP
در صورت موفقیت‌آمیز بودن ارسال، فهرست مانیفست یا نمایه ایمیج از فضای ذخیره‌سازی محلی حذف شود.

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

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

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

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

.SS \fB--sign-passphrase-file\fP=\fIpath\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 "مقصد (DESTINATION)"
مقصد (DESTINATION) مکانی است که ایمیج کانتینر به آن ارسال می‌شود. این بخش از تمام روش‌های انتقال موجود در \fBcontainers-transports(5)\fR پشتیبانی می‌کند. اگر هیچ روش انتقالی مشخص نشود، از روش انتقال \fBdocker\fR (یعنی رجیستری کانتینر) استفاده می‌شود. برای کلاینت‌های راه دور، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2)، روش انتقال \fBdocker\fR تنها روش پشتیبانی‌شده است.

.SH "مثال‌ها (EXAMPLES)"
ارسال فهرست مانیفست به رجیستری کانتینر:

.EX
podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
.EE

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