'\" t
.nh
.TH podman-image.unit 5

.SH "نام (NAME)"
podman-image.unit \- فایل‌های واحد systemd برای مدیریت دریافت ایمیج‌های کانتینر با استفاده از Podman Quadlet


.SH "خلاصه دستور (SYNOPSIS)"
\fIname\fP\&.image


.SH "توضیحات (DESCRIPTION)"
فایل‌های ایمیج با پسوند \fB\&.image\fR نام‌گذاری می‌شوند و شامل بخش \fB[Image]\fR هستند که دستور دریافت (pull) ایمیج کانتینر را توصیف می‌کند. سرویس ایجادشده یک دستور یک‌باره است که از وجود ایمیج روی میزبان اطمینان حاصل کرده و در صورت نیاز آن را دریافت می‌کند.

.PP
استفاده از واحدهای ایمیج به کانتینرها و حجم‌ها اجازه می‌دهد به ایمیج‌هایی که به‌طور خودکار دریافت شده‌اند وابسته باشند. این موضوع به‌ویژه هنگام استفاده از گزینه‌های خاص برای کنترل دریافت ایمیج جالب توجه است.


.SH "خلاصه کاربرد (USAGE SUMMARY)"
فایل \fB\&.image\fR هنگام بوت یا بارگذاری مجدد توسط \fBpodman-system-generator\fR پردازش شده و یک \fB\&.service\fR در systemd ایجاد می‌کند که دستور \fBpodman image pull\fR را اجرا می‌نماید.

.PP
یک فایل \fB\&.image\fR می‌تواند در گزینه \fBImage=\fR فایل \fB\&.container\fR ارجاع داده شود.


.SH "گزینه‌ها (OPTIONS)"
گزینه‌های معتبر برای \fB[Image]\fR در زیر فهرست شده‌اند:

.TS
allbox;
l l 
l l .
\fBگزینه‌های [Image]\fP	\fBمعادل در podman image pull\fP
AllTags=true	--all-tags
Arch=aarch64	--arch=aarch64
AuthFile=/etc/registry/auth\&.json	--authfile=/etc/registry/auth\&.json
CertDir=/etc/registry/certs	--cert-dir=/etc/registry/certs
ContainersConfModule=/etc/nvd\&.conf	--module=/etc/nvd\&.conf
Creds=myname:mypassword	--creds=myname:mypassword
DecryptionKey=/etc/registry\&.key	--decryption-key=/etc/registry\&.key
GlobalArgs=--log-level=debug	--log-level=debug
Image=quay\&.io/centos/centos:latest	T{
podman image pull quay.io/centos/centos:latest
T}
ImageTag=quay\&.io/centos/centos:latest	از این نام هنگام حل ارجاعات \fB\&.image\fR استفاده می‌شود
OS=windows	--os=windows
PodmanArgs=--os=linux	--os=linux
Policy=always	--policy=always
Retry=5	--retry=5
RetryDelay=10s	--retry-delay=10s
TLSVerify=false	--tls-verify=false
Variant=arm/v7	--variant=arm/v7
.TE

.SS \fBAllTags=true\fR
تمام ایمیج‌های برچسب‌گذاری‌شده در مخزن دریافت می‌شوند.

.PP
*مهم: هنگام استفاده از فلگ all-tags، پادمن روی مخازن جستجو در \fBcontainers-registries.conf(5)\fP پیمایش نمی‌کند، بلکه همیشه از docker.io برای نام‌های کوتاه و غیرکامل ایمیج استفاده می‌نماید.*

.SS \fBArch=ARCH\fR
معماری ایمیج دریافتی را رونویسی (override) می‌کند؛ پیش‌فرض معماری میزبان است. برای مثال، \fBarm\fR\&.
مگر در صورت بازنویسی، جستجوهای بعدی همان ایمیج در فضای ذخیره‌سازی محلی صرف‌نظر از معماری میزبان با این معماری مطابقت خواهند داشت.

