.nh
.TH buildah-manifest-add "1" "September 2019" "buildah"
.SH "نام (NAME)"
.PP
buildah-manifest-add \- افزودن یک تصویر یا دست‌ساخته به فهرست مانیفست یا نمایه تصویر.

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

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

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

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

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

.PP
\fB--annotation\fP \fIannotation=value\fP

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

.PP
\fB--arch\fP

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

.PP
\fB--artifact\fP

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

.PP
\fB--artifact-annotation\fP \fIannotation=value\fP

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

.PP
\fB--artifact-config\fP \fIfilename\fP

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

.PP
\fB--artifact-config-type\fP \fItype\fP

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

.PP
\fB--artifact-exclude-titles\fP

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

.PP
\fB--artifact-layer-type\fP \fItype\fP

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

.PP
\fB--artifact-subject\fP \fIimageName\fP

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

.PP
\fB--artifact-type\fP \fItype\fP

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

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

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

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

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

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

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

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

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

.PP
\fB--features\fP

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

.PP
\fB--os\fP

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

.PP
\fB--os-features\fP

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

.PP
\fB--os-version\fP

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

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

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

.PP
\fB--variant\fP

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

.SH "مثال‌ها (EXAMPLE)"
.EX
buildah manifest add mylist:v1.11 docker://fedora
506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:f81f09918379d5442d20dff82a298f29698197035e737f76e511d5af422cabd7
.EE

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

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

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

.SH "همچنین ببینید (SEE ALSO)"
.PP
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)