.nh
.TH podman-quadlet-install 1
.SH "نام (NAME)"
podman-quadlet-install \- نصب یک فایل کوادلت (quadlet) یا یک برنامه کوادلت

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman quadlet install\fP [\fIگزینه‌ها\fP] \fIquadlet-path-or-url\fP [\fIfiles-path-or-url\fP]...

.SH "توضیحات (DESCRIPTION)"
یک فایل کوادلت (Quadlet) یا یک برنامه (که ممکن است شامل چندین فایل کوادلت باشد) را برای کاربر جاری نصب می‌کند. می‌توانید فایل‌های کوادلت را به صورت فایل‌های محلی یا نشانی‌های اینترنتی (URLs) مشخص کنید.

.PP
این دستور به شما امکان می‌دهد تا:

.IP \(bu 2
یک فایل کوادلت منفرد را نصب کنید که می‌تواند اختیاری همراه با فایل‌های غیرکوادلت اضافی باشد.
.IP \(bu 2
یک دایرکتوری حاوی چندین فایل کوادلت و سایر فایل‌های غیرکوادلت را برای نصب مشخص کنید (برای مثال یک فایل پیکربندی برای یک کانتینر کوادلت).
.IP \(bu 2
چندین کوادلت را از یک فایل واحد با پسوند \fB\&.quadlets\fR نصب کنید، که در آن هر کوادلت با جداکننده \fB---\fR تفکیک شده است. هنگام استفاده از چندین کوادلت در یک فایل \fB\&.quadlets\fR واحد، هر بخش کوادلت باید شامل یک کامنت \fB# FileName=<name>\fR باشد تا نام آن کوادلت مشخص شود.

.PP
\fBنکته:\fR یک برنامه مجموعه‌ای از فایل‌ها (کوادلت و غیرکوادلت) است که باید در کنار یکدیگر قرار گیرند. به همین ترتیب، حذف یک کوادلت که بخشی از یک برنامه است، کل برنامه را حذف خواهد کرد. هنگامی که یک کوادلت از یک دایرکتوری نصب می‌شود، تمام فایل‌های نصب‌شده از آن دایرکتوری — شامل هر دو فایل کوادلت و غیرکوادلت — به عنوان بخشی از یک برنامه واحد در نظر گرفته می‌شوند.

.PP
\fBنکته:\fR هنگامی که چندین کوادلت از یک فایل واحد با پسوند \fB\&.quadlets\fR نصب می‌شوند، تنها در صورتی بخشی از یک برنامه واحد در نظر گرفته می‌شوند که نام برنامه با استفاده از گزینه
.B --application
مشخص شده باشد.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--application\fP=\fIstring\fP
می‌توانید یک نام برای برنامه مشخص کنید؛ در این صورت تمام فایل‌ها در دایرکتوری با همان نام برنامه نصب خواهند شد. هنگام مشخص کردن مسیر یک دایرکتوری، تعیین نام برنامه الزامی است. نام برنامه نمی‌تواند پسوند کوادلت داشته باشد؛ برای مثال \fBfoo.container\fR یک نام معتبر برای برنامه نیست.

.SS \fB--reload-systemd\fP
بارگذاری مجدد systemd پس از اتمام عملیات (پیش‌فرض true است).
برای غیرفعال کردن آن، کاربران باید مقدار این فلگ را به صورت دستی روی
.B false
تنظیم کنند.

.SS \fB--replace\fP, \fB-r\fP
جایگزینی نصب کوادلت حتی اگر فایل یونیت تولیدشده از قبل وجود داشته باشد (پیش‌فرض false است).
برای فعال کردن آن، کاربران باید مقدار این فلگ را به صورت دستی روی
.B true
تنظیم کنند. این فلگ در درجه اول برای به‌روزرسانی یک یونیت موجود استفاده می‌شود.

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

.EX
$ podman quadlet install test-service-quadlet.container
/home/user/.config/containers/systemd/test-service-quadlet.container
.EE

.PP
نصب کوادلت از یک دایرکتوری:

.EX
$ podman quadlet install --application=foo /home/user/work/quadlet-app/
/home/user/.config/containers/systemd/myquadlet1.container
/home/user/.config/containers/systemd/myquadlet2.container
/install/path/myquadlet1.container
/install/path/myquadlet2.container
.EE

.PP
نصب کوادلت از یک نشانی وب:

.EX
$ podman quadlet install https://github.com/containers/podman/blob/main/test/e2e/quadlet/basic.container
/home/user/.config/containers/systemd/basic.container
.EE

.PP
نصب چندین کوادلت از یک فایل تک با پسوند .quadlets:

.EX
$ cat webapp.quadlets
# FileName=web-server
[Container]
Image=nginx:latest
ContainerName=web-server
PublishPort=8080:80
---
# FileName=app-storage
[Volume]
Label=app=webapp
---
# FileName=app-network
[Network]
Subnet=10.0.0.0/24

$ podman quadlet install webapp.quadlets
/home/user/.config/containers/systemd/web-server.container
/home/user/.config/containers/systemd/app-storage.volume
/home/user/.config/containers/systemd/app-network.network
.EE

.PP
\fBنکته:\fR قابلیت چندکوادلتی به پسوند فایل \fB\&.quadlets\fR نیاز دارد. فایل‌هایی با سایر پسوندها تنها به عنوان کوادلت‌های منفرد یا فایل‌های دارایی (asset) پردازش خواهند شد.

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