'\" t
.nh
.TH podman-remote 1
.SH "نام (NAME)"
podman-remote \- واسط خط فرمان راه دور برای پادمن: ابزاری ساده برای مدیریت پادها، کانتینرها و ایمیج‌ها

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman-remote\fP [\fIگزینه‌ها\fP] \fIدستور\fP

.SH "توضیحات (DESCRIPTION)"
پادمن (مدیر پاد یا Pod Manager) یک موتور کانتینری کامل است که به صورت ابزاری ساده و بدون دیمن (daemonless) عمل می‌کند.
پادمن خط فرمانی مشابه Docker-CLI ارائه می‌دهد که مهاجرت از سایر موتورهای کانتینری را آسان کرده و امکان مدیریت پادها، کانتینرها و ایمیج‌ها را فراهم می‌سازد. به بیان ساده: \fBalias docker=podman\fR\&.
بیشتر دستورات پادمن را می‌توان به عنوان یک کاربر عادی و بدون نیاز به دسترسی‌های ویژه اجرا کرد.

.PP
پادمن به صورت داخلی از Buildah(1) برای ساخت ایمیج‌های کانتینر استفاده می‌کند. هر دو ابزار در فضای ذخیره‌سازی ایمیج (و نه کانتینر) مشترک هستند، بنابراین هر یک می‌توانند از ایمیج‌های ساخته‌شده توسط دیگری استفاده کنند یا آن‌ها را تغییر دهند (اما کانتینرها را نه).

.PP
ابزار podman-remote یک کلاینت محلی فراهم می‌کند که از طریق یک API مبتنی بر RESTful درون یک اتصال امن SSH، با یک گره پس‌زمینه پادمن ارتباط برقرار می‌سازد. در این زمینه، یک گره پادمن یک سیستم لینوکسی است که پادمن روی آن نصب شده و سرویس API آن فعال است. اعتبارنامه‌ها برای این نشست را می‌توان با استفاده از فلگ‌ها، متغیرهای محیطی یا در فایل \fBcontainers.conf\fR منتقل کرد.

.PP
فایل \fBcontainers.conf\fR در لینوکس و مک در مسیر \fB$HOME/.config/containers/containers.conf\fR و در ویندوز در مسیر \fB%APPDATA%\\containers\\containers.conf\fR قرار دارد.

.PP
\fBpodman [گزینه‌های عمومی]\fP

.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.SS \fB--connection\fP=\fIname\fP, \fB-c\fP
نام اتصال راه دور.

.PP
در صورت تنظیم بودن، بر متغیر محیطی \fBCONTAINER_CONNECTION\fR تقدم دارد.

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

.SS \fB--identity\fP=\fIpath\fP
مسیر فایل هویت ssh (کلید خصوصی). اگر فایل هویت رمزگذاری شده باشد، پادمن از کاربر می‌خواهد عبارت عبور (passphrase) را وارد کند.
اگر هیچ فایل هویتی ارائه نشود و کاربری مشخص نگردد، پادمن به طور پیش‌فرض از کاربری که دستور پادمن را اجرا می‌کند استفاده خواهد کرد.
پادمن رمز عبور ورود را در سرور راه دور درخواست می‌کند.

.PP
اولویت بررسی و تعیین مقدار هویت:
 - مقدار ارائه‌شده در خط فرمان
 - متغیر محیطی \fBCONTAINER_SSHKEY\fR، در صورتی که \fBCONTAINER_HOST\fR یافت شود
 - فایل \fBcontainers.conf\fR

.SS \fB--log-level\fP=\fIlevel\fP
ثبت پیام‌های بالاتر از سطح مشخص‌شده در لاگ: debug، info، warn، error (پیش‌فرض)، fatal یا panic.

