.nh
.TH podman-artifact-add 1
.SH "نام (NAME)"
podman-artifact-add \- افزودن یک آرتیفکت OCI به انبار محلی آرتیفکت‌ها

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman artifact add\fP [\fIoptions\fP] \fIartifact-name\fP \fIfile\fP [\fIfile\fP ...]

.SH "توضیحات (DESCRIPTION)"
افزودن یک آرتیفکت OCI از سیستم‌فایل محلی به انبار محلی. برای ایجاد آرتیفکت باید حداقل یک فایل ارائه دهید، اما چندین فایل را نیز می‌توان اضافه کرد.

.PP
آرتیفکت‌ها به‌طور خودکار یک برچسب زمان ایجاد در حاشیه‌نویسی (annotation)
\fBorg.opencontainers.image.created\fR
با استفاده از قالب RFC3339Nano درج می‌کنند. در صورت استفاده از گزینه
\fB--append\fR،
برچسب زمان ایجاد اصلی حفظ می‌شود.

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

.PP
توجه: حاشیه‌نویسی‌ها را برای هر فایلی که اضافه می‌شود تنظیم کنید. حاشیه‌نویسی "org.opencontainers.image.title" برای نام‌گذاری لایه هنگام مانت شدن در یک کانتینر استفاده می‌شود؛ این عنوان باید برای هر لایه آرتیفکت یکتا باشد.

.SS \fB--append\fP, \fB-a\fP
الحاق فایل‌ها به یک آرتیفکت موجود. این گزینه نمی‌تواند همزمان با گزینه \fB--type\fP استفاده شود.

.SS \fB--file-type\fP
تنظیم نوع رسانه (media type) فایل آرتیفکت به جای واگذاری تشخیص خودکار نوع به سیستم.

.SS \fB--replace\fP
اگر آرتیفکتی با همان نام از قبل وجود داشته باشد، آن را جایگزین و حذف می‌کند. مقدار پیش‌فرض \fBfalse\fP است.
این گزینه نمی‌تواند همراه با گزینه \fB--append\fP استفاده شود.

.SS \fB--type\fP
تنظیم نوع برای آرتیفکتی که اضافه می‌شود.

.SH "مثال‌ها (EXAMPLES)"
افزودن یک فایل تکی به یک آرتیفکت

.EX
$ podman artifact add quay.io/myartifact/myml:latest /tmp/foobar.ml
0fe1488ecdef8cc4093e11a55bc048d9fc3e13a4ba846efd24b5a715006c95b3
.EE

.PP
افزودن آرتیفکت OCI به انبار با مشخص کردن نوع:

.EX
$ podman artifact add --artifact-type application/com.example.ai --file-type application/vnd.gguf quay.io/myimage/myartifact:latest /home/user/model.gguf
.EE

.PP
جایگزینی یک آرتیفکت موجود با همان نام

.EX
$ podman artifact add quay.io/myartifact/myml:latest /tmp/foobar.ml
0fe1488ecdef8cc4093e11a55bc048d9fc3e13a4ba846efd24b5a715006c95b3
.EE

.PP
افزودن چندین فایل به یک آرتیفکت

.EX
$ podman artifact add quay.io/myartifact/myml:latest /tmp/foobar1.ml /tmp/foobar2.ml
1487acae11b5a30948c50762882036b41ac91a7b9514be8012d98015c95ddb78
.EE

.PP
افزودن فایل‌ها به یک آرتیفکت OCI موجود

.EX
$ podman artifact add --append quay.io/myimage/myartifact:latest /home/user/config.yaml
.EE

.PP
ایجاد آرتیفکت با جایگزینی عنوان لایه، و سپس مانت کردن در یک کانتینر.

.EX
podman artifact add --annotation org.opencontainers.image.title=smollm2 quay.io/myreg/smollm2:latest blobs/sha256-4d2396b16114669389d7555c15a1592aad584750310f648edad5ca8c4eccda17
podman run --mount type=artifact,source=quay.io/myreg/smollm2:latest,destination=/mnt fedora ls -l /mnt
smollm2
.EE

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

.SH "تاریخچه (HISTORY)"
ژانویه ۲۰۲۵، در ابتدا توسط برنت بود (Brent Baude bbaude@redhat.com) گردآوری شد
\[la]mailto:bbaude@redhat.com\[ra]