.nh
.TH podman-container-restore 1
.SH "نام (NAME)"
podman-container-restore \- بازیابی یک یا چند کانتینر از یک نقطه بررسی

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman container restore\fP [\fIoptions\fP] \fIname\fP [...]

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman container restore\fP یک کانتینر را از یک نقطه بررسی (checkpoint) کانتینر یا ایمیج نقطه بررسی بازیابی می‌کند\&. از \fIشناسه‌های کانتینر\fP، \fIشناسه‌های ایمیج\fP یا \fIنام‌ها\fP به عنوان ورودی استفاده می‌شود\&.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--all\fP, \fB-a\fP
بازیابی تمام \fIکانتینرهای\fP دارای نقطه بررسی\&.
.br
مقدار پیش‌فرض \fBfalse\fP است\&.
.br
\fIمهم: این گزینه به نام یا شناسه کانتینر به عنوان آرگومان ورودی نیاز ندارد\&.\fP

.SS \fB--file-locks\fP
بازیابی یک \fIکانتینر\fP به همراه قفل‌های فایل\&. این گزینه برای بازیابی قفل‌های فایل از یک ایمیج نقطه بررسی الزامی است\&. اگر ایمیج نقطه بررسی حاوی قفل‌های فایل نباشد، این گزینه نادیده گرفته می‌شود\&. پیش‌فرض بازیابی نکردن قفل‌های فایل است\&.
.br
مقدار پیش‌فرض \fBfalse\fP است\&.

.SS \fB--ignore-rootfs\fP
اگر یک \fIکانتینر\fP از یک فایل tar.gz نقطه بررسی بازیابی شود، ممکن است حاوی تمام تغییرات سیستم‌فایل ریشه نیز باشد\&. با استفاده از \fB--ignore-rootfs\fP می‌توان اعمال این تغییرات سیستم‌فایل ریشه را روی \fIکانتینر\fP بازیابی‌شده صراحتاً غیرفعال کرد\&.
.br
مقدار پیش‌فرض \fBfalse\fP است\&.
.br
\fIمهم: این گزینه تنها در ترکیب با \fB--import, -i\fP در دسترس است\&.\fP

.SS \fB--ignore-static-ip\fP
اگر \fIکانتینر\fP با \fB--ip\fP راه‌اندازی شده باشد، \fIکانتینر\fP بازیابی‌شده نیز تلاش می‌کند از همان نشانی IP استفاده کند و در صورتی که آن نشانی IP از قبل در حال استفاده باشد، بازیابی با شکست مواجه می‌شود\&. این حالت می‌تواند زمانی رخ دهد که یک \fIکانتینر\fP چندین بار از یک نقطه بررسی برون‌بری‌شده با \fB--name, -n\fP بازیابی شود\&.

.PP
استفاده از \fB--ignore-static-ip\fP به پودمن می‌گوید که اگر نشانی IP در زمان ایجاد \fIکانتینر\fP با \fB--ip\fP پیکربندی شده بود، آن را نادیده بگیرد\&.

.PP
مقدار پیش‌فرض \fBfalse\fP است\&.

.SS \fB--ignore-static-mac\fP
اگر \fIکانتینر\fP با \fB--mac-address\fP راه‌اندازی شده باشد، \fIکانتینر\fP بازیابی‌شده نیز تلاش می‌کند از همان نشانی MAC استفاده کند و در صورتی که آن نشانی MAC از قبل در حال استفاده باشد، بازیابی ناموفق خواهد بود\&. این حالت زمانی ممکن است رخ دهد که یک \fIکانتینر\fP چندین بار از یک نقطه بررسی برون‌بری‌شده با \fB--name, -n\fP بازیابی شود\&.

.PP
استفاده از \fB--ignore-static-mac\fP به پودمن می‌گوید که اگر نشانی MAC در زمان ایجاد \fIکانتینر\fP با \fB--mac-address\fP پیکربندی شده بود، آن را نادیده بگیرد\&.

.PP
مقدار پیش‌فرض \fBfalse\fP است\&.

.SS \fB--ignore-volumes\fP
این گزینه باید در ترکیب با گزینه \fB--import, -i\fP استفاده شود\&.
هنگام بازیابی \fIکانتینرها\fP از یک فایل tar.gz نقطه بررسی با این گزینه، محتوای حجم‌های مرتبط بازیابی نمی‌شود\&.
.br
مقدار پیش‌فرض \fBfalse\fP است\&.

.SS \fB--import\fP, \fB-i\fP=\fIfile\fP
درون‌ریزی یک فایل tar.gz نقطه بررسی که توسط پودمن برون‌بری شده است\&. از این گزینه می‌توان برای درون‌ریزی یک \fIکانتینر\fP دارای نقطه بررسی از میزبانی دیگر استفاده کرد\&.
.br
\fIمهم: این گزینه به نام یا شناسه کانتینر به عنوان آرگومان ورودی نیاز ندارد\&.\fP

