ctr(8) راهنمای لینوکس ctr(8)

ctr - کلاینت خط فرمان مدیریتی و اشکال‌زدایی برای دیمن containerd

ctr

[--address|-a]=[value]
[--connect-timeout]=[value]
[--debug]
[--namespace|-n]=[value]
[--timeout]=[value]

دستور ctr یک کلاینت غیررسمی برای اشکال‌زدایی و مدیریت به منظور تعامل با دیمن containerd است. از آنجا که این ابزار به طور رسمی پشتیبانی نمی‌شود، هیچ تضمینی وجود ندارد که دستورات، گزینه‌ها و عملیات آن در نسخه‌های مختلف پروژه containerd دارای سازگاری عقبرو یا پایداری باشند.

نحوه استفاده (Usage):

ctr [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]

--address, -a="": نشانی سرور GRPC مربوط به containerd (پیش‌فرض: "/run/containerd/containerd.sock")

--connect-timeout="": مهلت زمانی برقراری اتصال به containerd (پیش‌فرض: 0s)

--debug: فعال‌سازی خروجی اشکال‌زدایی در گزارش‌ها

--namespace, -n="": فضای نام مورد استفاده برای دستورات (پیش‌فرض: "default")

--timeout="": مهلت زمانی کل برای دستورات ctr (پیش‌فرض: 0s)

ارائه اطلاعات درباره پلاگین‌های containerd

فهرست کردن پلاگین‌های containerd

--detailed, -d: چاپ اطلاعات دقیق درباره هر پلاگین

--quiet, -q: تنها شناسه‌های پلاگین چاپ شوند

نمایش اطلاعات محیط زمان اجرا (runtime)

--runc-binary="": مشخص کردن فایل باینری سازگار با runc

--runc-root="": مشخص کردن دایرکتوری ریشه سازگار با runc

--runc-systemd-cgroup: شروع runc با مدیر گروه کنترلی systemd (cgroup)

--runtime="": نام زمان اجرا یا مسیر مطلق به باینری runtime (پیش‌فرض: "io.containerd.runc.v2")

--runtime-config-path="": مسیر اختیاری پیکربندی runtime

چاپ نسخه کلاینت و سرور

مدیریت کانتینرها

ایجاد کانتینر جدید

--allow-new-privs: غیرفعال کردن فلگ ویژگی NoNewPrivileges در مشخصات OCI

--annotation="": مشخص کردن حاشیه‌نویسی‌های اضافی OCI (برای نمونه foo=bar)

--apparmor-default-profile="": فعال‌سازی AppArmor با پروفایل پیش‌فرض و نام مشخص‌شده، مانند "cri-containerd.apparmor.d"

--apparmor-profile="": فعال‌سازی AppArmor با پروفایل سفارشی موجود

--blockio-class="": نام کلاس blockio برای پیوند دادن کانتینر به آن

--blockio-config-file="": مسیر فایل تعاریف کلاس blockio. به طور پیش‌فرض تعاریف کلاس بارگذاری نمی‌شوند.

--cap-add="": افزودن قابلیت‌های لینوکس (قابلیت‌ها را با پیشوند 'CAP_' مشخص کنید)

--cap-drop="": حذف قابلیت‌های لینوکس (قابلیت‌ها را با پیشوند 'CAP_' مشخص کنید)

--config, -c="": مسیر فایل پیکربندی مشخصات خاص زمان اجرا

--cpu-period="": محدود کردن دوره CPU CFS (پیش‌فرض: 0)

--cpu-quota="": محدود کردن سهمیه CPU CFS (پیش‌فرض: -1)

--cwd="": مشخص کردن دایرکتوری کاری فرآیند

--device="": مسیر فایل دستگاه برای افزودن به کانتینر، یا مسیری به درخت دایرکتوری دستگاه‌ها جهت افزودن به کانتینر

--env="": مشخص کردن متغیرهای محیطی اضافی کانتینر (برای نمونه FOO=bar)

--env-file="": مشخص کردن متغیرهای محیطی اضافی کانتینر در یک فایل (برای نمونه FOO=bar، هر متغیر در یک خط)

--gpus="": افزودن کارت‌های گرافیک (GPU) به کانتینر

--hostname="": تنظیم نام میزبان کانتینر

--label="": مشخص کردن برچسب‌های اضافی (برای نمونه foo=bar)

--memory-limit="": محدودیت حافظه (به بایت) برای کانتینر (پیش‌فرض: 0)

--mount="": مشخص کردن مانت‌های اضافی برای کانتینر (برای نمونه type=bind,src=/tmp,dst=/host,options=rbind:ro)

--net-host: فعال‌سازی شبکه میزبان برای کانتینر

--no-pivot: غیرفعال کردن استفاده از pivot-root (ویژه لینوکس)

