| ctr(8) | راهنمای لینوکس | ctr(8) |
نام (NAME)
ctr - کلاینت خط فرمان مدیریتی و اشکالزدایی برای دیمن containerd
خلاصه دستور (SYNOPSIS)
ctr
[--address|-a]=[value] [--connect-timeout]=[value] [--debug] [--namespace|-n]=[value] [--timeout]=[value]
توضیحات (DESCRIPTION)
دستور ctr یک کلاینت غیررسمی برای اشکالزدایی و مدیریت به منظور تعامل با دیمن containerd است. از آنجا که این ابزار به طور رسمی پشتیبانی نمیشود، هیچ تضمینی وجود ندارد که دستورات، گزینهها و عملیات آن در نسخههای مختلف پروژه containerd دارای سازگاری عقبرو یا پایداری باشند.
نحوه استفاده (Usage):
ctr [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]
گزینههای عمومی (GLOBAL OPTIONS)
--address, -a="": نشانی سرور GRPC مربوط به containerd (پیشفرض: "/run/containerd/containerd.sock")
--connect-timeout="": مهلت زمانی برقراری اتصال به containerd (پیشفرض: 0s)
--debug: فعالسازی خروجی اشکالزدایی در گزارشها
--namespace, -n="": فضای نام مورد استفاده برای دستورات (پیشفرض: "default")
--timeout="": مهلت زمانی کل برای دستورات ctr (پیشفرض: 0s)
دستورات (COMMANDS)
plugins, plugin
ارائه اطلاعات درباره پلاگینهای containerd
list, ls
فهرست کردن پلاگینهای containerd
--detailed, -d: چاپ اطلاعات دقیق درباره هر پلاگین
--quiet, -q: تنها شناسههای پلاگین چاپ شوند
inspect-runtime
نمایش اطلاعات محیط زمان اجرا (runtime)
--runc-binary="": مشخص کردن فایل باینری سازگار با runc
--runc-root="": مشخص کردن دایرکتوری ریشه سازگار با runc
--runc-systemd-cgroup: شروع runc با مدیر گروه کنترلی systemd (cgroup)
--runtime="": نام زمان اجرا یا مسیر مطلق به باینری runtime (پیشفرض: "io.containerd.runc.v2")
--runtime-config-path="": مسیر اختیاری پیکربندی runtime
نسخه (VERSION)
چاپ نسخه کلاینت و سرور
containers, c, container
مدیریت کانتینرها
create
ایجاد کانتینر جدید
--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="": مشخص کردن فضاهای نام موجود لینوکس برای پیوستن در زمان اجرای کانتینر (قالب 'فضاینام:مسیر')
delete, del, remove, rm
حذف یک یا چند کانتینر موجود
--keep-snapshot: عدم پاکسازی اسنپشات همراه با حذف کانتینر
info
دریافت اطلاعات درباره یک کانتینر
--spec: تنها مشخصات (spec) نمایش داده شود
list, ls
فهرست کردن کانتینرها
--quiet, -q: تنها شناسه کانتینر چاپ شود
label
تنظیم و پاک کردن برچسبها برای یک کانتینر
checkpoint
ایجاد چکپوینت از یک کانتینر
--image: گنجاندن تصویر در چکپوینت
--rw: گنجاندن لایه خواندن/نوشتن در چکپوینت
--task: ایجاد چکپوینت از وظیفه (task) کانتینر
restore
بازیابی یک کانتینر از روی چکپوینت
--live: بازیابی دادههای زمان اجرا و حافظه از چکپوینت
--rw: بازیابی لایه خواندن/نوشتن از چکپوینت
content
مدیریت محتوا
active
نمایش انتقالهای فعال
--root="": مسیر ریشه ذخیرهسازی محتوا (پیشفرض: "/tmp/content")
--timeout, -t="": مهلت زمانی کل برای عملیات واکشی (پیشفرض: 0s)
delete, del, remove, rm
حذف دائمی یک یا چند blob
edit
ویرایش یک blob و برگرداندن یک دایجست جدید
--editor="": انتخاب ویرایشگر متنی (مانند vim، emacs و غیره)
--validate="": اعتبارسنجی نتیجه در برابر یک فرمت مشخص (مانند json، mediatype و غیره)
fetch
واکشی تمام محتوای یک تصویر به درون 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="": نامکاربری[:گذرواژه] کاربری و رمز عبور رجیستری
fetch-object
بازیابی شیءها (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="": نامکاربری[:گذرواژه] کاربری و رمز عبور رجیستری
fetch-blob
بازیابی دادههای باینری (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="": نامکاربری[:گذرواژه] کاربری و رمز عبور رجیستری
get
دریافت دادههای یک شیء
ingest
پذیرش و درج محتوا در مخزن ذخیرهسازی
--expected-digest="": اعتبارسنجی محتوا در برابر دایجست مورد انتظار
--expected-size="": اعتبارسنجی محتوا در برابر اندازه ارائهشده (پیشفرض: 0)
list, ls
فهرست کردن تمام blobها در مخزن ذخیرهسازی
--quiet, -q: تنها دایجست blob چاپ شود
push-object
ارسال (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="": نامکاربری[:گذرواژه] کاربری و رمز عبور رجیستری
label
افزودن برچسبها به محتوا
prune
هرس و پاکسازی محتوای اضافه از مخزن محتوا
references
هرس برچسبهای ترجیحی از مخزن محتوا (به طور پیشفرض فقط لایهها)
--async: اجازه به فرآیند بازیافت حافظه (garbage collection) برای پاکسازی غیرهمگام
--dry: تنها نمایش بهروزرسانیها بدون اعمال تغییرات واقعی (فعالسازی گزارش اشکالزدایی)
events, event
نمایش رخدادهای containerd
images, image, i
مدیریت تصاویر
check
بررسی تصاویر موجود برای اطمینان از در دسترس بودن محلی همه دادهها
--quiet, -q: تنها چاپ ارجاعات تصاویر آماده (به طور کامل دانلود و استخراجشده)
--snapshotter="": نام snapshotter. مقدار خالی نشاندهنده مقدار پیشفرض است.
export
خروجی گرفتن از تصاویر
--all-platforms: خروجی گرفتن از محتوای تمام پلتفرمها
--local: اجرای خروجی به صورت محلی به جای استفاده از API انتقال
--platform="": دریافت محتوا برای یک پلتفرم خاص
--skip-manifest-json: عدم افزودن فایل سازگار با داکر manifest.json به آرشیو
--skip-non-distributable: عدم افزودن blobهای غیرقابل توزیع مانند لایههای ویندوز به آرشیو
import
وارد کردن (ایمپورت) تصاویر
--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
inspect, i
بازبینی و بررسی یک تصویر
--content: نمایش محتوای JSON
list, ls
فهرست کردن تصاویر شناختهشده برای containerd
--quiet, -q: تنها چاپ ارجاعات تصاویر
mount
متصل کردن (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
قطع اتصال (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
دریافت (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
ارسال (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="": نامکاربری[:گذرواژه] کاربری و رمز عبور رجیستری
prune
پاکسازی تصاویر استفادهنشده
--all: حذف تمام تصاویر استفادهنشده، نه فقط تصاویر معلق (اگر all مشخص نشود هیچ تصویری پاک نمیشود)
delete, del, remove, rm
حذف یک یا چند تصویر بر اساس ارجاع
--sync: حذف همگام تصویر و تمام منابع وابسته به آن
tag
برچسبگذاری (تگ کردن) یک تصویر
--force: ایجاد اجباری target_ref، صرفنظر از اینکه قبلاً وجود دارد یا خیر
--local: اجرای تگ به صورت محلی به جای استفاده از API انتقال
--skip-reference-check: صرفنظر کردن از بررسی دقیق نامهای ارجاع
label
تنظیم و پاک کردن برچسبها برای یک تصویر
--replace-all, -r: جایگزینی تمام برچسبها
convert
تبدیل یک تصویر
--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 غیرفشرده
usage
نمایش میزان مصرف اسنپشاتها برای ارجاع تصویر مشخصشده
--snapshotter="": نام snapshotter. مقدار خالی نشاندهنده مقدار پیشفرض است.
leases
مدیریت اجارهها (leases)
list, ls
فهرست کردن تمام اجارههای فعال
--quiet, -q: تنها دایجست blob چاپ شود
create
ایجاد یک اجاره جدید
--expires, -x="": زمان انقضای اجاره (مقدار 0 منقضی نخواهد شد) (پیشفرض: 24h0m0s)
--id="": تنظیم شناسه برای اجاره؛ به طور پیشفرض به صورت خودکار تولید میشود
delete, del, remove, rm
حذف یک اجاره
--sync: حذف همگام اجارهها و تمام منابع بدون ارجاع
namespaces, namespace, ns
مدیریت فضاهای نام (namespaces)
create, c
ایجاد یک فضای نام جدید
list, ls
فهرست کردن فضاهای نام
--quiet, -q: تنها نام فضای نام چاپ شود
remove, rm
حذف یک یا چند فضای نام
--cgroup, -c: حذف cgroup مربوط به فضای نام
label
تنظیم و پاک کردن برچسبها برای یک فضای نام
pprof
ارائه خروجیهای pprof زبان Go برای containerd
--debug-socket, -d="": مسیر سوکت برای سرور اشکالزدایی containerd (پیشفرض: "/run/containerd/debug.sock")
block
پروفایل مسدودسازی گوروتینها (Goroutine blocking profile)
--debug="": آرگومانهای اشکالزدایی pprof (پیشفرض: 0)
goroutines
تخلیه پشته گوروتینها (stack dump)
--debug="": آرگومانهای اشکالزدایی pprof (پیشفرض: 2)
heap
تخلیه نمایه حافظه heap
--debug="": آرگومانهای اشکالزدایی pprof (پیشفرض: 0)
profile
نمایه مصرف پردازنده (CPU profile)
--debug="": آرگومانهای اشکالزدایی pprof (پیشفرض: 0)
--seconds, -s="": مدت زمان جمعآوری بر حسب ثانیه (پیشفرض: 30s)
threadcreate
نمایه ایجاد ریسمان توسط گوروتینها
--debug="": آرگومانهای اشکالزدایی pprof (پیشفرض: 0)
trace
جمعآوری ردگیری اجرای برنامه (execution trace)
--debug="": آرگومانهای اشکالزدایی pprof (پیشفرض: 0)
--seconds, -s="": مدت زمان ردگیری بر حسب ثانیه (پیشفرض: 5s)
run
اجرای یک کانتینر
--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="": مشخص کردن فضاهای نام موجود لینوکس برای پیوستن در زمان اجرای کانتینر (قالب 'فضاینام:مسیر')
snapshots, snapshot
مدیریت اسنپشاتها
--snapshotter="": نام snapshotter. مقدار خالی نشاندهنده مقدار پیشفرض است.
commit
ثبت (commit) یک اسنپشات فعال تحت نام ارائهشده
diff
دریافت تفاوت (diff) میان دو اسنپشات؛ به طور پیشفرض اسنپشات دوم والد اسنپشات اول است
--keep: نگهداری محتوای تفاوت؛ حذف آن بر عهده ایجادکننده خواهد بود
--label="": برچسبهایی برای الصاق به تصویر
--media-type="": نوع رسانه مورد استفاده برای ایجاد تفاوت (پیشفرض: "application/vnd.oci.image.layer.v1.tar+gzip")
--ref="": ارجاع آپلود محتوا جهت استفاده
info
دریافت اطلاعات درباره یک اسنپشات
list, ls
فهرست کردن اسنپشاتها
mounts, m, mount
دریافت دستورات مانت برای اسنپشاتها
--temp: اتصال اسنپشاتها به عنوان یک مانت موقت و بازگرداندن یک bind mount
prepare
آمادهسازی یک اسنپشات از روی یک اسنپشات تثبیتشده (committed)
--mounts: چاپ نقاط مانت اسنپشات به صورت JSON
--target, -t="": مسیر هدف مانت؛ در صورت ارائه، مانت را چاپ میکند
delete, del, remove, rm
حذف اسنپشاتها
label
افزودن برچسبها به محتوا
tree
نمایش ساختار درختی شاخههای اسنپشات
unpack
استخراج و اعمال لایهها از یک مانیفست بر روی یک اسنپشات
--snapshotter="": نام snapshotter. مقدار خالی نشاندهنده مقدار پیشفرض است.
--sync-fs: همگامسازی سیستمفایل زیرین حاوی پروندهها هنگام استخراج تصاویر، پیشفرض false
usage
نمایش میزان مصرف اسنپشاتها
-b: نمایش اندازه بر حسب بایت
view
ایجاد یک اسنپشات فقطخواندنی از روی یک اسنپشات تثبیتشده
--mounts: چاپ نقاط مانت اسنپشات به صورت JSON
--target, -t="": مسیر هدف مانت؛ در صورت ارائه، مانت را چاپ میکند
tasks, t, task
مدیریت وظایف (tasks)
attach
پیوستن به ورودی/خروجی (IO) یک کانتینر در حال اجرا
checkpoint
ایجاد چکپوینت از یک کانتینر
--exit: متوقف کردن کانتینر پس از ایجاد چکپوینت
--image-path="": مسیر فایلهای تصویر criu
--work-path="": مسیر فایلهای کاری و گزارشهای criu
delete, del, remove, rm
حذف یک یا چند وظیفه
--exec-id="": شناسه فرآیند (PID) برای خاتمه دادن
--force, -f: حذف اجباری فرآیند وظیفه
exec
اجرای فرآیندهای اضافی درون یک کانتینر موجود
--cwd="": دایرکتوری کاری فرآیند جدید
--detach, -d: جدا شدن از وظیفه پس از آغاز اجرای آن
--exec-id="": شناسه اختصاصی exec برای فرآیند
--fifo-dir="": دایرکتوری مورد استفاده برای ذخیرهسازی لولههای FIFO ورودی/خروجی
--log-uri="": نشانی URI گزارشگیری سفارشی برای shim
--tty, -t: تخصیص یک ترمینال مجازی (TTY) برای کانتینر
--user="": شناسه یا نام کاربری
list, ls
فهرست کردن وظایف
--quiet, -q: تنها شناسه وظیفه چاپ شود
kill
ارسال سیگنال به یک کانتینر (پیشفرض: SIGTERM)
--all, -a: ارسال سیگنال به تمام فرآیندهای درون کانتینر
--exec-id="": شناسه فرآیند جهت ارسال سیگنال خاتمه
--signal, -s="": سیگنال ارسالی به کانتینر
metrics, metric
دریافت یک نقطه داده از سنجهها برای یک وظیفه با محیط زمان اجرای توکار لینوکس
--format="": فرمت خروجی "table" یا "json" (پیشفرض: "table")
pause
مکث موقت (pause) یک کانتینر موجود
ps
فهرست کردن فرآیندهای مربوط به یک کانتینر
resume
از سرگیری اجرای یک کانتینر مکثشده
start
شروع یک کانتینر ایجادشده
--detach, -d: جدا شدن از فرآیند وظیفه پس از آغاز اجرا
--fifo-dir="": دایرکتوری مورد استفاده برای ذخیرهسازی لولههای FIFO ورودی/خروجی
--log-uri="": نشانی URI گزارشگیری
--no-pivot: غیرفعال کردن استفاده از pivot-root (ویژه لینوکس)
--null-io: ارسال تمام دادههای ورودی/خروجی به dev/null/
--pid-file="": مسیر فایل برای ثبت شناسه فرآیند (PID) وظیفه
install
نصب یک بسته جدید
--libs, -l: نصب کتابخانهها از تصویر
--path="": تنظیم مسیر نصب اختیاری به جز دایرکتوری مدیریتشده opt
--replace, -r: جایگزینی هرگونه فایل باینری یا کتابخانه موجود در دایرکتوری opt
oci
ابزارهای OCI
spec
مشاهده خروجی مشخصات پیشفرض OCI
--platform="": پلتفرم مشخصاتی که باید چاپ شود (مانند: 'linux/arm64'، 'windows/amd64')
sandboxes, sandbox, sb, s
مدیریت سندباکسها
run, create, c, r
اجرای یک سندباکس جدید
--runtime="": نام زمان اجرا (پیشفرض: "io.containerd.runc.v2")
list, ls
فهرست کردن سندباکسها
--filters="": فهرست فیلترهای اعمالشده هنگام جستجوی سندباکسها از مخزن ذخیرهسازی
remove, rm
حذف سندباکسها
--force, -f: نادیده گرفتن خطاهای خاموشی هنگام حذف سندباکس
info, i
دریافت اطلاعات درباره یک سندباکس
info
چاپ اطلاعات سرور containerd
deprecations
list
چاپ هشدارهای مربوط به قابلیتهای منسوخشده
--format="": فرمت خروجی مورد استفاده (مانند: 'default'، 'json')
shim
تعامل مستقیم با shim
--id="": شناسه shim
--shim-address="": نشانی shim (پیشفرض: محاسبهشده از روی شناسه shim)
delete
حذف یک کانتینر به همراه یک وظیفه
exec
اجرای یک فرآیند جدید درون کانتینرِ وظیفه
--attach, -a: ماندن در وضعیت متصل به کانتینر و باز کردن fifos
--cwd="": دایرکتوری کاری جاری
--env, -e="": افزودن متغیرهای محیطی
--spec="": مشخصات زمان اجرا (runtime spec)
--stderr="": مشخص کردن مسیر لوله fifo برای stderr
--stdin="": مشخص کردن مسیر لوله fifo برای stdin
--stdout="": مشخص کردن مسیر لوله fifo برای stdout
--tty, -t: فعالسازی پشتیبانی از ترمینال TTY
start
شروع یک کانتینر به همراه یک وظیفه
state
دریافت وضعیت تمام فرآیندهای اصلی وظیفه
--api-version="": نسخه shim API مقادیر {2,3} (پیشفرض: 3)
--task-id, -t="": شناسه وظیفه
shutdown
خاموش کردن shim در صورتی که کانتینر فعالی وجود نداشته باشد
--api-version="": نسخه shim API مقادیر {2,3} (پیشفرض: 3)
pprof
ارائه خروجیهای pprof زبان Go برای containerd-shim
block
پروفایل مسدودسازی گوروتینها (Goroutine blocking profile)
--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیشفرض: 0)
goroutines
چاپ تخلیه پشته گوروتینها
--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیشفرض: 2)
heap
تخلیه نمایه حافظه heap
--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیشفرض: 0)
profile
نمایه مصرف پردازنده (CPU profile)
--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیشفرض: 0)
--seconds, -s="": مدت زمان جمعآوری بر حسب ثانیه (پیشفرض: 30s)
threadcreate
نمایه ایجاد ریسمان توسط گوروتینها
--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیشفرض: 0)
trace
جمعآوری ردگیری اجرای برنامه (execution trace)
--debug="": فرمت خروجی؛ مقدار 0: باینری، مقدار > 0: متن ساده (پیشفرض: 0)
--seconds, -s="": مدت زمان ردگیری بر حسب ثانیه (پیشفرض: 5s)
| راهنمای containerd | Containerd |