.SS \fBAuthFile=path\fR
مسیر فایل احراز هویت. مقدار پیش‌فرض در لینوکس \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 \fBCertDir=path\fR
از گواهی‌های موجود در \fIpath\fP (شامل *\&.crt، *\&.cert، *\&.key) برای اتصال به رجیستری استفاده می‌کند. (پیش‌فرض: /etc/containers/certs.d)
برای جزئیات بیشتر به \fBcontainers-certs.d(5)\fP مراجعه کنید.
(این گزینه در کلاینت راه دور پادمن، شامل ماشین‌های مک و ویندوز (به‌جز WSL2) در دسترس نیست)

.SS \fBContainersConfModule=module\fR
ماژول مشخص‌شده‌ی containers.conf(5) را بارگذاری می‌کند.

.PP
این گزینه می‌تواند چندین بار درج شود.

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

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

.SS \fBDecryptionKey=key[:passphrase]\fR
کلید یا عبارت عبور [key[:passphrase]] که برای رمزگشایی ایمیج‌ها استفاده می‌شود. کلید می‌تواند به کلیدها و/یا گواهی‌ها اشاره کند. رمزگشایی با تمام کلیدها امتحان می‌شود. اگر کلید با یک عبارت عبور محافظت شده باشد، ارسال آن در آرگومان الزامی است و در غیر این صورت حذف می‌شود.

.SS \fBGlobalArgs=\fR
این کلید شامل فهرستی از آرگومان‌ها است که در فایل تولیدشده مستقیماً پس از دستور \fBpodman\fR قرار می‌گیرند. می‌توان از آن برای دسترسی به ویژگی‌هایی از پادمن استفاده کرد که در حالت عادی توسط مولد پشتیبانی نمی‌شوند. از آنجا که مولد از تداخلات و رفتارهای غیرمنتظره احتمالی ناشی از این آرگومان‌ها آگاه نیست، استفاده از این گزینه توصیه نمی‌شود.

.PP
قالب این مقدار فهرستی از آرگومان‌ها است که با فاصله جدا شده‌اند و در صورت تمایل می‌توان تک‌تک آن‌ها را اسکیپ کرد تا شامل فاصله‌ها و سایر نویسه‌های کنترلی شوند.

.PP
این کلید می‌تواند چندین بار درج شود.

.SS \fBImage=\fR
ایمیجی که باید دریافت شود.
توصیه می‌شود به دلایل کارایی و استحکام، به‌جای نام کوتاه از نام کامل و واجد شرایط ایمیج (fully qualified image name) استفاده شود.

.PP
قالب نام همانند زمانی است که به دستور \fBpodman pull\fR داده می‌شود. این کلید از استفاده از \fB:tag\fR یا چکیده‌ها (digests) برای تضمین نسخه مشخصی از ایمیج پشتیبانی می‌کند.

.SS \fBImageTag=\fR
نام کامل و معتبر واقعی ایمیج (FQIN) ارجاع داده شده در \fBImage\fR\&.
تنها زمانی معنادار است که منبع یک فایل یا آرشیو دایرکتوری باشد.

.PP
برای مثال، ایمیجی که با دستور پادمن زیر در یک \fBdocker-archive\fR ذخیره شده است:

.PP
\fBpodman image save --format docker-archive --output /tmp/archive-file.tar quay.io/podman/stable:latest\fR

.PP
نیازمند تنظیم موارد زیر است:
- \fBImage=docker-archive:/tmp/archive-file.tar\fR
- \fBImageTag=quay.io/podman/stable:latest\fR

.SS \fBOS=os\fR
سیستم‌عامل ایمیج دریافتی را بازنویسی می‌کند، پیش‌فرض سیستم‌عامل میزبان است. برای مثال، \fBwindows\fR\&.
مگر در صورت بازنویسی، جستجوهای بعدی همان ایمیج در فضای ذخیره‌سازی محلی صرف‌نظر از سیستم‌عامل میزبان با این سیستم‌عامل مطابقت خواهند داشت.

