runc(8) System Manager's Manual runc(8)

runc - زمان‌بند اجرای ابتکار کانتینر باز (OCI)

runc [global-option ...] command [command-option ...] [argument ...]

دستور runc یک کلاینت خط فرمان برای اجرای برنامه‌های بسته‌بندی‌شده طبق قالب Open Container Initiative (OCI) است و یک پیاده‌سازی سازگار با مشخصات OCI به‌شمار می‌رود.

دستور runc به‌خوبی با ناظران پردازش (process supervisors) موجود ادغام می‌شود تا یک محیط زمان اجرای کانتینر در سطح محصول برای برنامه‌ها فراهم آورد. می‌توان از آن در کنار ابزارهای نظارت بر پردازش فعلی خود استفاده کرد و کانتینر به‌صورت فرزند مستقیم ناظر پردازش ایجاد خواهد شد.

کانتینرها با استفاده از بسته‌ها (bundles) پیکربندی می‌شوند. یک بسته برای یک کانتینر، دایرکتوری‌ای است که شامل یک فایل مشخصات به نام config.json و یک فایل‌سیستم ریشه است. فایل‌سیستم ریشه شامل محتویات کانتینر است.

برای اجرای یک نمونه جدید از کانتینر:

# runc run [ -b bundle ] container-id

که در آن container-id نام شما برای نمونه کانتینری است که شروع می‌کنید. نامی که برای نمونه کانتینر ارائه می‌دهید باید روی میزبان شما یکتا باشد.

ارائه دایرکتوری بسته با استفاده از -b اختیاری است. مقدار پیش‌فرض برای bundle دایرکتوری جاری است.

از کانتینر در حال اجرا یک نقطه بازرسی (checkpoint) تهیه می‌کند. به runc-checkpoint(8) مراجعه کنید.
یک کانتینر ایجاد می‌کند. به runc-create(8) مراجعه کنید.
تمام منابع نگه‌داشته‌شده توسط کانتینر را حذف می‌کند؛ اغلب با کانتینرهای جداشده (detached) استفاده می‌شود. به runc-delete(8) مراجعه کنید.
رویدادهای کانتینر مانند اعلان‌های OOM، آمار پردازنده (CPU)، حافظه، ورودی/خروجی (I/O) و شبکه را نمایش می‌دهد. به runc-events(8) مراجعه کنید.
یک پردازش جدید درون کانتینر اجرا می‌کند. به runc-exec(8) مراجعه کنید.
یک سیگنال مشخص‌شده به پردازش آغازین (init) کانتینر ارسال می‌کند. به runc-kill(8) مراجعه کنید.
کانتینرهای شروع‌شده توسط runc را با --root داده‌شده فهرست می‌کند. به runc-list(8) مراجعه کنید.
تمام پردازش‌های درون کانتینر را معلق می‌کند. به runc-pause(8) مراجعه کنید.
پردازش‌های در حال اجرا درون کانتینر را نمایش می‌دهد. به runc-ps(8) مراجعه کنید.
یک کانتینر را از یک نقطه بازرسی قبلی بازیابی می‌کند. به runc-restore(8) مراجعه کنید.
تمام پردازش‌هایی را که قبلاً متوقف شده‌اند از سر می‌گیرد. به runc-resume(8) مراجعه کنید.
یک کانتینر را ایجاد و راه‌اندازی می‌کند. به runc-run(8) مراجعه کنید.
یک فایل مشخصات جدید (config.json) ایجاد می‌کند. به runc-spec(8) مراجعه کنید.
کانتینری را که قبلاً توسط runc create ایجاد شده است، راه‌اندازی می‌کند. به runc-start(8) مراجعه کنید.
وضعیت کانتینر را نشان می‌دهد. به runc-state(8) مراجعه کنید.
محدودیت‌های منابع کانتینر را به‌روزرسانی می‌کند. به runc-update(8) مراجعه کنید.
فهرست دستورات یا راهنمای یک دستور خاص را نشان می‌دهد.

این گزینه‌ها می‌توانند با هر دستوری استفاده شوند و باید قبل از command بیایند.

ثبت لاگ‌های اشکال‌زدایی را فعال می‌کند.
مقصد لاگ را روی path تنظیم می‌کند. پیش‌فرض ارسال به خروجی خطای استاندارد (stderr) است.
قالب لاگ را تعیین می‌کند (پیش‌فرض text است).
دایرکتوری ریشه را برای ذخیره وضعیت کانتینرها تنظیم می‌کند. مقدار path باید روی tmpfs قرار گیرد. پیش‌فرض /run/runc، یا $XDG_RUNTIME_DIR/runc برای کانتینرهای بدون ریشه (rootless) است.
پشتیبانی از cgroup سیستم‌دی را فعال می‌کند. در صورت فعال بودن، انتظار می‌رود که مشخصات کانتینر (config.json) حاوی مقدار cgroupsPath در قالب slice:prefix:name باشد (مانند system.slice:runc:434234).
حالت بدون ریشه (rootless) را فعال یا غیرفعال می‌کند. پیش‌فرض auto است، به این معنی که فعال بودن حالت بدون ریشه به‌صورت خودکار تشخیص داده می‌شود.
راهنما را نمایش می‌دهد.
نسخه را نمایش می‌دهد.

runc-checkpoint(8), runc-create(8), runc-delete(8), runc-events(8), runc-exec(8), runc-kill(8), runc-list(8), runc-pause(8), runc-ps(8), runc-restore(8), runc-resume(8), runc-run(8), runc-spec(8), runc-start(8), runc-state(8), runc-update(8).