.PP
در حین درون‌ریزی یک فایل نقطه بررسی، پودمن همان زمان اجرای کانتینری (container runtime) را انتخاب می‌کند که در هنگام ایجاد نقطه بررسی استفاده شده بود\&. این امر به‌ویژه در صورتی اهمیت دارد که یک زمان اجرای کانتینر خاص (غیرپیش‌فرض) در هنگام ایجاد کانتینر مشخص شده باشد\&. همچنین در صورتی که زمان اجرای کانتینر مشخص‌شده در حین بازیابی با زمان اجرای استفاده‌شده برای ایجاد کانتینر مطابقت نداشته باشد، پودمن عملیات بازیابی را متوقف می‌کند\&.

.SS \fB--import-previous\fP=\fIfile\fP
درون‌ریزی یک فایل tar.gz پیش‌نقطه بررسی که توسط پودمن برون‌بری شده است\&. این گزینه باید همراه با \fB-i\fP یا \fB--import\fP استفاده شود\&. این گزینه تنها روی \fBrunc 1.0-rc3\fR یا \fBبالاتر\fR کار می‌کند\&.
.br
\fIمهم: این گزینه در کلاینت ریموت، از جمله ماشین‌های Mac و Windows (به‌استثنای WSL2) پشتیبانی نمی‌شود\&.\fP

.SS \fB--keep\fP, \fB-k\fP
تمام فایل‌های موقت گزارش و آماری ایجادشده توسط \fBCRIU\fR در حین ایجاد نقطه بررسی و همچنین بازیابی را نگه می‌دارد\&. این فایل‌ها در صورت شکست عملیات بازیابی، برای اشکال‌زدایی بیشتر حذف نمی‌شوند\&. اگر بازیابی موفقیت‌آمیز باشد، این فایل‌ها از نظر تئوری نیازی نیستند، اما اگر به این فایل‌ها نیاز باشد پودمن می‌تواند آن‌ها را برای تحلیل بیشتر نگه دارد\&. این موارد شامل دایرکتوری نقطه بررسی به همراه تمام فایل‌های ایجادشده در طول فرایند ایجاد نقطه بررسی می‌شود\&. فضای مورد نیاز دایرکتوری نقطه بررسی تقریباً برابر با مقدار حافظه مورد نیاز فرآیندهای درون \fIکانتینر\fP دارای نقطه بررسی است\&.
.br
بدون گزینه \fB--keep\fP, \fB-k\fP، نقطه بررسی مصرف شده و دیگر قابل استفاده مجدد نخواهد بود\&.
.br
مقدار پیش‌فرض \fBfalse\fP است\&.

.SS \fB--latest\fP, \fB-l\fP
به‌جای ارائه \fIشناسه\fP یا \fIنام کانتینر\fP، از آخرین \fIکانتینر\fP ایجادشده استفاده می‌کند\&. مقدار پیش‌فرض \fBfalse\fP است\&.
.br
\fIمهم: این گزینه در کلاینت ریموت پودمن، از جمله ماشین‌های Mac و Windows (به‌استثنای WSL2) در دسترس نیست\&. این گزینه به نام یا شناسه کانتینر به عنوان آرگومان ورودی نیاز ندارد\&.\fP

.SS \fB--name\fP, \fB-n\fP=\fIname\fP
اگر یک \fIکانتینر\fP از یک فایل tar.gz نقطه بررسی بازیابی شود، امکان تغییر نام آن با \fB--name, -n\fP وجود دارد\&. از این طریق می‌توان یک \fIکانتینر\fP را چندین بار با نام‌های مختلف از یک نقطه بررسی بازیابی کرد\&.

.PP
اگر از گزینه \fB--name, -n\fP استفاده شود، پودمن تلاشی برای تخصیص همان نشانی IP که \fIکانتینر\fP پیش از نقطه بررسی استفاده می‌کرد نمی‌کند؛ زیرا هر نشانی IP تنها یک بار قابل استفاده است و \fIکانتینر\fP بازیابی‌شده نشانی IP دیگری دریافت خواهد کرد\&. این همچنین بدان معناست که گزینه \fB--name, -n\fP نمی‌تواند در ترکیب با \fB--tcp-established\fP استفاده شود\&.
.br
\fIمهم: این گزینه تنها برای یک ایمیج نقطه بررسی یا در ترکیب با \fB--import, -i\fP در دسترس است\&.\fP

.SS \fB--pod\fP=\fIname\fP
بازیابی یک کانتینر درون پاد با نام \fIname\fP\&. پاد مقصد برای این بازیابی باید فضاهای نام مشترک یکسانی با پادی داشته باشد که کانتینر از آن نقطه بررسی شده است (به \fBpodman pod create --share\fP مراجعه کنید)\&.
.br
\fIمهم: این گزینه تنها برای یک ایمیج نقطه بررسی یا در ترکیب با \fB--import, -i\fP در دسترس است\&.\fP

.PP
این گزینه حداقل به CRIU 3.16 نیاز دارد\&.