--pid-file="": مسیر فایل برای ثبت شناسه فرآیند (PID) وظیفه

--privileged: اجرای کانتینر ممتاز (دارای دسترسی‌های ریشه کامل)

--rdt-class="": نام کلاس RDT برای پیوند دادن کانتینر به آن. تعیین‌کننده Class of Service (CLOS) برای مدیریت پهنای باند حافظه و کش.

--read-only: تنظیم سیستم‌فایل کانتینر به صورت فقط‌خواندنی

--rootfs: استفاده از روت‌اف‌اس سفارشی که توسط snapshotter دیمن containerd مدیریت نمی‌شود

--rootfs-propagation="": تنظیم انتشار (propagation) روت‌اف‌اس کانتینر

--runc-binary="": مشخص کردن باینری سازگار با runc

--runc-root="": مشخص کردن ریشه سازگار با runc

--runc-systemd-cgroup: اجرای runc با مدیر cgroup متعلق به systemd

--runtime="": نام زمان اجرا یا مسیر مطلق به باینری زمان اجرا (پیش‌فرض: "io.containerd.runc.v2")

--runtime-config-path="": مسیر اختیاری فایل پیکربندی runtime

--sandbox="": ایجاد کانتینر درون سندباکس مشخص‌شده

--seccomp: فعال‌سازی نمایه (پروفایل) پیش‌فرض seccomp

--seccomp-profile="": مسیر فایل نمایه سفارشی seccomp. پیش از استفاده از seccomp-profile، گزینه seccomp باید روی true تنظیم شود

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

--snapshotter-label="": برچسب‌های اضافه‌شونده به اسنپ‌شات جدید برای این کانتینر.

--tty, -t: تخصیص یک ترمینال مجازی (TTY) برای کانتینر

--user, -u="": نام کاربری یا شناسه کاربری، گروه اختیاری است (قالب: [کاربر:گروه])

--with-ns="": مشخص کردن فضاهای نام موجود لینوکس برای پیوستن در زمان اجرای کانتینر (قالب 'فضای‌نام:مسیر')

حذف یک یا چند کانتینر موجود

--keep-snapshot: عدم پاک‌سازی اسنپ‌شات همراه با حذف کانتینر

دریافت اطلاعات درباره یک کانتینر

--spec: تنها مشخصات (spec) نمایش داده شود

فهرست کردن کانتینرها

--quiet, -q: تنها شناسه کانتینر چاپ شود

تنظیم و پاک کردن برچسب‌ها برای یک کانتینر

ایجاد چک‌پوینت از یک کانتینر

--image: گنجاندن تصویر در چک‌پوینت

--rw: گنجاندن لایه خواندن/نوشتن در چک‌پوینت

--task: ایجاد چک‌پوینت از وظیفه (task) کانتینر

بازیابی یک کانتینر از روی چک‌پوینت

--live: بازیابی داده‌های زمان اجرا و حافظه از چک‌پوینت

--rw: بازیابی لایه خواندن/نوشتن از چک‌پوینت

مدیریت محتوا

نمایش انتقال‌های فعال

--root="": مسیر ریشه ذخیره‌سازی محتوا (پیش‌فرض: "/tmp/content")

--timeout, -t="": مهلت زمانی کل برای عملیات واکشی (پیش‌فرض: 0s)

حذف دائمی یک یا چند blob

ویرایش یک blob و برگرداندن یک دایجست جدید

--editor="": انتخاب ویرایشگر متنی (مانند vim، emacs و غیره)

--validate="": اعتبارسنجی نتیجه در برابر یک فرمت مشخص (مانند json، mediatype و غیره)

واکشی تمام محتوای یک تصویر به درون containerd

--all-platforms: دریافت محتوا برای تمام پلتفرم‌ها

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--label="": برچسب‌هایی برای الصاق به تصویر

--metadata-only: دریافت تنها متاداده شامل مانیفست‌ها و پیکربندی‌ها

--plain-http: مجاز شمردن اتصال‌ها با استفاده از HTTP ساده و غیرامن

--platform="": دریافت محتوا برای یک پلتفرم خاص

--refresh="": توکن نوسازی برای سرور احراز هویت

--skip-metadata: صرف‌نظر کردن از متاداده برای پلتفرم‌های استفاده‌نشده (ممکن است بعداً نتوان تصویر را بدون متاداده push کرد)

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--tlscacert="": مسیر مرجع صدور گواهی ریشه TLS (CA)

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

بازیابی شیءها (objects) از یک مخزن راه دور

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--plain-http: مجاز شمردن اتصال‌ها با استفاده از HTTP ساده

--refresh="": توکن نوسازی برای سرور احراز هویت

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--tlscacert="": مسیر گواهی ریشه CA برای TLS

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

