نام (NAME)

buildah-manifest-add - افزودن یک تصویر یا دست‌ساخته به فهرست مانیفست یا نمایه تصویر.

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

buildah manifest add [options...] listNameOrIndexName imageOrArtifactName [...]

توضیحات (DESCRIPTION)

تصویر مشخص‌شده را به فهرست مانیفست یا نمایه تصویر تعیین‌شده اضافه می‌کند، یا یک مانیفست دست‌ساخته (artifact) ایجاد کرده و به نمایه تصویر مشخص‌شده اضافه می‌نماید.

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

شناسه تصویر فهرست و شناسه چکیده (digest) مانیفست تصویر.

گزینه‌ها (OPTIONS)

--all

اگر تصویری که باید به فهرست یا نمایه اضافه شود خود یک فهرست یا نمایه باشد، تمام محتویات آن را به فهرست محلی اضافه می‌کند. به طور پیش‌فرض، تنها یک تصویر از چنین فهرست یا نمایه‌ای اضافه خواهد شد. ترکیب گزینه --all با هر یک از گزینه‌های دیگر در زیر توصیه نمی‌شود.

--annotation annotation=value

تنظیم یک حاشیه‌نویسی (annotation) بر روی مدخل مربوط به تصویر تازه اضافه‌شده یا مانیفست دست‌ساخته.

--arch

بازنویسی معماری‌ای که فهرست یا نمایه به عنوان نیازمندی تصویر ثبت می‌کند. اگر imageName به یک فهرست مانیفست یا نمایه تصویر اشاره کند، اطلاعات معماری از آن بازیابی می‌شود. در غیر این صورت، از اطلاعات پیکربندی تصویر بازیابی خواهد شد.

--artifact

ایجاد یک مانیفست دست‌ساخته و افزودن آن به نمایه تصویر. آرگومان‌های بعد از نام نمایه به جای ارجاع به تصویر، به عنوان نام پرونده تفسیر خواهند شد. در بیشتر سناریوها، گزینه --artifact-type نیز باید مشخص شود.

--artifact-annotation annotation=value

هنگام ایجاد یک مانیفست دست‌ساخته و افزودن آن به نمایه تصویر، یک یادداشت در مانیفست دست‌ساخته تنظیم می‌کند.

--artifact-config filename

هنگام ایجاد مانیفست دست‌ساخته و افزودن آن به نمایه تصویر، از محتویات پرونده مشخص‌شده به عنوان حباب داده (blob) پیکربندی در مانیفست استفاده می‌کند. در بیشتر موارد، تغییر ندادن مقدار پیش‌فرض که نشان‌دهنده یک پیکربندی خالی است، گزینه ارجح است.

--artifact-config-type type

هنگام ایجاد مانیفست دست‌ساخته و افزودن آن به نمایه تصویر، از نوع MIME مشخص‌شده به عنوان mediaType مرتبط با حباب پیکربندی استفاده می‌کند. در بیشتر موارد، دست نخورده گذاشتن مقدار پیش‌فرض (پیکربندی خالی یا نوع استاندارد OCI) ترجیح داده می‌شود.

--artifact-exclude-titles

هنگام ایجاد مانیفست دست‌ساخته و افزودن آن به نمایه تصویر، یادداشت "org.opencontainers.image.title" برابر با نام پایه پرونده برای هر پرونده افزوده شده تنظیم نشود. ابزارهایی که دست‌ساخته‌ها را از رجیستری دریافت می‌کنند ممکن است از این مقادیر برای نام‌گذاری هنگام ذخیره روی دیسک استفاده کنند، بنابراین استفاده از این گزینه توصیه نمی‌شود مگر برای سازگاری با یک رجیستری خاص.

--artifact-layer-type type

