podman-container-checkpoint(1)                         General Commands Manual

نام (NAME)
       podman-container-checkpoint - ایجاد نقطه بررسی از کانتینر در حال اجرا


خلاصه دستور (SYNOPSIS)
       podman container checkpoint [options] container [container ...]


توضیحات (DESCRIPTION)
       دستور podman container checkpoint از تمام فرآیندهای درون یک یا چند
       کانتینر نقطه بررسی (checkpoint) ایجاد می‌کند. یک کانتینر را می‌توان با
       استفاده از podman-container-restore از یک نقطه بررسی بازیابی کرد. از
       شناسه‌ها یا نام‌های کانتینر به عنوان ورودی استفاده می‌شود.


       مهم: اگر کانتینر از systemd به عنوان entrypoint استفاده می‌کند، ممکن است
       ایجاد نقطه بررسی از کانتینر امکان‌پذیر نباشد.


گزینه‌ها (OPTIONS)
   --all, -a
       از تمام کانتینرهای در حال اجرا نقطه بررسی ایجاد می‌کند.
       مقدار پیش‌فرض false است.
       مهم: این گزینه به نام یا شناسه کانتینر به عنوان آرگومان ورودی نیاز
       ندارد.


   --compress, -c=zstd | none | gzip
       الگوریتم فشرده‌سازی مورد استفاده برای آرشیو نقطه بررسی ایجادشده با گزینه
       --export, -e را مشخص می‌کند. الگوریتم‌های ممکن عبارتند از zstd، none و
       gzip.
       یک دلیل احتمالی برای استفاده از none، فعال‌سازی ایجاد سریع‌تر آرشیوهای
       نقطه بررسی است. فشرده نکردن آرشیو نقطه بررسی می‌تواند منجر به ایجاد
       سریع‌تر آن شود.
       مقدار پیش‌فرض zstd است.


   --create-image=image
       یک ایمیج نقطه بررسی از کانتینر در حال اجرا ایجاد می‌کند. این یک ایمیج
       استاندارد OCI است که در مخزن محلی ایمیج‌ها ایجاد می‌شود. این ایمیج شامل
       یک لایه منفرد است که تمام فایل‌های نقطه بررسی را در بر دارد. محتوای این
       لایه ایمیج در همان قالبی است که یک نقطه بررسی ایجادشده با --export
       دارد. یک ایمیج نقطه بررسی را می‌توان به یک رجیستری استاندارد کانتینر
       ارسال (push) کرد و روی سیستمی دیگر دریافت (pull) نمود تا مهاجرت کانتینر
       امکان‌پذیر شود. علاوه بر این، می‌توان ایمیج را با podman image save
       برون‌بری (export) کرد و با podman inspect مورد بازبینی قرار داد. بازبینی
       یک ایمیج نقطه بررسی اطلاعات اضافی را که به عنوان حاشیه‌نویسی
       (annotation) ذخیره شده‌اند، درباره محیط میزبان استفاده‌شده برای ایجاد
       نقطه بررسی نمایش می‌دهد:

       • io.podman.annotations.checkpoint.name: نام خوانا برای انسان از
         کانتینر اصلی.

       • io.podman.annotations.checkpoint.rawImageName: نام پردازش‌نشده ایمیج
         مورد استفاده برای ایجاد کانتینر اصلی (همان‌طور که توسط کاربر مشخص شده
         است).

       • io.podman.annotations.checkpoint.rootfsImageID: شناسه (ID) ایمیج مورد
         استفاده برای ایجاد کانتینر اصلی.

       • io.podman.annotations.checkpoint.rootfsImageName: نام ایمیج مورد
         استفاده برای ایجاد کانتینر اصلی.

       • io.podman.annotations.checkpoint.podman.version: نسخه Podman مورد
         استفاده برای ایجاد نقطه بررسی.

       • io.podman.annotations.checkpoint.criu.version: نسخه CRIU مورد استفاده
         برای ایجاد نقطه بررسی.

       • io.podman.annotations.checkpoint.runtime.name: زمان اجرای کانتینر
         (مانند runc یا crun) مورد استفاده برای ایجاد نقطه بررسی.

       • io.podman.annotations.checkpoint.runtime.version: نسخه زمان اجرای
         کانتینر مورد استفاده برای ایجاد نقطه بررسی.

       • io.podman.annotations.checkpoint.conmon.version: نسخه conmon مورد
         استفاده با کانتینر اصلی.

       • io.podman.annotations.checkpoint.host.arch: معماری پردازنده (CPU)
         میزبانی که نقطه بررسی روی آن ایجاد شده است.

       • io.podman.annotations.checkpoint.host.kernel: نسخه هسته لینوکس
         میزبانی که نقطه بررسی روی آن ایجاد شده است.

       • io.podman.annotations.checkpoint.cgroups.version: نسخه cgroup مورد
         استفاده توسط میزبانی که نقطه بررسی روی آن ایجاد شده است.

       • io.podman.annotations.checkpoint.distribution.version: نسخه توزیع
         میزبانی که نقطه بررسی روی آن ایجاد شده است.

       • io.podman.annotations.checkpoint.distribution.name: نام توزیع میزبانی
         که نقطه بررسی روی آن ایجاد شده است.


   --export, -e=archive
       نقطه بررسی را به یک آرشیو برون‌بری (export) می‌کند. نوع آرشیو با
       --compress مشخص می‌شود. نقطه بررسی برون‌بری‌شده را می‌توان برای درون‌ریزی
       (import) کانتینر روی سیستمی دیگر استفاده کرد و در نتیجه مهاجرت زنده
       کانتینر را ممکن ساخت. این آرشیو نقطه بررسی همچنین شامل تمام تغییرات
       اعمال‌شده در سیستم‌فایل ریشه (root file-system) کانتینر نیز می‌شود، مگر
       اینکه صریحاً با استفاده از --ignore-rootfs غیرفعال شده باشد.


   --file-locks
       از یک کانتینر به همراه قفل‌های فایل نقطه بررسی ایجاد می‌کند. اگر برنامه‌ای
       در حال اجرا در کانتینر از قفل‌های فایل استفاده می‌کند، این گزینه در حین
       ایجاد نقطه بررسی و بازیابی الزامی است. در غیر این صورت، انتظار می‌رود
       ایجاد نقطه بررسی از کانتینرهای دارای قفل‌های فایل با شکست مواجه شود. اگر
       از قفل‌های فایل استفاده نشود، این گزینه نادیده گرفته می‌شود.
       مقدار پیش‌فرض false است.


   --ignore-rootfs
       اگر یک نقطه بررسی به یک آرشیو برون‌بری شود، با کمک --ignore-rootfs
       امکان‌پذیر است که درج تغییرات سیستم‌فایل ریشه در فایل آرشیو نقطه بررسی را
       صریحاً غیرفعال کرد.
       مقدار پیش‌فرض false است.
       مهم: این گزینه فقط در ترکیب با --export, -e کار می‌کند.


   --ignore-volumes
       این گزینه باید در ترکیب با گزینه --export, -e استفاده شود. هنگامی که
       این گزینه مشخص شود، محتوای حجم‌های (volumes) مرتبط با کانتینر در آرشیو
       نقطه بررسی گنجانده نمی‌شود.
       مقدار پیش‌فرض false است.


   --keep, -k
       تمام فایل‌های موقت لاگ و آماری ایجادشده توسط CRIU در حین ایجاد نقطه
       بررسی را نگه می‌دارد. این فایل‌ها در صورت شکست ایجاد نقطه بررسی، برای
       اشکال‌زدایی بیشتر حذف نمی‌شوند. اگر ایجاد نقطه بررسی با موفقیت انجام شود،
       این فایل‌ها از نظر تئوری نیازی نیستند، اما در صورت نیاز Podman می‌تواند
       آن‌ها را برای تجزیه و تحلیل بیشتر نگه دارد.
       مقدار پیش‌فرض false است.


   --latest, -l
       به‌جای ارائه شناسه یا نام کانتینر، از آخرین کانتینر ایجادشده استفاده
       می‌کند. مقدار پیش‌فرض false است.
       مهم: این گزینه در کلاینت ریموت Podman، از جمله ماشین‌های Mac و Windows
       (به‌استثنای WSL2) در دسترس نیست. این گزینه به نام یا شناسه کانتینر به
       عنوان آرگومان ورودی نیاز ندارد.


   --leave-running, -R
       کانتینر را پس از ایجاد نقطه بررسی به‌جای متوقف کردن، در حال اجرا باقی
       می‌گذارد.
       مقدار پیش‌فرض false است.


       برای حفظ یکپارچگی نقطه بررسی، Podman قبل از تخلیه حافظه کانتینر، cgroup
       کانتینر را منجمد (freeze) می‌کند و فقط پس از ثبت تغییرات سیستم‌فایل ریشه
       و حجم‌های نام‌گذاری‌شده، آن را مجدداً از انجماد خارج می‌سازد (thaw). این
       بدان معناست که کانتینر در طول مدت ایجاد نقطه بررسی متوقف (pause) می‌شود،
       اما تصویر حافظه و سیستم‌فایل آن تضمین می‌شوند که همان نقطه زمانی یکسان را
       منعکس کنند. کانتینرهایی که با --cgroups=disabled راه‌اندازی شده‌اند قابل
       منجمد شدن نیستند و بنابراین این ضمانت را دریافت نمی‌کنند. اگر منجمد کردن
       کانتینر ناموفق باشد، Podman ایجاد نقطه بررسی را ادامه می‌دهد و هشدار
       می‌دهد که این ضمانت یکپارچگی قابل ارائه نبوده است.


   --pre-checkpoint, -P
       تنها اطلاعات حافظه کانتینر را تخلیه (dump) می‌کند و کانتینر را در حال
       اجرا باقی می‌گذارد. عملیات بعدی جایگزین تخلیه‌های قبلی می‌شود.
       مقدار پیش‌فرض false است.


       قابلیت ایجاد نقطه بررسی تنها از حافظه کانتینر و در دومین نقطه بررسی
       تنها بازنویسی صفحاتی از حافظه که از اولین نقطه بررسی تغییر کرده‌اند، به
       بیت soft-dirty هسته لینوکس وابسته است که روی همه سیستم‌ها در دسترس نیست،
       چرا که به معماری سیستم و پیکربندی هسته لینوکس بستگی دارد. برنامه Podman
       بررسی می‌کند که آیا سیستم فعلی از این قابلیت پشتیبانی می‌کند یا خیر و اگر
       سیستم پشتیبانی نکند خطایی بازمی‌گرداند.


   --print-stats
       آمار مربوط به ایجاد نقطه بررسی از کانتینر(ها) را چاپ می‌کند. خروجی در یک
       آرایه JSON رندر می‌شود و شامل اطلاعاتی درباره مدت زمان مورد نیاز برای
       عملیات مختلف نقطه بررسی است. بسیاری از آمارهای نقطه بررسی توسط CRIU
       ایجاد شده و صرفاً به Podman منتقل می‌شوند. اطلاعات زیر در آرایه JSON
       ارائه شده است:

       • podman_checkpoint_duration: زمان کلی (به میکروثانیه) مورد نیاز برای
         ایجاد تمام نقاط بررسی.

       • runtime_checkpoint_duration: زمان (به میکروثانیه) مورد نیاز زمان
         اجرای کانتینر برای ایجاد نقطه بررسی.

       • freezing_time: زمان (به میکروثانیه) مورد نیاز CRIU برای متوقف کردن
         (منجمد کردن) تمام فرآیندهای درون کانتینر (اندازه‌گیری‌شده توسط CRIU).

       • frozen_time: زمان (به میکروثانیه) که تمام فرآیندهای درون کانتینر
         متوقف (منجمد) بودند (اندازه‌گیری‌شده توسط CRIU).

       • memdump_time: زمان (به میکروثانیه) مورد نیاز برای استخراج تمام صفحات
         حافظه لازم از تمام فرآیندهای کانتینر (اندازه‌گیری‌شده توسط CRIU).

       • memwrite_time: زمان (به میکروثانیه) مورد نیاز برای نوشتن تمام صفحات
         حافظه لازم در فایل‌های ایمیج نقطه بررسی مربوطه (اندازه‌گیری‌شده توسط
         CRIU).

       • pages_scanned: تعداد صفحات حافظه اسکن‌شده برای تعیین اینکه آیا نیاز به
         ایجاد نقطه بررسی دارند یا خیر (اندازه‌گیری‌شده توسط CRIU).

       • pages_written: تعداد صفحات حافظه که واقعاً در فایل‌های ایمیج نقطه بررسی
         نوشته شده‌اند (اندازه‌گیری‌شده توسط CRIU).

       مقدار پیش‌فرض false است.


   --tcp-established
       از یک کانتینر دارای اتصالات TCP برقرارشده (established) نقطه بررسی
       ایجاد می‌کند. اگر ایمیج نقطه بررسی شامل اتصالات TCP برقرارشده باشد، این
       گزینه در حین بازیابی الزامی خواهد بود. حالت پیش‌فرض، عدم ایجاد نقطه
       بررسی از کانتینرهای دارای اتصالات TCP برقرارشده است.
       مقدار پیش‌فرض false است.


   --with-previous
       از کانتینر به همراه فایل‌های ایمیج CRIU قبلی در پیش‌تخلیه (pre-dump) نقطه
       بررسی ایجاد می‌کند. این گزینه فقط با runc 1.0-rc3 یا بالاتر کار می‌کند.
       مقدار پیش‌فرض false است.
       مهم: این گزینه همراه با --pre-checkpoint در دسترس نیست.


       این گزینه نیازمند آن است که پیش‌تر از گزینه --pre-checkpoint روی همان
       کانتینر استفاده شده باشد. بدون وجود یک پیش‌نقطه بررسی موجود، این گزینه
       با شکست مواجه می‌شود.


       همچنین برای اطلاعات بیشتر درباره در دسترس بودن --pre-checkpoint در
       سیستم‌های مختلف، به --pre-checkpoint مراجعه کنید.


