.nh
.TH podman-container-runlabel 1
.SH "نام (NAME)"
podman-container-runlabel \- اجرای یک دستور بر اساس برچسب ایمیج کانتینر

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman container runlabel\fP [\fIoptions\fP] \fIlabel\fP \fIimage\fP [\fIarg...\fP]

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman container runlabel\fP برچسب (\fBlabel\fR) مشخص‌شده از \fBایمیج\fR را می‌خواند و آن را به عنوان یک دستور روی میزبان اجرا می‌کند\&. اگر برچسب وجود نداشته باشد، پودمن با خطا خارج می‌شود\&. آرگومان‌های اضافی به انتهای دستور ضمیمه می‌شوند\&.

.PP
از گذشته، ایمیج‌های کانتینر محتویات (مانند لایه‌ها) و نحوه اجرای کانتینر توسط یک زمان اجرای کانتینر (مانند crun(1) یا runc(1)) را توصیف می‌کنند\&. به عنوان مثال، یک ایمیج ممکن است متغیرهای محیطی و دستور را در پیکربندی خود تعیین کند\&. با این حال، یک ایمیج کانتینر نمی‌تواند مستقیماً مشخص کند که یک موتور کانتینر مانند پودمن چگونه باید آن را اجرا کند\&. برای نمونه، پیکربندی یک ایمیج شامل اطلاعاتی درباره راه‌اندازهای گزارش‌گیری (log drivers)، فضاهای نام (namespaces)، یا قابلیت‌هایی (capabilities) که برای اجرای صحیح نیاز دارد، نمی‌شود\&.

.PP
دستور \fBpodman container runlabel\fR این محدودیت ایمیج‌های کانتینر را به روشی ساده و در عین حال کارآمد برطرف می‌کند\&. پودمن محتویات برچسب را می‌خواند و آن را به عنوان دستوری که روی میزبان اجرا می‌شود تفسیر می‌کند\&. به این ترتیب یک ایمیج می‌تواند دقیقاً نحوه اجرای خود توسط پودمن را توصیف کند\&. برای مثال، یک برچسب با محتوای \fB/usr/bin/podman run -d --pid=host --privileged \\${IMAGE}\fR به ایمیج دستور می‌دهد در یک کانتینر جداشده (detached) و دارای امتیاز ویژه (privileged) که از فضای نام PID میزبان استفاده می‌کند اجرا شود\&. این امر توصیف خود ایمیج کانتینر را از «چه چیزی» به «چگونه» ارتقا می‌دهد\&.

.PP
توجه داشته باشید که دستور \fBrunlabel\fR منحصراً برای اجرا در محیط‌های مورد اعتماد در نظر گرفته شده است\&. استفاده از این دستور روی ایمیج‌های غیرقابل اعتماد توصیه نمی‌شود\&.

.SH "متغیرها (VARIABLES)"
محتویات یک برچسب ممکن است به متغیرهای زیر ارجاع دهد که در حین پردازش برچسب جایگزین می‌شوند\&.

.PP
\fBIMAGE\fP
نام ایمیج\&. هنگام اجرای \fBpodman container runlabel label fedora\fR متغیر \fBIMAGE\fR با \fBfedora\fR جایگزین می‌شود\&. قالب‌های معتبر عبارتند از \fBIMAGE\fR، \fB$IMAGE\fR، \fB${IMAGE}\fR و \fB=IMAGE\fR\&.

.PP
\fBNAME\fP
همان‌طور که توسط گزینه \fB--name\fR مشخص شده است\&. قالب آن مشابه ویژگی IMAGE است\&.