.SS \fBPodmanArgs=\fR
این کلید شامل فهرستی از آرگومان‌ها است که در فایل تولیدشده مستقیماً به انتهای دستور \fBpodman\fR اضافه می‌شوند. می‌توان از آن برای دسترسی به ویژگی‌هایی از پادمن استفاده کرد که در حالت عادی توسط مولد پشتیبانی نمی‌شوند. از آنجا که مولد از تداخلات و رفتارهای غیرمنتظره احتمالی ناشی از این آرگومان‌ها آگاه نیست، استفاده از این گزینه توصیه نمی‌شود.

.PP
قالب این مقدار فهرستی از آرگومان‌ها است که با فاصله جدا شده‌اند و در صورت تمایل می‌توان تک‌تک آن‌ها را اسکیپ کرد تا شامل فاصله‌ها و سایر نویسه‌های کنترلی شوند.

.PP
این کلید می‌تواند چندین بار درج شود.

.SS \fBPolicy=always\fR
سیاست دریافت ایمیج. مقدار پیش‌فرض \fBalways\fP است.
.IP \(bu 2
\fBalways\fR: همیشه ایمیج را دریافت کن و در صورت ناموفق بودن دریافت، خطا صادر کن.
.IP \(bu 2
\fBmissing\fR: تنها در صورتی ایمیج را دریافت کن که در فضای ذخیره‌سازی محلی کانتینرها یافت نشود. در صورتی که ایمیجی یافت نشد و دریافت با شکست مواجه شد، خطا صادر کن.
.IP \(bu 2
\fBnever\fR: هرگز ایمیج را دریافت نکن؛ تنها از نسخه محلی استفاده کن. اگر ایمیج به‌صورت محلی موجود نبود، خطا صادر کن.
.IP \(bu 2
\fBnewer\fR: در صورتی که ایمیج روی رجیستری جدیدتر از نسخه موجود در فضای ذخیره‌سازی محلی کانتینرها باشد، آن را دریافت کن. یک ایمیج زمانی جدیدتر در نظر گرفته می‌شود که چکیده‌های متفاوتی داشته باشد. مقایسه برچسب‌های زمانی مستعد خطاست. در صورت پیدا شدن یک ایمیج محلی، خطاهای دریافت نادیده گرفته می‌شوند.

.SS \fBRetry=attempts\fR
تعداد دفعات تلاش مجدد برای دریافت یا ارسال ایمیج‌ها بین رجیستری و فضای ذخیره‌سازی محلی در صورت بروز شکست. مقدار پیش‌فرض \fB3\fP است.

.SS \fBRetryDelay=duration\fR
مدت‌زمان تاخیر بین دفعات تلاش مجدد هنگام دریافت یا ارسال ایمیج‌ها بین رجیستری و فضای ذخیره‌سازی محلی در صورت بروز شکست. پیش‌فرض این است که با دو ثانیه شروع شده و سپس تاخیر نمایی (exponential backoff) اعمال شود. زمانی که این مقدار تنظیم شود، همین تاخیر استفاده شده و افزایش نمایی رخ نمی‌دهد.

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

.SS \fBVariant=VARIANT\fR
استفاده از \fIVARIANT\fP به‌جای گونه‌ی پیش‌فرض معماری ایمیج کانتینر. برخی ایمیج‌ها می‌توانند از چندین گونه‌ی مختلف معماری arm مانند arm/v5 و arm/v7 استفاده کنند.


.SH "مثال‌ها (EXAMPLES)"
دریافت پایه‌ای ایمیج:

.EX
[Image]
Image=quay.io/centos/centos:latest
.EE

.PP
دریافت از آرشیو داکر:

.EX
[Image]
Image=docker-archive:/tmp/centos.tar
ImageTag=quay.io/centos/centos:latest
.EE

.PP
دریافت با اطلاعات احراز هویت:

.EX
[Image]
Image=quay.io/private/image:latest
Creds=myuser:mypassword
.EE


.SH "همچنین ببینید (SEE ALSO)"
podman-image-pull(1),
podman-systemd.unit(5),
systemd.unit(5)