.nh
.TH buildah-manifest-push "1" "September 2019" "buildah"
.SH "نام (NAME)"
.PP
buildah-manifest-push \- ارسال یک لیست مانیفست یا نمایه تصویر به یک رجیستری

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBbuildah manifest push\fP [options...] \fIlistNameOrIndexName\fP \fItransport:details\fP

.SH "توضیحات (DESCRIPTION)"
.PP
یک لیست مانیفست (manifest list) یا نمایه تصویر (image index) را به یک رجیستری ارسال می‌کند (push).

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

.SH "گزینه‌ها (OPTIONS)"
.PP
\fB--add-compression\fP \fIcompression\fP

.PP
اطمینان حاصل می‌کند که گونه فشرده‌سازی درخواستی برای هر پلتفرم به لیست مانیفست اضافه شود، در حالی که نمونه اصلی در همان لیست مانیفست دست‌نخورده باقی می‌ماند. مقادیر پشتیبانی‌شده عبارتند از (\fBgzip\fR، \fBzstd\fR و \fBzstd:chunked\fR).

.PP
نکته: این گزینه با \fB--compression\fR متفاوت است؛ گزینه مذکور نمونه را با فشرده‌سازی درخواستی و مشخص‌شده جایگزین می‌کند، در حالی که \fB--add-compression\fR تضمین می‌کند گونه هر نمونه، بدون تغییر نمونه اصلی، به لیست مانیفست افزوده شود.

.PP
\fB--all\fP

.PP
علاوه بر خود لیست یا نمایه، تصاویری که در لیست مانیفست یا نمایه تصویر به آن‌ها اشاره شده است را نیز ارسال می‌کند. (پیش‌فرض true است)

.PP
\fB--authfile\fP \fIpath\fP

.PP
مسیر فایل احراز هویت. مقدار پیش‌فرض ${XDG_RUNTIME_DIR}/containers/auth.json است که با استفاده از \fBbuildah login\fR\& تنظیم می‌شود. اگر وضعیت احراز هویت در آنجا یافت نشود، مسیر $HOME/.docker/config.json بررسی می‌شود که از طریق \fBdocker login\fR\& تنظیم می‌گردد.

.PP
\fB--cert-dir\fP \fIpath\fP

.PP
استفاده از گواهی‌های موجود در \fIpath\fP (*\&.crt, *\&.cert, *\&.key) برای اتصال به رجیستری. دایرکتوری پیش‌فرض گواهی‌ها \fI/etc/containers/certs.d\fP\& است.

.PP
\fB--compression-format\fP \fIformat\fP

.PP
قالب فشرده‌سازی مورد استفاده را مشخص می‌کند. مقادیر پشتیبانی‌شده عبارتند از: \fBgzip\fR، \fBzstd\fR و \fBzstd:chunked\fR\&.

.PP
\fB--compression-level\fP \fIlevel\fP

.PP
سطح فشرده‌سازی مورد استفاده در عملیات فشرده‌سازی را تعیین می‌کند.

.PP
سطح فشرده‌سازی مورد استفاده را مشخص می‌کند. این مقدار مختص الگوریتم فشرده‌سازی به‌کاررفته است؛ برای مثال برای zstd مقادیر پذیرفته‌شده در بازه ۱\-۲۰ (شامل هر دو) هستند، در حالی که برای gzip بازه ۱\-۹ (شامل هر دو) است.

.PP
\fB--creds\fP \fIcreds\fP

.PP
مقدار [username[:password]] برای احراز هویت در رجیستری در صورت نیاز. اگر یک یا هر دو مقدار ارائه نشوند، اعلانی در خط فرمان ظاهر شده و می‌توان مقادیر را وارد کرد. گذرواژه بدون بازتاب (echo) در ترمینال وارد می‌شود.

.PP
\fB--digestfile\fP \fIDigestfile\fP

.PP
پس از کپی کردن تصویر، دایجست تصویر حاصل را در فایل می‌نویسد.

.PP
\fB--force-compression\fP

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

.PP
\fB--format\fP, \fB-f\fP

.PP
نوع لیست مانیفست (oci یا v2s2) برای استفاده در هنگام ارسال لیست (پیش‌فرض oci است).

.PP
\fB--quiet\fP, \fB-q\fP

.PP
عدم نمایش اطلاعات پیشرفت در هنگام ارسال لیست‌ها.

.PP
\fB--remove-signatures\fP

.PP
عدم کپی کردن امضاها در هنگام ارسال تصاویر.

.PP
\fB--retry\fP \fIattempts\fP

.PP
تعداد دفعات تلاش مجدد در صورت بروز خطا در حین ارسال تصاویر به رجیستری.

.PP
پیش‌فرض \fB3\fR\& است.

.PP
\fB--retry-delay\fP \fIduration\fP

.PP
مدت زمان تأخیر بین تلاش‌های مجدد در صورت بروز خطا در حین ارسال تصاویر به رجیستری.

.PP
پیش‌فرض \fB2s\fR\& است.

.PP
\fB--rm\fP

.PP
حذف لیست مانیفست یا نمایه تصویر از فضای ذخیره‌سازی محلی در صورت موفقیت‌آمیز بودن ارسال.

.PP
\fB--sign-by\fP \fIfingerprint\fP

.PP
امضای تصاویر ارسال‌شده با استفاده از کلید GPG منطبق با اثر انگشت (fingerprint) مشخص‌شده.

.PP
\fB--timestamp\fP \fIseconds\fP

.PP
تنظیم برچسب زمانی «created» برای خروجی‌ها بر اساس این تعداد ثانیه پس از مبدأ یونیکس (Unix epoch، یعنی ساعت 00:00:00 UTC در ۱ ژانویه ۱۹۷۰) (پیش‌فرض بر روی زمان فعلی است). برای مثال، اگر از یک خروجی oci-archive استفاده شود، زمان ایجاد ورودی‌های tar روی این مقدار تنظیم می‌گردد.

.PP
\fB--tls-verify\fP \fIbool-value\fP

.PP
الزام استفاده از HTTPS و تأیید گواهی‌ها در زمان ارتباط با رجیستری‌های کانتینر (پیش‌فرض true است). تأیید اعتبار TLS نمی‌تواند در ارتباط با یک رجیستری ناامن (insecure) استفاده شود.

.SH "مثال‌ها (EXAMPLES)"
.EX
buildah manifest push mylist:v1.11 registry.example.org/mylist:v1.11
.EE

.SH "همچنین ببینید (SEE ALSO)"
.PP
buildah(1), buildah-login(1), buildah-manifest(1), buildah-manifest-create(1), buildah-manifest-add(1), buildah-manifest-remove(1), buildah-manifest-annotate(1), buildah-manifest-inspect(1), buildah-rmi(1), docker-login(1)