.SS \fB--print-stats\fP
چاپ آمار مربوط به بازیابی کانتینر(ها)\&. خروجی در قالب یک آرایه JSON ارائه می‌شود و حاوی اطلاعاتی در مورد مدت زمان لازم برای عملیات مختلف بازیابی است\&. بسیاری از آمارهای بازیابی توسط CRIU ایجاد شده و صرفاً به پودمن منتقل می‌شوند\&. اطلاعات زیر در آرایه JSON ارائه می‌شود:
.IP \(bu 2
\fBpodman_restore_duration\fP: مدت زمان کل (به میکروثانیه) مورد نیاز برای بازیابی تمام نقاط بررسی\&.
.IP \(bu 2
\fBruntime_restore_duration\fP: مدت زمانی (به میکروثانیه) که زمان اجرای کانتینر برای بازیابی نقطه بررسی نیاز داشته است\&.
.IP \(bu 2
\fBforking_time\fP: مدت زمانی (به میکروثانیه) که CRIU برای ایجاد (fork کردن) تمام فرآیندها در کانتینر بازیابی‌شده نیاز داشته است (اندازه‌گیری‌شده توسط CRIU)\&.
.IP \(bu 2
\fBrestore_time\fP: مدت زمانی (به میکروثانیه) که CRIU برای بازیابی تمام فرآیندها در کانتینر نیاز داشته است (اندازه‌گیری‌شده توسط CRIU)\&.
.IP \(bu 2
\fBpages_restored\fP: تعداد صفحات حافظه بازیابی‌شده (اندازه‌گیری‌شده توسط CRIU)\&.

.PP
مقدار پیش‌فرض \fBfalse\fP است\&.

.SS \fB--publish\fP, \fB-p\fP=\fIport\fP
پورت‌هایی را که \fIکانتینر\fP منتشر می‌کند (همان‌طور که در زمان راه‌اندازی اولیه \fIکانتینر\fP پیکربندی شده بود) با مجموعه جدیدی از قوانین هدایت پورت جایگزین می‌کند\&.

.PP
برای جزئیات بیشتر، \fBpodman run --publish\fP را ببینید\&.
.br
\fIمهم: این گزینه تنها برای یک ایمیج نقطه بررسی یا در ترکیب با \fB--import, -i\fP در دسترس است\&.\fP

.SS \fB--tcp-close\fP
بازیابی یک \fIکانتینر\fP و بستن تمام اتصالات TCP\&. این گزینه زمانی مفید است که پس از بازیابی به اتصالات TCP نیازی نباشد یا اتصالات توسط برنامه مجدداً برقرار شوند\&. اگر ایمیج نقطه بررسی با \fB--tcp-close\fP ایجاد شده باشد، این گزینه باید در حین بازیابی استفاده شود\&.
.br
مقدار پیش‌فرض \fBfalse\fP است\&.

.SS \fB--tcp-established\fP
بازیابی یک \fIکانتینر\fP به همراه اتصالات TCP برقرارشده\&. اگر ایمیج نقطه بررسی حاوی اتصالات TCP برقرارشده باشد، این گزینه در حین بازیابی الزامی است\&. اگر ایمیج نقطه بررسی حاوی اتصالات TCP برقرارشده نباشد، این گزینه نادیده گرفته می‌شود\&. پیش‌فرض، بازیابی نکردن \fIکانتینرها\fP با اتصالات TCP برقرارشده است\&.
.br
مقدار پیش‌فرض \fBfalse\fP است\&.

.SH "مثال‌ها (EXAMPLES)"
بازیابی کانتینر "mywebserver".

.EX
# podman container restore mywebserver
.EE

.PP
درون‌ریزی یک فایل نقطه بررسی و یک فایل پیش‌نقطه بررسی.

.EX
# podman container restore --import-previous pre-checkpoint.tar.gz --import checkpoint.tar.gz
.EE

.PP
راه‌اندازی کانتینر "mywebserver". ایجاد یک نقطه بررسی از کانتینر و برون‌بری آن. بازیابی کانتینر با محدوده‌های پورت متفاوت از فایل برون‌بری‌شده.

.EX
$ podman run --rm -p 2345:80 -d webserver
# podman container checkpoint -l --export=dump.tar
# podman container restore -p 5432:8080 --import=dump.tar
.EE

.PP
راه‌اندازی یک کانتینر با نام "foobar-1". ایجاد یک ایمیج نقطه بررسی "foobar-checkpoint". بازیابی کانتینر از ایمیج نقطه بررسی با نامی متفاوت.

.EX
# podman run --name foobar-1 -d webserver
# podman container checkpoint --create-image foobar-checkpoint foobar-1
# podman inspect foobar-checkpoint
# podman container restore --name foobar-2 foobar-checkpoint
# podman container restore --name foobar-3 foobar-checkpoint
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-container-checkpoint(1)\fP, \fBpodman-run(1)\fP, \fBpodman-pod-create(1)\fP, \fBcriu(8)\fP

.SH "تاریخچه (HISTORY)"
سپتامبر ۲۰۱۸، در ابتدا توسط Adrian Reber به نشانی areber@redhat.com گردآوری شد
\[la]mailto:areber@redhat.com\[ra]