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

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman manifest add\fP [\fIoptions\fP] \fIlistnameorindexname\fP [\fItransport\fP]:\fIimagename\fP \fIimageorartifactname\fP [...]

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

.SH "مقدار بازگشتی (RETURN VALUE)"
شناسه ایمیج فهرست.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--all\fP
اگر ایمیجی که به فهرست یا نمایه اضافه می‌شود خود یک فهرست یا نمایه باشد، تمام محتویات آن را به فهرست محلی اضافه می‌کند. به‌طور پیش‌فرض، تنها یک ایمیج از چنین فهرست یا نمایه‌ای به فهرست یا نمایه اضافه می‌شود. ترکیب \fI--all\fP با هر یک از گزینه‌های دیگر که در ادامه توضیح داده شده‌اند توصیه نمی‌شود.

.SS \fB--annotation\fP=\fIannotation=value\fP
تنظیم یک حاشیه‌نویسی (annotation) بر روی مدخل مربوط به ایمیج یا دست‌ساخته مشخص‌شده.

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

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

.SS \fB--artifact-config\fP=\fIpath\fP
هنگام ایجاد یک مانیفست دست‌ساخته و افزودن آن به نمایه ایمیج، از محتویات فایل مشخص‌شده به عنوان حباب داده (blob) پیکربندی در مانیفست دست‌ساخته استفاده می‌کند. در بیشتر سناریوها، دست‌نخورده باقی گذاشتن مقدار پیش‌فرض که نشان‌دهنده یک پیکربندی خالی است، گزینه ترجیحی می‌باشد.

.SS \fB--artifact-config-type\fP=\fItype\fP
هنگام ایجاد یک مانیفست دست‌ساخته و افزودن آن به نمایه ایمیج، از نوع MIME مشخص‌شده به عنوان \fBmediaType\fR مرتبط با حباب پیکربندی در مانیفست دست‌ساخته استفاده می‌کند. در بیشتر سناریوها، دست‌نخورده باقی گذاشتن مقدار پیش‌فرض که نشان‌دهنده یک پیکربندی خالی یا نوع پیکربندی استاندارد OCI است، گزینه ترجیحی می‌باشد.

.SS \fB--artifact-exclude-titles\fP
هنگام ایجاد یک مانیفست دست‌ساخته و افزودن آن به نمایه ایمیج، حاشیه‌نویسی "org.opencontainers.image.title" را برای هر فایل اضافه‌شده به مانیفست دست‌ساخته برابر با نام پایه فایل تنظیم نمی‌کند. ابزارهایی که دست‌ساخته‌ها را از رجیستری بازیابی می‌کنند ممکن است از این مقادیر برای نام‌گذاری فایل‌ها هنگام ذخیره دست‌ساخته‌ها بر روی دیسک استفاده کنند، بنابراین استفاده از این گزینه توصیه نمی‌شود مگر اینکه برای سازگاری با یک رجیستری خاص لازم باشد.

.SS \fB--artifact-layer-type\fP=\fItype\fP
هنگام ایجاد یک مانیفست دست‌ساخته و افزودن آن به نمایه ایمیج، از نوع MIME مشخص‌شده به عنوان \fBmediaType\fR مرتبط با محتویات فایل‌ها استفاده می‌کند. در صورت عدم تعیین، حدس‌هایی بر اساس نام فایل‌ها یا محتویات آن‌ها زده شده و استفاده می‌شود، اما در صورت نیاز به قطعیت باید این گزینه مشخص شود.

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

.SS \fB--artifact-type\fP=\fItype\fP
هنگام ایجاد یک مانیفست دست‌ساخته، از نوع MIME مشخص‌شده به جای مقدار پیش‌فرض که اطلاعات کمتری دارد، به عنوان مقدار \fBartifactType\fR مانیفست استفاده می‌کند.