.SS \fB--url\fP=\fIvalue\fP
نشانی وب (URL) برای دسترسی به سرویس پادمن (پیش‌فرض از \fBcontainers.conf\fR، در حالت بدون ریشه "unix:///run/user/$UID/podman/podman.sock" یا به عنوان ریشه "unix:///run/podman/podman.sock").
.IP \(bu 2
متغیر \fBCONTAINER_HOST\fR دارای قالب \fB<schema>://[<user[:<password>]@]<host>[:<port>][<path>]\fR است.
.IP \(bu 2
متغیر \fBCONTAINER_PROXY\fR دارای قالب \fB<socks5|socks5h>://[<user[:<password>]@]<host>[:<port>]\fR است.

.PP
جزئیات:
 - پارامتر \fBschema\fR یکی از موارد زیر است:
   * \fBssh\fR (پیش‌فرض): یک سوکت یونیکس محلی unix(7) روی \fBhost\fR و \fBport\fR مشخص‌شده، قابل دسترسی از طریق SSH
   * \fBtcp\fR: یک اتصال TCP رمزنگاری‌نشده و بدون احراز هویت به \fBhost\fR و \fBport\fR مشخص‌شده؛ در صورت تنظیم \fBCONTAINER_PROXY\fR می‌تواند با پروکسی کار کند
   * \fBunix\fR: یک سوکت یونیکس محلی unix(7) در \fBpath\fR مشخص‌شده، یا پیش‌فرض برای کاربر
 - مقدار \fBuser\fR به طور پیش‌فرض \fBroot\fR یا کاربر جاری اجراکننده است (فقط در \fBssh\fR)
 - مقدار \fBpassword\fR هیچ پیش‌فرضی ندارد (فقط در \fBssh\fR)
 - مقدار \fBhost\fR باید مشخص شود و آی‌پی (IP) یا نام میزبانی است که سرویس پادمن روی آن قرار دارد (\fBssh\fR و \fBtcp\fR)
 - مقدار \fBport\fR به طور پیش‌فرض 22 است (\fBssh\fR و \fBtcp\fR)
 - مقدار \fBpath\fR به طور پیش‌فرض \fB/run/podman/podman.sock\fR است، یا در حالت بدون ریشه \fB/run/user/$UID/podman/podman.sock\fR (\fBunix\fR)، یا باید صریحاً مشخص شود (\fBssh\fR)
 - متغیر \fBCONTAINER_PROXY\fR: استفاده از پروکسی (\fBsocks5\fR یا \fBsocks5h\fR) برای دسترسی به سرویس پادمن (فقط در \fBtcp\fR)

.PP
اولویت بررسی و تعیین مقدار URL:
 - مقدار ارائه‌شده در خط فرمان
 - متغیر محیطی \fBCONTAINER_HOST\fR
 - جدول \fBengine.service_destinations\fR در containers.conf، به استثنای دایرکتوری /usr/share/containers
 - سوکت \fBunix:///run/podman/podman.sock\fR

.PP
اتصالات راه دور برای مقادیر پیش‌فرض از containers.conf محلی استفاده می‌کنند.

.PP
چند نمونه از مقادیر معتبر URL:
 - unix:///run/podman/podman.sock
 - unix:///run/user/$UID/podman/podman.sock
 - ssh://notroot@localhost:22/run/user/$UID/podman/podman.sock
 - ssh://root@localhost:22/run/podman/podman.sock
 - tcp://localhost:34451
 - tcp://127.0.0.1:34451

.SS \fB--version\fP
نمایش نسخه برنامه.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
پادمن می‌تواند متغیرهای محیطی را از جدول env در بخش [engine] در containers.conf تنظیم کند. این متغیرها را می‌توان با ارسال متغیرهای محیطی پیش از دستورات \fBpodman\fR بازنویسی کرد.

.SS \fBCONTAINERS_CONF\fP
تنظیم مسیرهای پیش‌فرض فایل containers.conf.

.SS \fBCONTAINER_CONNECTION\fP
تنظیم مقدار پیش‌فرض \fB--connection\fR برای دسترسی به سرویس پادمن.

.SS \fBCONTAINER_HOST\fP
تنظیم مقدار پیش‌فرض \fB--url\fR برای دسترسی به سرویس پادمن.

.SS \fBCONTAINER_SSHKEY\fP
تنظیم مسیر پیش‌فرض \fB--identity\fR به فایل کلید ssh جهت دسترسی به سرویس پادمن.

.SH "وضعیت خروج (EXIT STATUS)"
کد خروج از \fBpodman\fR اطلاعاتی درباره علت شکست اجرای کانتینر یا خروج آن ارائه می‌دهد. هنگامی که دستورات \fBpodman\fR با یک کد غیرصفر خارج می‌شوند، کدهای خروج از استاندارد \fBchroot\fR پیروی می‌کنند که در ادامه آمده است:

.PP
\fB125\fP خطا مربوط به خود پادمن است

.EX
$ podman run --foo busybox; echo $?
Error: unknown flag: --foo
125
.EE

.PP
\fB126\fP یک \fIدستور درون کانتینر\fP اجرا شده و امکان فراخوانی آن \fIدستور\fP وجود ندارد

.EX
$ podman run busybox /etc; echo $?
Error: container_linux.go:346: starting container process caused "exec: \"/etc\": permission denied": OCI runtime error
126
.EE

.PP
\fB127\fP یک \fIدستور درون کانتینر\fP اجرا شده و آن \fIدستور\fP یافت نمی‌شود

.EX
$ podman run busybox foo; echo $?
Error: container_linux.go:346: starting container process caused "exec: \"foo\": executable file not found in $PATH": OCI runtime error
127
.EE

.PP
\fBکد خروج\fP کد خروج \fIدستور درون کانتینر\fP

.EX
$ podman run busybox /bin/sh -c 'exit 3'; echo $?
3
.EE

.SH "دستورات (COMMANDS)"
.TS
allbox;
l l 
l l .
\fBدستور\fP	\fBتوضیحات\fP
podman-attach(1)	متصل شدن به یک کانتینر در حال اجرا.
podman-build(1)	T{
ساخت ایمیج کانتینر با استفاده از Dockerfile.
T}
podman-commit(1)	T{
ایجاد ایمیج جدید بر اساس کانتینر تغییریافته.
T}
podman-container(1)	مدیریت کانتینرها.
podman-cp(1)	T{
کپی کردن فایل‌ها/پوشه‌ها بین یک کانتینر و فایل‌سیستم محلی.
T}
podman-create(1)	ایجاد یک کانتینر جدید.
podman-diff(1)	T{
بررسی تغییرات روی فایل‌سیستم یک کانتینر یا ایمیج.
T}
podman-events(1)	نظارت بر رویدادهای پادمن.
podman-export(1)	T{
صادر کردن محتویات فایل‌سیستم یک کانتینر به صورت آرشیو tar.
T}
podman-generate(1)	T{
تولید داده‌های ساخت‌یافته بر اساس کانتینرها و پادها.
T}
podman-healthcheck(1)	T{
مدیریت بررسی سلامت (healthcheck) برای کانتینرها.
T}
podman-history(1)	نمایش تاریخچه یک ایمیج.
podman-image(1)	مدیریت ایمیج‌ها.
podman-images(1)	فهرست کردن ایمیج‌ها در حافظه محلی.
podman-import(1)	T{
وارد کردن یک tarball و ذخیره آن به عنوان ایمیج فایل‌سیستم.
T}
podman-info(1)	T{
نمایش اطلاعات سیستمی مربوط به پادمن.
T}
podman-init(1)	راه‌اندازی اولیه یک کانتینر.
podman-inspect(1)	T{
نمایش پیکربندی یک کانتینر یا ایمیج.
T}
podman-kill(1)	T{
ارسال سیگنال کشتن به فرآیند اصلی در یک یا چند کانتینر.
T}
podman-load(1)	T{
بارگذاری یک ایمیج از آرشیو ایمیج کانتینر به حافظه کانتینر.
T}
podman-logs(1)	T{
نمایش لاگ‌های یک کانتینر.
T}
podman-pause(1)	متوقف کردن موقت (pause) یک یا چند کانتینر.
podman-pod(1)	T{
ابزار مدیریت گروه‌های کانتینری موسوم به پادها (pods).
T}
podman-port(1)	T{
فهرست کردن نگاشت پورت‌ها برای یک کانتینر.
T}
podman-ps(1)	T{
چاپ اطلاعات درباره کانتینرها.
T}
podman-pull(1)	دریافت (pull) یک ایمیج از یک رجیستری.
podman-push(1)	T{
ارسال (push) یک ایمیج از حافظه محلی به مقصدی دیگر.
T}
podman-restart(1)	T{
راه‌اندازی مجدد یک یا چند کانتینر.
T}
podman-rm(1)	حذف یک یا چند کانتینر.
podman-rmi(1)	T{
حذف یک یا چند ایمیج ذخیره‌شده محلی.
T}
podman-run(1)	T{
اجرای یک دستور در یک کانتینر جدید.
T}
podman-save(1)	T{
ذخیره یک ایمیج در یک آرشیو کانتینر.
T}
podman-start(1)	شروع یک یا چند کانتینر.
podman-stop(1)	T{
متوقف کردن یک یا چند کانتینر در حال اجرا.
T}
podman-system(1)	مدیریت پادمن.
podman-tag(1)	T{
افزودن یک نام اضافی (تگ) به یک ایمیج محلی.
T}
podman-top(1)	T{
نمایش فرآیندهای در حال اجرای یک کانتینر.
T}
podman-unpause(1)	T{
از حالت تعلیق خارج کردن (unpause) یک یا چند کانتینر.
T}
podman-version(1)	T{
نمایش اطلاعات نسخه پادمن.
T}
podman-volume(1)	مدیریت حجم‌ها (Volumes).
.TE

.SH "فایل‌ها (FILES)"
\fBcontainers.conf\fP (\fB$HOME/.config/containers/containers.conf\fR)

.PP
پادمن مقادیر پیش‌فرض توکاری برای گزینه‌های خط فرمان دارد. این مقادیر پیش‌فرض را می‌توان با استفاده از فایل‌های پیکربندی containers.conf بازنویسی کرد.

.PP
کاربران می‌توانند با ایجاد فایل \fB$HOME/.config/containers/containers.conf\fR مقادیر پیش‌فرض را تغییر دهند. پادمن در صورت وجود این فایل، پیش‌فرض‌های توکار خود را با فیلدهای مشخص‌شده در آن ادغام می‌کند. فیلدهای مشخص‌شده در فایل کاربر، مقادیر پیش‌فرض توکار را بازنویسی می‌کنند.

.PP
اگر هیچ فایل containers.conf یافت نشود، پادمن از مقادیر پیش‌فرض توکار استفاده می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-system-service(1)\fP, \fBcontainers.conf(5)\fP

.SS "عیب‌یابی (Troubleshooting)"
برای راه‌حل‌های مربوط به مشکلات متداول، podman-troubleshooting(7) را ببینید.