بازیابی داده‌های باینری (blobs) از یک مخزن راه دور

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--media-type="": مشخص کردن نوع رسانه (mediatype) هدف برای هدر درخواست

--plain-http: مجاز شمردن اتصال‌ها با استفاده از HTTP ساده

--refresh="": توکن نوسازی برای سرور احراز هویت

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--tlscacert="": مسیر گواهی ریشه CA برای TLS

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

دریافت داده‌های یک شیء

پذیرش و درج محتوا در مخزن ذخیره‌سازی

--expected-digest="": اعتبارسنجی محتوا در برابر دایجست مورد انتظار

--expected-size="": اعتبارسنجی محتوا در برابر اندازه ارائه‌شده (پیش‌فرض: 0)

فهرست کردن تمام blobها در مخزن ذخیره‌سازی

--quiet, -q: تنها دایجست blob چاپ شود

ارسال (push) یک شیء به یک مخزن راه دور

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--plain-http: مجاز شمردن اتصالات با استفاده از HTTP ساده

--refresh="": توکن نوسازی برای سرور احراز هویت

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--tlscacert="": مسیر گواهی ریشه CA برای TLS

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

افزودن برچسب‌ها به محتوا

هرس و پاک‌سازی محتوای اضافه از مخزن محتوا

هرس برچسب‌های ترجیحی از مخزن محتوا (به طور پیش‌فرض فقط لایه‌ها)

--async: اجازه به فرآیند بازیافت حافظه (garbage collection) برای پاک‌سازی غیرهمگام

--dry: تنها نمایش به‌روزرسانی‌ها بدون اعمال تغییرات واقعی (فعال‌سازی گزارش اشکال‌زدایی)

نمایش رخدادهای containerd

مدیریت تصاویر

بررسی تصاویر موجود برای اطمینان از در دسترس بودن محلی همه داده‌ها

--quiet, -q: تنها چاپ ارجاعات تصاویر آماده (به طور کامل دانلود و استخراج‌شده)

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

خروجی گرفتن از تصاویر

--all-platforms: خروجی گرفتن از محتوای تمام پلتفرم‌ها

--local: اجرای خروجی به صورت محلی به جای استفاده از API انتقال

--platform="": دریافت محتوا برای یک پلتفرم خاص

--skip-manifest-json: عدم افزودن فایل سازگار با داکر manifest.json به آرشیو

--skip-non-distributable: عدم افزودن blobهای غیرقابل توزیع مانند لایه‌های ویندوز به آرشیو

وارد کردن (ایمپورت) تصاویر

--all-platforms: وارد کردن محتوا برای تمام پلتفرم‌ها، پیش‌فرض false

--base-name="": نام تصویر پایه برای تصاویر اضافه‌شده؛ در صورت ارائه، تنها تصاویر دارای این پیشوند ایمپورت می‌شوند

--compress-blobs: فشرده‌سازی blobهای غیرفشرده هنگام ساخت مانیفست (تنها فرمت داکر)

--digests: تعیین اینکه آیا تصاویر دایجست ایجاد شوند یا خیر (پیش‌فرض: false)

--discard-unpacked-layers: اجازه به زباله‌روب برای پاک‌سازی لایه‌ها از مخزن محتوا پس از استخراج؛ همراه با --no-unpack قابل استفاده نیست، پیش‌فرض false

--index-name="": نام تصویر برای نگهداری ایندکس؛ به طور پیش‌فرض ایندکس دور انداخته می‌شود

--label="": برچسب‌هایی برای الصاق به تصویر

--local: اجرای وارد کردن به صورت محلی به جای استفاده از API انتقال

--no-unpack: صرف‌نظر کردن از استخراج تصاویر؛ همراه با --discard-unpacked-layers قابل استفاده نیست، پیش‌فرض false

--platform="": وارد کردن محتوا برای پلتفرم خاص

--skip-digest-for-named: صرف‌نظر کردن از اعمال گزینه --digests برای تصاویر نام‌گذاری‌شده در تار وارداتی (در ترکیب با --digests استفاده شود)

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

--sync-fs: همگام‌سازی سیستم‌فایل زیرین حاوی پرونده‌ها هنگام استخراج تصاویر، پیش‌فرض false

بازبینی و بررسی یک تصویر

--content: نمایش محتوای JSON

فهرست کردن تصاویر شناخته‌شده برای containerd

--quiet, -q: تنها چاپ ارجاعات تصاویر

متصل کردن (mount) یک تصویر به یک مسیر هدف

--expiration, -x="": تنظیم زمان انقضا برای مانت و اسنپ‌شات‌ها (پیش‌فرض: 1h0m0s)

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--label="": برچسب‌هایی برای الصاق به تصویر