.SS \fB--authfile\fP=\fIpath\fP
مسیر فایل احراز هویت. مقدار پیش‌فرض در لینوکس \fB${XDG_RUNTIME_DIR}/containers/auth.json\fR و در ویندوز/مک‌او‌اس \fB$HOME/.config/containers/auth.json\fR است.
این فایل توسط \fBpodman login\fP ایجاد می‌شود. اگر وضعیت احراز هویت در آنجا یافت نشود، مسیر \fB$HOME/.docker/config.json\fR که با استفاده از \fBdocker login\fP تنظیم می‌شود بررسی خواهد شد.

.PP
نکته: همچنین این امکان وجود دارد که با تنظیم متغیر محیطی \fBREGISTRY_AUTH_FILE\fR، مسیر پیش‌فرض فایل احراز هویت را بازنویسی کنید. این کار با دستور \fBexport REGISTRY_AUTH_FILE=\fIpath\fP\fP انجام‌پذیر است.

.SS \fB--cert-dir\fP=\fIpath\fP
استفاده از گواهی‌های موجود در مسیر \fIpath\fP با پسوندهای (*\&.crt, *\&.cert, *\&.key) برای اتصال به رجیستری (پیش‌فرض: /etc/containers/certs.d).
برای جزئیات بیشتر به \fBcontainers-certs.d(5)\fP مراجعه کنید.
(این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--creds\fP=\fI[username[:password]]\fP
مقدار [username[:password]] برای احراز هویت در برابر رجیستری در صورت نیاز.
اگر یک یا هر دو مقدار ارائه نشوند، اعلانی در خط فرمان ظاهر شده و می‌توان مقدار را وارد کرد. گذرواژه بدون بازتاب وارد می‌شود.

.PP
توجه داشته باشید که اطلاعات اعتباری مشخص‌شده فقط برای احراز هویت در برابر رجیستری‌های هدف استفاده می‌شوند. آن‌ها برای سرورهای آینه‌ای یا زمانی که رجیستری بازنویسی می‌شود (به \fBcontainers-registries.conf(5)\fR مراجعه کنید) استفاده نخواهند شد؛ برای احراز هویت در برابر آن‌ها استفاده از فایل \fBcontainers-auth.json(5)\fR را در نظر بگیرید.

.SS \fB--features\fP=\fIfeature\fP
مشخص کردن فهرست ویژگی‌هایی که فهرست یا نمایه به عنوان نیازمندی‌های ایمیج ثبت می‌کند. این گزینه به‌ندرت استفاده می‌شود.

.SS \fB--os\fP=\fIOS\fP
بازنویسی سیستم‌عاملی که فهرست یا نمایه به عنوان یک نیازمندی برای ایمیج ثبت می‌کند.
اگر \fIimagename\fP به یک فهرست مانیفست یا نمایه ایمیج ارجاع دهد، اطلاعات سیستم‌عامل از آن بازیابی می‌شود؛ در غیر این صورت، از اطلاعات پیکربندی ایمیج استخراج خواهد شد.

.SS \fB--os-version\fP=\fIversion\fP
مشخص کردن نسخه سیستم‌عاملی که فهرست یا نمایه به عنوان نیازمندی برای ایمیج ثبت می‌کند. این گزینه به‌ندرت استفاده می‌شود.

.SS \fB--tls-verify\fP
الزام HTTPS و اعتبارسنجی گواهی‌ها هنگام برقراری ارتباط با رجیستری‌ها (پیش‌فرض: \fBtrue\fP).
اگر صراحتاً روی \fBtrue\fP تنظیم شود، اعتبارسنجی TLS انجام می‌شود.
اگر روی \fBfalse\fP تنظیم شود، اعتبارسنجی TLS انجام نمی‌شود.
در صورت عدم تعیین، اعتبارسنجی TLS انجام خواهد شد مگر اینکه رجیستری هدف در \fBcontainers-registries.conf(5)\fP به عنوان یک رجیستری ناامن فهرست شده باشد.

.SS \fB--variant\fP
مشخص کردن گونه‌ای (variant) که فهرست یا نمایه برای ایمیج ثبت می‌کند. این گزینه معمولاً برای تمایز میان چندین مدخل استفاده می‌شود که مقدار معماری یکسانی دارند، اما به نسخه‌های متفاوتی از مجموعه دستورالعمل‌های آن وابسته هستند.

.SH "روش‌های انتقال (TRANSPORT)"
روش‌های انتقال متعددی پشتیبانی می‌شوند:

.PP
\fBdocker://\fP\fIdocker-reference\fP \fI(پیش‌فرض)\fP
یک ایمیج در رجیستری که "Docker Registry HTTP API V2" را پیاده‌سازی می‌کند. به‌طور پیش‌فرض از وضعیت احراز هویت در \fB$XDG_RUNTIME_DIR/containers/auth.json\fR استفاده می‌کند که با دستور \fB(podman login)\fR تنظیم می‌شود. اگر وضعیت مجوز در آنجا یافت نشود، فایل \fB$HOME/.docker/config.json\fR که با دستور \fB(docker login)\fR تنظیم می‌شود، بررسی خواهد شد.

.EX
$ podman manifest add mylist:v1.11 docker://quay.io/username/myimage
.EE

.PP
\fBcontainers-storage:\fP\fIoci-reference\fP
یک ایمیج با قالب \fIoci-reference\fP که در فضای ذخیره‌سازی محلی کانتینر ذخیره شده است. \fIoci-reference\fP باید شامل یک برچسب (tag) باشد.

.EX
$ podman manifest add mylist:v1.11 containers-storage:quay.io/username/myimage
.EE

.PP
\fBdir:\fP\fIpath\fP
یک مسیر دایرکتوری محلی موجود \fIpath\fP که مانیفست، فایل‌های فشرده لایه‌ها (layer tarballs) و امضاها را به‌صورت فایل‌های جداگانه ذخیره می‌کند. این یک قالب غیراستاندارد است که اصولاً برای اشکال‌زدایی یا بررسی غیرمخرب کانتینر کاربرد دارد.

.EX
$ podman manifest add dir:/tmp/myimage
.EE

.PP
\fBdocker-archive:\fP\fIpath\fP[\fB:\fP\fIdocker-reference\fP]
یک ایمیج که در یک فایل با قالب \fBdocker save\fR ذخیره شده است. مقدار \fIdocker-reference\fP تنها هنگام ساخت چنین فایلی استفاده می‌شود و نباید شامل دایجست باشد.

.EX
$ podman manifest add docker-archive:/tmp/myimage
.EE

.PP
\fBdocker-daemon:\fP\fIdocker-reference\fP
یک ایمیج با قالب \fIdocker-reference\fP که در ذخیره‌ساز داخلی دیمن داکر نگهداری می‌شود. مقدار \fIdocker-reference\fP همچنین می‌تواند شناسه ایمیج باشد (docker-daemon:algo:digest).

.EX
$ sudo podman manifest add docker-daemon:docker.io/library/myimage:33
.EE

.PP
\fBoci-archive:\fP\fIpath\fP\fB:\fP\fItag\fP
یک برچسب (\fItag\fP) ایمیج در دایرکتوری منطبق با "مشخصات ساختار ایمیج کانتینر باز" (Open Container Image Layout Specification) در مسیر \fIpath\fP.

.EX
$ podman manifest add oci-archive:/tmp/myimage
.EE

.SH "مثال‌ها (EXAMPLES)"
افزودن ایمیج پیش‌فرض مشخص‌شده از فهرست مانیفست مبدأ به فهرست مانیفست مقصد:

.EX
podman manifest add mylist:v1.11 docker://fedora
71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
.EE

.PP
افزودن تمام ایمیج‌ها از فهرست مانیفست مبدأ به فهرست مانیفست مقصد:

.EX
podman manifest add --all mylist:v1.11 docker://fedora
71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
.EE

.PP
افزودن ایمیج انتخاب‌شده منطبق با معماری و گونه از فهرست مانیفست مبدأ به فهرست مانیفست مقصد:

.EX
podman manifest add --arch arm64 --variant v8 mylist:v1.11 docker://71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-manifest(1)\fP