| podman-quadlet-install(1) | General Commands Manual | podman-quadlet-install(1) |
نام (NAME)
podman-quadlet-install - نصب یک فایل کوادلت (quadlet) یا یک برنامه کوادلت
خلاصه دستور (SYNOPSIS)
podman quadlet install [گزینه‌ها] quadlet-path-or-url [files-path-or-url]...
توضیحات (DESCRIPTION)
یک فایل کوادلت (Quadlet) یا یک برنامه (که ممکن است شامل چندین فایل کوادلت باشد) را برای کاربر جاری نصب می‌کند. می‌توانید فایل‌های کوادلت را به صورت فایل‌های محلی یا نشانی‌های اینترنتی (URLs) مشخص کنید.
این دستور به شما امکان می‌دهد تا:
- یک فایل کوادلت منفرد را نصب کنید که می‌تواند اختیاری همراه با فایل‌های غیرکوادلت اضافی باشد.
- یک دایرکتوری حاوی چندین فایل کوادلت و سایر فایل‌های غیرکوادلت را برای نصب مشخص کنید (برای مثال یک فایل پیکربندی برای یک کانتینر کوادلت).
- چندین کوادلت را از یک فایل واحد با پسوند .quadlets نصب کنید، که در آن هر کوادلت با جداکننده --- تفکیک شده است. هنگام استفاده از چندین کوادلت در یک فایل .quadlets واحد، هر بخش کوادلت باید شامل یک کامنت # FileName=<name> باشد تا نام آن کوادلت مشخص شود.
نکته: یک برنامه مجموعه‌ای از فایل‌ها (کوادلت و غیرکوادلت) است که باید در کنار یکدیگر قرار گیرند. به همین ترتیب، حذف یک کوادلت که بخشی از یک برنامه است، کل برنامه را حذف خواهد کرد. هنگامی که یک کوادلت از یک دایرکتوری نصب می‌شود، تمام فایل‌های نصب‌شده از آن دایرکتوری — شامل هر دو فایل کوادلت و غیرکوادلت — به عنوان بخشی از یک برنامه واحد در نظر گرفته می‌شوند.
نکته: هنگامی که چندین کوادلت از یک فایل واحد با پسوند .quadlets نصب می‌شوند، تنها در صورتی بخشی از یک برنامه واحد در نظر گرفته می‌شوند که نام برنامه با استفاده از گزینه --application مشخص شده باشد.
گزینه‌ها (OPTIONS)
--application=string
می‌توانید یک نام برای برنامه مشخص کنید؛ در این صورت تمام فایل‌ها در دایرکتوری با همان نام برنامه نصب خواهند شد. هنگام مشخص کردن مسیر یک دایرکتوری، تعیین نام برنامه الزامی است. نام برنامه نمی‌تواند پسوند کوادلت داشته باشد؛ برای مثال foo.container یک نام معتبر برای برنامه نیست.
--reload-systemd
بارگذاری مجدد systemd پس از اتمام عملیات (پیش‌فرض true است). برای غیرفعال کردن آن، کاربران باید مقدار این فلگ را به صورت دستی روی false تنظیم کنند.
--replace, -r
جایگزینی نصب کوادلت حتی اگر فایل یونیت تولیدشده از قبل وجود داشته باشد (پیش‌فرض false است). برای فعال کردن آن، کاربران باید مقدار این فلگ را به صورت دستی روی true تنظیم کنند. این فلگ در درجه اول برای به‌روزرسانی یک یونیت موجود استفاده می‌شود.
مثال‌ها (EXAMPLES)
نصب کوادلت از یک فایل:
$ podman quadlet install test-service-quadlet.container /home/user/.config/containers/systemd/test-service-quadlet.container
نصب کوادلت از یک دایرکتوری:
$ 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
نصب کوادلت از یک نشانی وب:
$ podman quadlet install https://github.com/containers/podman/blob/main/test/e2e/quadlet/basic.container /home/user/.config/containers/systemd/basic.container
نصب چندین کوادلت از یک فایل تک با پسوند .quadlets:
$ 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
نکته: قابلیت چندکوادلتی به پسوند فایل .quadlets نیاز دارد. فایل‌هایی با سایر پسوندها تنها به عنوان کوادلت‌های منفرد یا فایل‌های دارایی (asset) پردازش خواهند شد.