--plain-http: مجاز شمردن اتصال‌ها با استفاده از HTTP ساده

--platform="": مانت کردن تصویر برای پلتفرم مشخص‌شده (پیش‌فرض: "linux/amd64")

--refresh="": توکن نوسازی برای سرور احراز هویت

--rw: فعال‌سازی پشتیبانی از نوشتن بر روی مانت

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

--sync-fs: همگام‌سازی سیستم‌فایل زیرین حاوی پرونده‌ها هنگام استخراج تصاویر، پیش‌فرض false

--tlscacert="": مسیر مرجع صدور گواهی ریشه TLS (CA)

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

قطع اتصال (unmount) تصویر از مسیر هدف

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--label="": برچسب‌هایی برای الصاق به تصویر

--plain-http: مجاز شمردن اتصال‌ها با استفاده از HTTP ساده

--refresh="": توکن نوسازی برای سرور احراز هویت

--rm: حذف اسنپ‌شات پس از قطع اتصال موفقیت‌آمیز

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

--tlscacert="": مسیر مرجع صدور گواهی ریشه TLS (CA)

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

دریافت (pull) یک تصویر از یک مخزن راه دور

--all-platforms: دریافت محتوا و متاداده برای تمام پلتفرم‌ها

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--label="": برچسب‌هایی برای الصاق به تصویر

--local: واکشی محتوا از کلاینت محلی به جای استفاده از سرویس انتقال

--max-concurrent-downloads="": تنظیم حداکثر دانلودهای همزمان برای هر عملیات pull (پیش‌فرض: 0)

--plain-http: مجاز شمردن اتصال‌ها با استفاده از HTTP ساده

--platform="": دریافت محتوا برای یک پلتفرم مشخص

--print-chainid: چاپ شناسه زنجیره (chain ID) تصویر حاصل

--refresh="": توکن نوسازی برای سرور احراز هویت

--skip-metadata: صرف‌نظر کردن از متاداده برای پلتفرم‌های استفاده‌نشده (ممکن است بعداً نتوان تصویر را بدون متاداده push کرد)

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

--sync-fs: همگام‌سازی سیستم‌فایل زیرین حاوی پرونده‌ها هنگام استخراج تصاویر، پیش‌فرض false

--tlscacert="": مسیر مرجع صدور گواهی ریشه TLS (CA)

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

ارسال (push) یک تصویر به یک مخزن راه دور

--allow-non-distributable-blobs: مجاز شمردن ارسال blobهایی که به عنوان غیرقابل توزیع علامت‌گذاری شده‌اند

--hosts-dir="": دایرکتوری سفارشی پیکربندی میزبان‌ها

--http-dump: تخلیه تمام درخواست‌ها و پاسخ‌های HTTP در حین تعامل با رجیستری کانتینر

--http-trace: فعال‌سازی ردگیری پروتکل HTTP برای تعامل با رجیستری

--local: ارسال محتوا از کلاینت محلی به جای استفاده از سرویس انتقال

--manifest="": دایجست مانیفست

--manifest-type="": نوع رسانه (mediatype) دایجست مانیفست (پیش‌فرض: "application/vnd.oci.image.manifest.v1+json")

--max-concurrent-uploaded-layers="": تنظیم حداکثر لایه‌های آپلود همزمان برای هر push (پیش‌فرض: 0)

--plain-http: مجاز شمردن اتصال‌ها با استفاده از HTTP ساده

--platform="": ارسال محتوا برای یک پلتفرم مشخص

--refresh="": توکن نوسازی برای سرور احراز هویت

--skip-verify, -k: صرف‌نظر کردن از اعتبارسنجی گواهی SSL

--tlscacert="": مسیر مرجع صدور گواهی ریشه TLS (CA)

--tlscert="": مسیر گواهی کلاینت TLS

--tlskey="": مسیر کلید اختصاصی کلاینت TLS

--user, -u="": نام‌کاربری[:گذرواژه] کاربری و رمز عبور رجیستری

پاک‌سازی تصاویر استفاده‌نشده

--all: حذف تمام تصاویر استفاده‌نشده، نه فقط تصاویر معلق (اگر all مشخص نشود هیچ تصویری پاک نمی‌شود)

حذف یک یا چند تصویر بر اساس ارجاع

--sync: حذف همگام تصویر و تمام منابع وابسته به آن

برچسب‌گذاری (تگ کردن) یک تصویر

--force: ایجاد اجباری target_ref، صرف‌نظر از اینکه قبلاً وجود دارد یا خیر

--local: اجرای تگ به صورت محلی به جای استفاده از API انتقال

--skip-reference-check: صرف‌نظر کردن از بررسی دقیق نام‌های ارجاع

