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

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


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


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

.PP
به‌طور پیش‌فرض، حجم Podman هم‌نام با واحد (unit) خواهد بود اما با پیشوند \fBsystemd-\fR؛ یعنی برای یک فایل حجم با نام \fB$NAME.volume\fR، حجم ایجادشده‌ی Podman با نام \fBsystemd-$NAME\fR و فایل سرویس ایجادشده با نام \fB$NAME-volume.service\fR نام‌گذاری می‌شود. گزینه \fBVolumeName\fR اجازه می‌دهد این نام پیش‌فرض با یک نام ارائه‌شده توسط کاربر بازنویسی شود.

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


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


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

.TS
allbox;
l l 
l l .
\fBگزینه‌های [Volume]\fP	\fBمعادل در podman volume create\fP
ContainersConfModule=/etc/nvd\&.conf	--module=/etc/nvd\&.conf
Copy=true	--opt copy
Device=tmpfs	--opt device=tmpfs
Driver=image	--driver=image
GlobalArgs=--log-level=debug	--log-level=debug
Group=192	--opt group=192
Image=quay.io/centos/centos:latest	T{
--opt image=quay.io/centos/centos:latest
T}
Label="foo=bar"	--label "foo=bar"
Options=XYZ	--opt "o=XYZ"
PodmanArgs=--driver=image	--driver=image
Type=type	نوع فایل‌سیستم Device
User=123	--opt uid=123
VolumeName=foo	podman volume create foo
.TE

.PP
کلیدهای پشتیبانی‌شده در بخش \fB[Volume]\fR عبارتند از:

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

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

.SS \fBCopy=bool\fR (پیش‌فرض: \fBtrue\fR)
در صورت فعال بودن، محتوای ایمیج واقع در نقطه اتصال (mount point) حجم در اولین اجرا درون حجم کپی می‌شود.

.SS \fBDevice=\fR
مسیر دستگاهی (device) که برای حجم متصل (mount) می‌شود.

.SS \fBDriver=\fR
نام درایور حجم را مشخص می‌کند. در صورت تنظیم روی \fBimage\fR، کلید \fBImage\fR نیز باید مشخص شود.

.PP
این معادل گزینه \fB--driver\fR در Podman است.

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

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

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

.SS \fBGroup=\fR
شناسه عددی گروه (GID) یا نام گروه روی میزبان برای استفاده به‌عنوان گروه حجم.

.SS \fBImage=\fR
هنگامی که \fBDriver\fR روی \fBimage\fR تنظیم شده باشد، ایمیجی را که حجم بر پایه آن است مشخص می‌کند.
توصیه می‌شود به دلایل کارایی و پایداری، به‌جای نام کوتاه از نام کامل و معتبر ایمیج (fully qualified image name) استفاده شود.

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

.PP
حالت خاص:
.IP \(bu 2
اگر \fBname\fR ایمیج با \fB\&.image\fR خاتمه یابد، Quadlet از ایمیجی استفاده خواهد کرد که توسط فایل \fB\&.image\fR متناظر دریافت (pull) شده است و سرویس systemd ایجادشده حاوی یک وابستگی به \fB$name-image.service\fR (یا نام سرویس تنظیم‌شده در فایل .image) خواهد بود. توجه: فایل \fB\&.image\fR متناظر باید وجود داشته باشد.

.SS \fBLabel=\fR
یک یا چند برچسب (label) OCI روی حجم تنظیم می‌کند. قالب آن به‌صورت فهرستی از موارد \fBkey=value\fR مشابه با \fBEnvironment\fR است.

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

.SS \fBOptions=\fR
گزینه‌های اتصال (mount) مورد استفاده برای یک فایل‌سیستم، همانند گزینه \fB-o\fR در دستور \fBmount(8)\fP.

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

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

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

.SS \fBType=\fR
نوع فایل‌سیستم \fBDevice\fR همانند گزینه \fB-t\fR در دستور \fBmount(8)\fP.

.SS \fBUser=\fR
شناسه عددی کاربر (UID) یا نام کاربر روی میزبان برای استفاده به‌عنوان مالک حجم.

.SS \fBVolumeName=\fR
نام (اختیاری) حجم Podman.
در صورت عدم تعیین، مقدار پیش‌فرض هم‌نام با واحد اما با پیشوند \fBsystemd-\fR خواهد بود؛ یعنی یک فایل \fB$name.volume\fR یک حجم Podman به نام \fBsystemd-$name\fR ایجاد می‌کند تا از تداخل با حجم‌های مدیریت‌شده توسط کاربر جلوگیری شود.


.SH "مثال‌ها (EXAMPLES)"
واحد حجم کمینه:

.EX
[Volume]
VolumeName=mydata
Label=app=data
User=1000
Group=1000
.EE

.PP
واحد حجم مبتنی بر ایمیج:

.EX
[Volume]
VolumeName=html
Driver=image
Image=quay.io/centos/centos:latest
Copy=true
.EE


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