مثال‌ها (EXAMPLES)
       ایجاد یک نقطه بررسی از کانتینر "mywebserver".

       # podman container checkpoint mywebserver


       ایجاد یک ایمیج نقطه بررسی برای کانتینر "mywebserver".

       # podman container checkpoint --create-image mywebserver-checkpoint-1 mywebserver


       تخلیه اطلاعات حافظه آخرین کانتینر درون یک فایل آرشیو.

       # podman container checkpoint -P -e pre-checkpoint.tar.zst -l


       نگه‌داشتن اطلاعات حافظه کانتینر از یک تخلیه قدیمی‌تر و افزودن اطلاعات
       جدید حافظه کانتینر به آن.

       # podman container checkpoint --with-previous -e checkpoint.tar.zst -l


       تخلیه اطلاعات حافظه آخرین کانتینر درون یک آرشیو با روش فشرده‌سازی
       مشخص‌شده.

       # podman container checkpoint -l --compress=none --export=dump.tar
       # podman container checkpoint -l --compress=gzip --export=dump.tar.gz


همچنین ببینید (SEE ALSO)
       podman(1), podman-container-restore(1), criu(8)


تاریخچه (HISTORY)
       سپتامبر ۲۰۱۸، در ابتدا توسط Adrian Reber به نشانی areber@redhat.com
       گردآوری شد ⟨mailto:areber@redhat.com⟩

                                                podman-container-checkpoint(1)