نام (NAME)

buildah-manifest-push - ارسال یک لیست مانیفست یا نمایه تصویر به یک رجیستری

خلاصه دستور (SYNOPSIS)

buildah manifest push [options...] listNameOrIndexName transport:details

توضیحات (DESCRIPTION)

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

مقدار بازگشتی (RETURN VALUE)

شناسه (ID) تصویرِ لیست و دایجست (digest) مانیفست تصویر.

گزینه‌ها (OPTIONS)

--add-compression compression

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

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

--all

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

--authfile path

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

--cert-dir path

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

--compression-format format

قالب فشرده‌سازی مورد استفاده را مشخص می‌کند. مقادیر پشتیبانی‌شده عبارتند از: gzip، zstd و zstd:chunked.

--compression-level level

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

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

--creds creds

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

--digestfile Digestfile

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

--force-compression

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

--format, -f

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

--quiet, -q

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

--remove-signatures

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

--retry attempts

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

پیش‌فرض 3 است.

--retry-delay duration

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

پیش‌فرض 2s است.

--rm

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

--sign-by fingerprint

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

--timestamp seconds

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

--tls-verify bool-value

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

مثال‌ها (EXAMPLES)

buildah manifest push mylist:v1.11 registry.example.org/mylist:v1.11

همچنین ببینید (SEE ALSO)

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)