هنگام ایجاد مانیفست دست‌ساخته و افزودن به نمایه تصویر، از نوع MIME مشخص‌شده به عنوان mediaType مرتبط با محتویات پرونده‌ها استفاده می‌کند. در صورت عدم تعیین، حدس‌هایی بر اساس نام یا محتوای پرونده زده می‌شود.

--artifact-subject imageName

هنگام ایجاد مانیفست دست‌ساخته و افزودن آن به نمایه تصویر، فیلد subject را تنظیم می‌کند تا نشان دهد دست‌ساخته به نحوی با تصویر مشخص‌شده مرتبط است. یک مانیفست دست‌ساخته حداکثر می‌تواند با یک موضوع (subject) مرتبط باشد.

--artifact-type type

هنگام ایجاد مانیفست دست‌ساخته، از نوع MIME مشخص‌شده به عنوان مقدار artifactType مانیفست استفاده می‌کند.

--authfile path

مسیر پرونده احراز هویت. پیش‌فرض ${XDG_RUNTIME_DIR}/containers/auth.json است. برای اطلاعات بیشتر به containers-auth.json(5) مراجعه کنید. این پرونده با استفاده از buildah login ساخته می‌شود.

اگر وضعیت احراز هویت در آنجا پیدا نشود، مسیر $HOME/.docker/config.json بررسی می‌شود که با docker login تنظیم شده است.

نکته: می‌توانید مسیر پیش‌فرض را با تنظیم متغیر محیطی REGISTRY_AUTH_FILE بازنویسی کنید: export REGISTRY_AUTH_FILE=path

--cert-dir path

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

--creds creds

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

--features

مشخص کردن فهرست ویژگی‌هایی که فهرست یا نمایه به عنوان نیازمندی تصویر ثبت می‌کند. این گزینه به‌ندرت استفاده می‌شود.

--os

بازنویسی سیستم‌عاملی که فهرست یا نمایه به عنوان نیازمندی ثبت می‌کند. اگر imageName به فهرست مانیفست یا نمایه ارجاع دهد، اطلاعات از آن بازیابی می‌شود؛ در غیر این صورت از پیکربندی تصویر استخراج خواهد شد.

--os-features

تعیین فهرست ویژگی‌های سیستم‌عامل ثبت‌شده به عنوان نیازمندی. این گزینه به‌ندرت استفاده می‌شود.

--os-version

تعیین نسخه سیستم‌عامل ثبت‌شده به عنوان نیازمندی. این گزینه به‌ندرت استفاده می‌شود.

--tls-verify bool-value

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

--variant

مشخص کردن گونه (variant) ثبت‌شده برای تصویر. این گزینه عموماً برای تمایز میان چند مدخل با معماری یکسان ولی نسخه‌های مختلف مجموعه دستورالعمل استفاده می‌شود.

مثال‌ها (EXAMPLE)

buildah manifest add mylist:v1.11 docker://fedora
506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:f81f09918379d5442d20dff82a298f29698197035e737f76e511d5af422cabd7

buildah manifest add --all mylist:v1.11 docker://fedora
506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:f81f09918379d5442d20dff82a298f29698197035e737f76e511d5af422cabd7

buildah manifest add --arch arm64 --variant v8 mylist:v1.11 docker://fedora@sha256:c829b1810d2dbb456e74a695fd3847530c8319e5a95dca623e9f1b1b89020d8b
506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:c829b1810d2dbb456e74a695fd3847530c8319e5a95dca623e9f1b1b89020d8b

buildah manifest add --artifact --artifact-type application/x-cd-image mylist:v1.11 ./imagefile.iso
506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:1768fae728f6f8ff3d0f8c7df409d7f4f0ca5c89b070810bd4aa4a2ed2eca8bb

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

buildah(1), buildah-login(1), buildah-manifest(1), buildah-manifest-create(1), buildah-manifest-remove(1), buildah-manifest-annotate(1), buildah-manifest-inspect(1), buildah-manifest-push(1), buildah-rmi(1), docker-login(1), containers-auth.json(5)