.PP
\fBPWD\fP
با دایرکتوری کاری فعلی جایگزین خواهد شد\&.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--authfile\fP=\fIpath\fP
مسیر فایل احراز هویت\&. پیش‌فرض در لینوکس \fB${XDG_RUNTIME_DIR}/containers/auth.json\fR و در Windows/macOS برابر با \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 \fB--cert-dir\fP=\fIpath\fP
استفاده از گواهی‌های موجود در \fIpath\fP (*\&.crt, *\&.cert, *\&.key) برای اتصال به مخزن (رجیستری)\&. (پیش‌فرض: /etc/containers/certs.d)
برای جزئیات، \fBcontainers-certs.d(5)\fP را ببینید\&.
(این گزینه در کلاینت ریموت پودمن، از جمله ماشین‌های Mac و Windows (به‌استثنای WSL2) در دسترس نیست)

.SS \fB--creds\fP=\fI[username[:password]]\fP
مقدار [username[:password]] برای استفاده در احراز هویت با رجیستری، در صورت لزوم\&.
اگر یک یا هر دو مقدار ارائه نشوند، اعلان خط فرمان ظاهر می‌شود و می‌توان مقدار را وارد کرد\&. رمز عبور بدون بازتاب وارد می‌شود\&.

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

.SS \fB--display\fP
نمایش مقدار برچسب ایمیج پس از پر شدن متغیرهای محیطی آن\&. در صورت تعیین --display، دستور runlabel اجرا نمی‌شود\&.

.SS \fB--help\fP, \fB-h\fP
چاپ راهنمای استفاده

.SS \fB--name\fP, \fB-n\fP=\fIname\fP
استفاده از این نام برای ایجاد محتوا برای کانتینر\&. در صورت عدم تعیین، نام به‌طور پیش‌فرض به نام ایمیج تنظیم می‌شود\&.

.SS \fB--quiet\fP, \fB-q\fP
سرکوب اطلاعات خروجی هنگام دریافت (pull) ایمیج‌ها

.SS \fB--replace\fP
اگر کانتینری با نام فعلی وجود داشته باشد، متوقف و حذف می‌شود و کانتینر جدیدی از این ایمیج ایجاد می‌گردد\&.

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

.SH "مثال‌ها (EXAMPLES)"
اجرای برچسب \fBrun\fR از یک ایمیج به نام foobar.

.EX
$ podman container runlabel run foobar
.EE

.PP
اجرای برچسب \fBinstall\fR از ایمیج foobar با آرگومان‌های اضافی.

.EX
$ podman container runlabel install foobar apples oranges
.EE

.PP
نمایش محتویات برچسب \fBrun\fR از ایمیج foobar.

.EX
$ podman container runlabel --display run foobar
.EE

.PP
اجرای مجدد یک کانتینر با استفاده از برچسبی که نام ثابتی برای کانتینر تعیین می‌کند. پرچم --replace اطمینان حاصل می‌کند که هر کانتینر موجود ابتدا حذف شود.

.EX
$ podman ps -a
CONTAINER ID  IMAGE                             COMMAND               CREATED         STATUS                     PORTS       NAMES
1254c038d892  docker.io/library/busybox:latest  echo Hello from r...  26 seconds ago  Exited (0) 26 seconds ago              test-runlabel

$ podman container runlabel --replace RUN runlabel-test
Hello from runlabel

$ podman ps -a
CONTAINER ID  IMAGE                             COMMAND               CREATED        STATUS                    PORTS       NAMES
28efd9600d0c  docker.io/library/busybox:latest  echo Hello from r...  4 seconds ago  Exited (0) 4 seconds ago              test-runlabel

.EE

.PP
این دستور زمانی مفید است که برچسب از یک نام ثابت (مانند \fB--name mycontainer\fR) استفاده می‌کند و شما می‌خواهید آن را بارها بدون حذف دستی کانتینر قبلی اجرا نمایید.

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBcrun(1)\fP, \fBrunc(8)\fP, \fBcontainers-certs.d(5)\fP, \fBcontainers-auth.json(5)\fP, \fBcontainers-registries.conf(5)\fP

.SH "تاریخچه (HISTORY)"
اوت ۲۰۲۱، اصلاحات توسط Valentin Rothberg (rothberg at redhat dot com)

.PP
سپتامبر ۲۰۱۸، در ابتدا توسط Brent Baude (bbaude at redhat dot com) گردآوری شد