تنظیم و پاک کردن برچسب‌ها برای یک تصویر

--replace-all, -r: جایگزینی تمام برچسب‌ها

تبدیل یک تصویر

--all-platforms: خروجی گرفتن از محتوای تمام پلتفرم‌ها

--erofs="": تبدیل لایه‌ها به فرمت EROFS، باید 'raw' یا 'zstd' را مشخص کنید (مانند --erofs raw, --erofs zstd)

--erofs-compressors="": مشخص کردن فهرست الگوریتم‌های فشرده‌سازی هنگام تبدیل لایه‌های EROFS

--erofs-mkfs-options="": گزینه‌های اضافی mkfs اعمال‌شده در هنگام تبدیل لایه‌های EROFS (مانند '-Efragments,dedupe')

--oci: تبدیل انواع رسانه داکر به انواع رسانه OCI

--platform="": دریافت محتوا برای یک پلتفرم مشخص

--uncompress: تبدیل لایه‌های tar.gz به لایه‌های tar غیرفشرده

نمایش میزان مصرف اسنپ‌شات‌ها برای ارجاع تصویر مشخص‌شده

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

مدیریت اجاره‌ها (leases)

فهرست کردن تمام اجاره‌های فعال

--quiet, -q: تنها دایجست blob چاپ شود

ایجاد یک اجاره جدید

--expires, -x="": زمان انقضای اجاره (مقدار 0 منقضی نخواهد شد) (پیش‌فرض: 24h0m0s)

--id="": تنظیم شناسه برای اجاره؛ به طور پیش‌فرض به صورت خودکار تولید می‌شود

حذف یک اجاره

--sync: حذف همگام اجاره‌ها و تمام منابع بدون ارجاع

مدیریت فضاهای نام (namespaces)

ایجاد یک فضای نام جدید

فهرست کردن فضاهای نام

--quiet, -q: تنها نام فضای نام چاپ شود

حذف یک یا چند فضای نام

--cgroup, -c: حذف cgroup مربوط به فضای نام

تنظیم و پاک کردن برچسب‌ها برای یک فضای نام

ارائه خروجی‌های pprof زبان Go برای containerd

--debug-socket, -d="": مسیر سوکت برای سرور اشکال‌زدایی containerd (پیش‌فرض: "/run/containerd/debug.sock")

پروفایل مسدودسازی گوروتین‌ها (Goroutine blocking profile)

--debug="": آرگومان‌های اشکال‌زدایی pprof (پیش‌فرض: 0)

تخلیه پشته گوروتین‌ها (stack dump)

--debug="": آرگومان‌های اشکال‌زدایی pprof (پیش‌فرض: 2)

تخلیه نمایه حافظه heap

--debug="": آرگومان‌های اشکال‌زدایی pprof (پیش‌فرض: 0)

نمایه مصرف پردازنده (CPU profile)

--debug="": آرگومان‌های اشکال‌زدایی pprof (پیش‌فرض: 0)

--seconds, -s="": مدت زمان جمع‌آوری بر حسب ثانیه (پیش‌فرض: 30s)

نمایه ایجاد ریسمان توسط گوروتین‌ها

--debug="": آرگومان‌های اشکال‌زدایی pprof (پیش‌فرض: 0)

جمع‌آوری ردگیری اجرای برنامه (execution trace)

--debug="": آرگومان‌های اشکال‌زدایی pprof (پیش‌فرض: 0)

--seconds, -s="": مدت زمان ردگیری بر حسب ثانیه (پیش‌فرض: 5s)

اجرای یک کانتینر

--allow-new-privs: غیرفعال کردن فلگ ویژگی NoNewPrivileges در مشخصات OCI

--annotation="": مشخص کردن حاشیه‌نویسی‌های اضافی OCI (برای نمونه foo=bar)

--apparmor-default-profile="": فعال‌سازی AppArmor با نمایه پیش‌فرض و نام مشخص‌شده، مانند "cri-containerd.apparmor.d"

--apparmor-profile="": فعال‌سازی AppArmor با نمایه سفارشی موجود

--blockio-class="": نام کلاس blockio برای پیوند دادن کانتینر به آن

--blockio-config-file="": مسیر فایل تعاریف کلاس blockio. به طور پیش‌فرض تعاریف کلاس بارگذاری نمی‌شوند.

--cap-add="": افزودن قابلیت‌های لینوکس (قابلیت‌ها را با پیشوند 'CAP_' مشخص کنید)

--cap-drop="": حذف قابلیت‌های لینوکس (قابلیت‌ها را با پیشوند 'CAP_' مشخص کنید)

--cgroup="": مسیر cgroup (برای غیرفعال‌سازی استفاده از cgroup، صراحتاً "" تنظیم کنید)

