buildah-manifest-push(1)    General Commands Manual   buildah-manifest-push(1)

نام (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)

buildah                         September 2019        buildah-manifest-push(1)