--cni: فعال‌سازی شبکه cni برای کانتینر

--config, -c="": مسیر فایل پیکربندی مشخصات خاص زمان اجرا

--cpu-period="": محدود کردن دوره CPU CFS (پیش‌فرض: 0)

--cpu-quota="": محدود کردن سهمیه CPU CFS (پیش‌فرض: -1)

--cpu-shares="": تنظیم سهم‌های پردازنده (cpu shares) (پیش‌فرض: 1024)

--cpus="": تنظیم سهمیه CPU CFS (پیش‌فرض: 0)

--cpuset-cpus="": تنظیم هسته‌های پردازنده‌ای که کانتینر در آن‌ها اجرا می‌شود (مانند 1-2,4)

--cpuset-mems="": تنظیم گره‌های حافظه‌ای که کانتینر در آن‌ها اجرا می‌شود (مانند 1-2,4)

--cwd="": مشخص کردن دایرکتوری کاری فرآیند

--detach, -d: جدا شدن از فرآیند وظیفه پس از آغاز اجرا؛ همراه با --rm قابل استفاده نیست

--device="": مسیر فایل دستگاه برای افزودن به کانتینر، یا مسیری به درخت دایرکتوری دستگاه‌ها جهت افزودن به کانتینر

--dump-config="": تخلیه پیکربندی تولیدشده OCI در یک فایل

--env="": مشخص کردن متغیرهای محیطی اضافی کانتینر (برای نمونه FOO=bar)

--env-file="": مشخص کردن متغیرهای محیطی اضافی کانتینر در یک فایل (برای نمونه FOO=bar، هر متغیر در یک خط)

--fifo-dir="": دایرکتوری مورد استفاده برای ذخیره‌سازی لوله‌های FIFO ورودی/خروجی

--gidmap="": اجرا درون فضای نام کاربری با دامنه‌های نگاشت GID مشخص‌شده؛ با قالب container-gid:host-gid:length مشخص می‌شود

--gpus="": افزودن کارت‌های گرافیک (GPU) به کانتینر

--hostname="": تنظیم نام میزبان کانتینر

--label="": مشخص کردن برچسب‌های اضافی (برای نمونه foo=bar)

--log-uri="": نشانی URI گزارش‌گیری

--memory-limit="": محدودیت حافظه (به بایت) برای کانتینر (پیش‌فرض: 0)

--mount="": مشخص کردن مانت‌های اضافی برای کانتینر (برای نمونه type=bind,src=/tmp,dst=/host,options=rbind:ro)

--net-host: فعال‌سازی شبکه میزبان برای کانتینر

--no-pivot: غیرفعال کردن استفاده از pivot-root (ویژه لینوکس)

--null-io: ارسال تمام داده‌های ورودی/خروجی به dev/null/

--pid-file="": مسیر فایل برای ثبت شناسه فرآیند (PID) وظیفه

--platform="": اجرای تصویر برای یک پلتفرم مشخص

--privileged: اجرای کانتینر ممتاز (دارای دسترسی‌های ریشه کامل)

--privileged-without-host-devices: عدم انتقال تمام دستگاه‌های میزبان به کانتینر ممتاز

--rdt-class="": نام کلاس RDT برای پیوند دادن کانتینر به آن. تعیین‌کننده Class of Service (CLOS) برای مدیریت پهنای باند حافظه و کش.

--read-only: تنظیم سیستم‌فایل کانتینر به صورت فقط‌خواندنی

--remap-labels: ارائه بازنگاشت شناسه فضای نام کاربر به snapshotter از طریق گزینه‌های برچسب؛ نیازمند پشتیبانی snapshotter است

--rlimit-nofile="": تنظیم RLIMIT_NOFILE به صورت (soft:hard)

--rm: حذف کانتینر پس از اجرا؛ همراه با --detach قابل استفاده نیست

--rootfs: استفاده از روت‌اف‌اس سفارشی که توسط snapshotter دیمن containerd مدیریت نمی‌شود

--rootfs-propagation="": تنظیم انتشار (propagation) روت‌اف‌اس کانتینر

--runc-binary="": مشخص کردن فایل باینری سازگار با runc

--runc-root="": مشخص کردن دایرکتوری ریشه سازگار با runc

--runc-systemd-cgroup: اجرای runc با مدیر cgroup متعلق به systemd

--runtime="": نام زمان اجرا یا مسیر مطلق به باینری زمان اجرا (پیش‌فرض: "io.containerd.runc.v2")

--runtime-config-path="": مسیر اختیاری فایل پیکربندی runtime

--sandbox="": ایجاد کانتینر درون سندباکس مشخص‌شده

--seccomp: فعال‌سازی نمایه (پروفایل) پیش‌فرض seccomp

--seccomp-profile="": مسیر فایل نمایه سفارشی seccomp. پیش از استفاده از seccomp-profile، گزینه seccomp باید روی true تنظیم شود

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

--snapshotter-label="": برچسب‌های اضافه‌شونده به اسنپ‌شات جدید برای این کانتینر.

--sync-fs: همگام‌سازی سیستم‌فایل زیرین حاوی پرونده‌ها هنگام استخراج تصاویر، پیش‌فرض false

--tty, -t: تخصیص یک ترمینال مجازی (TTY) برای کانتینر

--uidmap="": اجرا درون یک فضای نام کاربری با دامنه‌های نگاشت UID مشخص‌شده؛ با فرمت container-uid:host-uid:length مشخص می‌شود

--user, -u="": نام کاربری یا شناسه کاربری، گروه اختیاری است (قالب: [کاربر:گروه])

--with-ns="": مشخص کردن فضاهای نام موجود لینوکس برای پیوستن در زمان اجرای کانتینر (قالب 'فضای‌نام:مسیر')

مدیریت اسنپ‌شات‌ها

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

ثبت (commit) یک اسنپ‌شات فعال تحت نام ارائه‌شده

دریافت تفاوت (diff) میان دو اسنپ‌شات؛ به طور پیش‌فرض اسنپ‌شات دوم والد اسنپ‌شات اول است

--keep: نگهداری محتوای تفاوت؛ حذف آن بر عهده ایجادکننده خواهد بود

--label="": برچسب‌هایی برای الصاق به تصویر

--media-type="": نوع رسانه مورد استفاده برای ایجاد تفاوت (پیش‌فرض: "application/vnd.oci.image.layer.v1.tar+gzip")

--ref="": ارجاع آپلود محتوا جهت استفاده

دریافت اطلاعات درباره یک اسنپ‌شات

فهرست کردن اسنپ‌شات‌ها

دریافت دستورات مانت برای اسنپ‌شات‌ها

--temp: اتصال اسنپ‌شات‌ها به عنوان یک مانت موقت و بازگرداندن یک bind mount

آماده‌سازی یک اسنپ‌شات از روی یک اسنپ‌شات تثبیت‌شده (committed)

--mounts: چاپ نقاط مانت اسنپ‌شات به صورت JSON

--target, -t="": مسیر هدف مانت؛ در صورت ارائه، مانت را چاپ می‌کند

حذف اسنپ‌شات‌ها

افزودن برچسب‌ها به محتوا

نمایش ساختار درختی شاخه‌های اسنپ‌شات

استخراج و اعمال لایه‌ها از یک مانیفست بر روی یک اسنپ‌شات

--snapshotter="": نام snapshotter. مقدار خالی نشان‌دهنده مقدار پیش‌فرض است.

--sync-fs: همگام‌سازی سیستم‌فایل زیرین حاوی پرونده‌ها هنگام استخراج تصاویر، پیش‌فرض false

نمایش میزان مصرف اسنپ‌شات‌ها

-b: نمایش اندازه بر حسب بایت

ایجاد یک اسنپ‌شات فقط‌خواندنی از روی یک اسنپ‌شات تثبیت‌شده

--mounts: چاپ نقاط مانت اسنپ‌شات به صورت JSON

--target, -t="": مسیر هدف مانت؛ در صورت ارائه، مانت را چاپ می‌کند

مدیریت وظایف (tasks)

پیوستن به ورودی/خروجی (IO) یک کانتینر در حال اجرا

ایجاد چک‌پوینت از یک کانتینر

--exit: متوقف کردن کانتینر پس از ایجاد چک‌پوینت

--image-path="": مسیر فایل‌های تصویر criu

--work-path="": مسیر فایل‌های کاری و گزارش‌های criu

حذف یک یا چند وظیفه

--exec-id="": شناسه فرآیند (PID) برای خاتمه دادن

--force, -f: حذف اجباری فرآیند وظیفه

اجرای فرآیندهای اضافی درون یک کانتینر موجود

--cwd="": دایرکتوری کاری فرآیند جدید

--detach, -d: جدا شدن از وظیفه پس از آغاز اجرای آن

--exec-id="": شناسه اختصاصی exec برای فرآیند

--fifo-dir="": دایرکتوری مورد استفاده برای ذخیره‌سازی لوله‌های FIFO ورودی/خروجی

--log-uri="": نشانی URI گزارش‌گیری سفارشی برای shim

--tty, -t: تخصیص یک ترمینال مجازی (TTY) برای کانتینر

--user="": شناسه یا نام کاربری

فهرست کردن وظایف

--quiet, -q: تنها شناسه وظیفه چاپ شود

ارسال سیگنال به یک کانتینر (پیش‌فرض: SIGTERM)

--all, -a: ارسال سیگنال به تمام فرآیندهای درون کانتینر

--exec-id="": شناسه فرآیند جهت ارسال سیگنال خاتمه

--signal, -s="": سیگنال ارسالی به کانتینر

دریافت یک نقطه داده از سنجه‌ها برای یک وظیفه با محیط زمان اجرای توکار لینوکس

--format="": فرمت خروجی "table" یا "json" (پیش‌فرض: "table")

مکث موقت (pause) یک کانتینر موجود

فهرست کردن فرآیندهای مربوط به یک کانتینر

از سرگیری اجرای یک کانتینر مکث‌شده

شروع یک کانتینر ایجادشده

--detach, -d: جدا شدن از فرآیند وظیفه پس از آغاز اجرا

--fifo-dir="": دایرکتوری مورد استفاده برای ذخیره‌سازی لوله‌های FIFO ورودی/خروجی

--log-uri="": نشانی URI گزارش‌گیری

--no-pivot: غیرفعال کردن استفاده از pivot-root (ویژه لینوکس)

--null-io: ارسال تمام داده‌های ورودی/خروجی به dev/null/

--pid-file="": مسیر فایل برای ثبت شناسه فرآیند (PID) وظیفه

نصب یک بسته جدید

--libs, -l: نصب کتابخانه‌ها از تصویر

--path="": تنظیم مسیر نصب اختیاری به جز دایرکتوری مدیریت‌شده opt

--replace, -r: جایگزینی هرگونه فایل باینری یا کتابخانه موجود در دایرکتوری opt

ابزارهای OCI

مشاهده خروجی مشخصات پیش‌فرض OCI

--platform="": پلتفرم مشخصاتی که باید چاپ شود (مانند: 'linux/arm64'، 'windows/amd64')

مدیریت سندباکس‌ها

اجرای یک سندباکس جدید

--runtime="": نام زمان اجرا (پیش‌فرض: "io.containerd.runc.v2")

فهرست کردن سندباکس‌ها

--filters="": فهرست فیلترهای اعمال‌شده هنگام جستجوی سندباکس‌ها از مخزن ذخیره‌سازی

حذف سندباکس‌ها

--force, -f: نادیده گرفتن خطاهای خاموشی هنگام حذف سندباکس

دریافت اطلاعات درباره یک سندباکس

چاپ اطلاعات سرور containerd

چاپ هشدارهای مربوط به قابلیت‌های منسوخ‌شده

--format="": فرمت خروجی مورد استفاده (مانند: 'default'، 'json')

تعامل مستقیم با shim

--id="": شناسه shim

--shim-address="": نشانی shim (پیش‌فرض: محاسبه‌شده از روی شناسه shim)

حذف یک کانتینر به همراه یک وظیفه

اجرای یک فرآیند جدید درون کانتینرِ وظیفه

--attach, -a: ماندن در وضعیت متصل به کانتینر و باز کردن fifos

--cwd="": دایرکتوری کاری جاری

--env, -e="": افزودن متغیرهای محیطی

--spec="": مشخصات زمان اجرا (runtime spec)

--stderr="": مشخص کردن مسیر لوله fifo برای stderr

--stdin="": مشخص کردن مسیر لوله fifo برای stdin

--stdout="": مشخص کردن مسیر لوله fifo برای stdout

--tty, -t: فعال‌سازی پشتیبانی از ترمینال TTY

شروع یک کانتینر به همراه یک وظیفه

دریافت وضعیت تمام فرآیندهای اصلی وظیفه

--api-version="": نسخه shim API مقادیر {2,3} (پیش‌فرض: 3)

--task-id, -t="": شناسه وظیفه

خاموش کردن shim در صورتی که کانتینر فعالی وجود نداشته باشد

--api-version="": نسخه shim API مقادیر {2,3} (پیش‌فرض: 3)

ارائه خروجی‌های pprof زبان Go برای containerd-shim

پروفایل مسدودسازی گوروتین‌ها (Goroutine blocking profile)

--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیش‌فرض: 0)

چاپ تخلیه پشته گوروتین‌ها

--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیش‌فرض: 2)

تخلیه نمایه حافظه heap

--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیش‌فرض: 0)

نمایه مصرف پردازنده (CPU profile)

--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیش‌فرض: 0)

--seconds, -s="": مدت زمان جمع‌آوری بر حسب ثانیه (پیش‌فرض: 30s)

نمایه ایجاد ریسمان توسط گوروتین‌ها

--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیش‌فرض: 0)

جمع‌آوری ردگیری اجرای برنامه (execution trace)

--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیش‌فرض: 0)

--seconds, -s="": مدت زمان ردگیری بر حسب ثانیه (پیش‌فرض: 5s)

راهنمای containerd Containerd