.nh
.TH /etc/containerd/config.toml 5 04/05/2022
.SH "نام (NAME)"
containerd-config.toml \- پرونده پیکربندی containerd

.SH "خلاصه دستور (SYNOPSIS)"
پرونده
.B config.toml
یک پرونده پیکربندی برای دیمن containerd است. این پرونده برای استفاده توسط دیمن باید در مسیر
.B /etc/containerd/config.toml
قرار گیرد یا با گزینه
.B \-\-config
در دستور
.B containerd
مشخص شود. اگر این پرونده در مسیر مناسب وجود نداشته باشد یا از طریق گزینه
.B \-\-config
ارائه نشود، containerd از تنظیمات پیش‌فرض خود استفاده می‌کند که می‌توان آن را با دستور
.BR "containerd config" (1)
نمایش داد.

.SH "توضیحات (DESCRIPTION)"
پرونده TOML مورد استفاده برای پیکربندی تنظیمات دیمن containerd شامل فهرست کوتاهی از تنظیمات سراسری و به دنبال آن مجموعه‌ای از بخش‌ها برای حوزه‌های خاص پیکربندی دیمن است. همچنین بخشی برای
.B plugins
وجود دارد که به هر افزونه containerd اجازه می‌دهد بخشی اختصاصی برای پیکربندی و تنظیمات خاص خود داشته باشد.

.SH "قالب (FORMAT)"
.TP
\fBversion\fP
فیلد version در پرونده پیکربندی، نسخه پیکربندی را مشخص می‌کند. اگر هیچ شماره نسخه‌ای در پرونده پیکربندی مشخص نشود، نسخه ۱ فرض شده و مطابق آن تجزیه می‌شود. نسخه ۴ جدیدترین نسخه پیکربندی است. پیکربندی‌های قدیمی‌تر هنگام راه‌اندازی به طور خودکار مهاجرت داده می‌شوند.

.TP
\fBroot\fP
دایرکتوری ریشه برای فراداده‌های (metadata) containerd. (پیش‌فرض: "/var/lib/containerd")

.TP
\fBstate\fP
دایرکتوری وضعیت (state) برای containerd (پیش‌فرض: "/run/containerd")

.TP
\fBplugin_dir\fP
دایرکتوری محل ذخیره‌سازی افزونه‌های پویا

.TP
\fB[grpc]\fP \fI(در نسخه ۴ منسوخ شده است)\fP
بخش تنظیمات شنونده سوکت gRPC. در نسخه ۴، به جای آن از افزونه‌های سرور
\fBio.containerd.server.v1.grpc\fP
و
\fBio.containerd.server.v1.grpc-tcp\fP
استفاده کنید. پیکربندی‌های موجود به طور خودکار مهاجرت داده می‌شوند. شامل ویژگی‌های زیر است:

.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "/run/containerd/containerd.sock")
.IP \(bu 2
\fBtcp_address\fP
.IP \(bu 2
\fBtcp_tls_cert\fP
.IP \(bu 2
\fBtcp_tls_key\fP
.IP \(bu 2
\fBuid\fP (پیش‌فرض: 0)
.IP \(bu 2
\fBgid\fP (پیش‌فرض: 0)
.IP \(bu 2
\fBmax_recv_message_size\fP
.IP \(bu 2
\fBmax_send_message_size\fP

.TP
\fB[ttrpc]\fP \fI(در نسخه ۴ منسوخ شده است)\fP
بخش تنظیمات TTRPC. در نسخه ۴، به جای آن از افزونه سرور
\fBio.containerd.server.v1.ttrpc\fP
استفاده کنید. در نسخه‌های پیشین، هنگامی که نشانی TTRPC به طور صریح تنظیم نشده بود، از نشانی GRPC مشتق می‌شد (grpcAddress + ".ttrpc") و UID/GID مربوط به GRPC را به ارث می‌برد. در نسخه ۴، هر افزونه سرور به طور مستقل پیکربندی می‌شود؛ افزونه TTRPC هنگامی که بلوک پیکربندی آن حذف شده باشد از مقادیر پیش‌فرض خود استفاده می‌کند. شامل ویژگی‌های:

.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "")
.IP \(bu 2
\fBuid\fP (پیش‌فرض: 0)
.IP \(bu 2
\fBgid\fP (پیش‌فرض: 0)

.TP
\fB[debug]\fP \fI(در نسخه ۴ منسوخ شده است)\fP
بخش فعال‌سازی و پیکربندی شنونده سوکت اشکال‌زدایی. در نسخه ۴، به جای آن از افزونه سرور
\fBio.containerd.server.v1.debug\fP
استفاده کنید. شامل ویژگی‌های:

.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "/run/containerd/debug.sock")
.IP \(bu 2
\fBuid\fP (پیش‌فرض: 0)
.IP \(bu 2
\fBgid\fP (پیش‌فرض: 0)
.IP \(bu 2
\fBlevel\fP (پیش‌فرض: "info") تنظیم سطح گزارش اشکال‌زدایی. سطوح پشتیبانی‌شده عبارتند از:
"trace"، "debug"، "info"، "warn"، "error"، "fatal"، "panic"
.IP \(bu 2
\fBformat\fP (پیش‌فرض: "text") تنظیم قالب گزارش وقایع. قالب‌های پشتیبانی‌شده "text" و "json" هستند

.TP
\fB[metrics]\fP \fI(در نسخه ۴ منسوخ شده است)\fP
بخش فعال‌سازی و پیکربندی شنونده سنجه‌ها (metrics). در نسخه ۴، به جای آن از افزونه سرور
\fBio.containerd.server.v1.metrics\fP
استفاده کنید. شامل ویژگی‌های:

.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "") نقطه پایانی سنجه‌ها به طور پیش‌فرض گوش نمی‌دهد
.IP \(bu 2
\fBgrpc_histogram\fP (پیش‌فرض: false) فعال یا غیرفعال کردن سنجه‌های هیستوگرام gRPC

.TP
\fBdisabled_plugins\fP
افزونه‌های غیرفعال شناسه‌های افزونه‌هایی هستند که باید غیرفعال شوند. افزونه‌های غیرفعال‌شده مقداردهی اولیه و راه‌اندازی نخواهند شد.

.TP
\fBrequired_plugins\fP
افزونه‌های الزامی شناسه‌های افزونه‌های مورد نیاز هستند. اگر هر یک از افزونه‌های الزامی وجود نداشته باشد یا در مقداردهی اولیه یا راه‌اندازی با شکست مواجه شود، containerd متوقف می‌شود.

.TP
\fB[plugins]\fP
بخش افزونه‌ها شامل گزینه‌های پیکربندی ارائه‌شده از سوی افزونه‌های نصب‌شده است. افزونه‌های زیر به طور پیش‌فرض فعال هستند و تنظیمات آن‌ها در ادامه نشان داده شده است. افزونه‌هایی که به طور پیش‌فرض فعال نیستند، مستندات مقادیر پیکربندی خود را ارائه خواهند کرد.

.IP \(bu 2
\fB[plugins."io.containerd.server.v1.grpc"]\fP شنونده اصلی سرور gRPC را پیکربندی می‌کند (نسخه ۴):
.RS
.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "/run/containerd/containerd.sock")
.IP \(bu 2
\fBuid\fP (پیش‌فرض: UID موثر)
.IP \(bu 2
\fBgid\fP (پیش‌فرض: GID موثر)
.IP \(bu 2
\fBmax_recv_message_size\fP (پیش‌فرض: 16777216)
.IP \(bu 2
\fBmax_send_message_size\fP (پیش‌فرض: 16777216)
.RE
.IP \(bu 2
\fB[plugins."io.containerd.server.v1.grpc-tcp"]\fP شنونده سرور gRPC مبتنی بر TCP را پیکربندی می‌کند (نسخه ۴).
اگر address خالی باشد نادیده گرفته می‌شود:
.RS
.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "")
.IP \(bu 2
\fBtls_cert\fP, \fBtls_key\fP, \fBtls_ca\fP, \fBtls_common_name\fP
.IP \(bu 2
\fBmax_recv_message_size\fP (پیش‌فرض: 16777216)
.IP \(bu 2
\fBmax_send_message_size\fP (پیش‌فرض: 16777216)
.RE
.IP \(bu 2
\fB[plugins."io.containerd.server.v1.ttrpc"]\fP شنونده سرور TTRPC را پیکربندی می‌کند (نسخه ۴).
در نسخه ۴، این افزونه مستقل از افزونه gRPC پیکربندی می‌شود. اگر بلوک افزونه حذف شود، سرور TTRPC به جای اشتقاق از نشانی gRPC به نشانی پیش‌فرض خود متصل می‌شود:
.RS
.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "/run/containerd/containerd.sock.ttrpc")
.IP \(bu 2
\fBuid\fP (پیش‌فرض: UID موثر)
.IP \(bu 2
\fBgid\fP (پیش‌فرض: GID موثر)
.RE
.IP \(bu 2
\fB[plugins."io.containerd.server.v1.debug"]\fP شنونده سرور اشکال‌زدایی را پیکربندی می‌کند (نسخه ۴).
اگر address خالی باشد نادیده گرفته می‌شود:
.RS
.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "")
.IP \(bu 2
\fBuid\fP (پیش‌فرض: 0)
.IP \(bu 2
\fBgid\fP (پیش‌فرض: 0)
.RE
.IP \(bu 2
\fB[plugins."io.containerd.server.v1.metrics"]\fP شنونده HTTP سنجه‌ها را پیکربندی می‌کند (نسخه ۴).
اگر address خالی باشد نادیده گرفته می‌شود:
.RS
.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "")
.RE
.IP \(bu 2
\fB[plugins."io.containerd.monitor.v1.cgroups"]\fP دارای یک گزینه \fBno_prometheus\fP است (پیش‌فرض: \fBfalse\fP)
.IP \(bu 2
\fB[plugins."io.containerd.service.v1.diff-service"]\fP دارای یک گزینه \fBdefault\fP است که یک فهرست با مقدار پیش‌فرض \fB["walking"]\fP است
.IP \(bu 2
\fB[plugins."io.containerd.gc.v1.scheduler"]\fP دارای چندین گزینه است که تنظیم دقیق پیشرفته را برای زمان‌بند انجام می‌دهند:
.RS
.IP \(bu 2
\fBpause_threshold\fP حداکثر زمانی است که GC باید زمان‌بندی شود (پیش‌فرض: \fB0.02\fP)،
.IP \(bu 2
\fBdeletion_threshold\fP تضمین می‌کند که GC پس از n بار حذف زمان‌بندی شود (پیش‌فرض: \fB0\fP [راه‌اندازی نمی‌شود])،
.IP \(bu 2
\fBmutation_threshold\fP تضمین می‌کند که GC پس از n بار جهش پایگاه‌داده زمان‌بندی شود (پیش‌فرض: \fB100\fP)،
.IP \(bu 2
\fBschedule_delay\fP تاخیر پس از رویداد محرک را قبل از زمان‌بندی GC تعریف می‌کند (پیش‌فرض \fB"0ms"\fP [فوری])،
.IP \(bu 2
\fBstartup_delay\fP تاخیر پس از راه‌اندازی را قبل از زمان‌بندی یک GC تعریف می‌کند (پیش‌فرض \fB"100ms"\fP)
.RE
.IP \(bu 2
\fB[plugins."io.containerd.runtime.v2.task"]\fP گزینه‌هایی را برای پیکربندی شیم (shim) زمان اجرا مشخص می‌کند:
.RS
.IP \(bu 2
\fBplatforms\fP فهرست پلتفرم‌های پشتیبانی‌شده را مشخص می‌کند
.IP \(bu 2
\fBsched_core\fP زمان‌بندی هسته (Core scheduling) قابلیتی است که اجازه می‌دهد فقط وظایف مورد اعتماد به طور همزمان روی پردازنده‌هایی که منابع پردازشی مشترک دارند (مانند هایپرتریدها روی یک هسته) اجرا شوند. (پیش‌فرض: \fBfalse\fP)
.RE
.IP \(bu 2
\fB[plugins."io.containerd.service.v1.tasks-service"]\fP دارای گزینه‌های کارایی است:
.RS
.IP \(bu 2
\fBblockio_config_file\fP (فقط لینوکس) مسیر تعاریف کلاس blockio را مشخص می‌کند (پیش‌فرض: \fB""\fP). اولویت زمان‌بند I/O و محدودسازی پهنای باند را کنترل می‌کند. برای جزئیات قالب پرونده، به پیکربندی blockio در نشانی زیر مراجعه کنید:
\[la]https://github.com/intel/goresctrl/blob/main/doc/blockio.md#configuration\[ra]
.IP \(bu 2
\fBrdt_config_file\fP (فقط لینوکس) مسیر پیکربندی مورد استفاده برای تنظیم RDT را مشخص می‌کند (پیش‌فرض: \fB""\fP). پشتیبانی از Intel RDT را فعال می‌کند که فناوری مدیریت پهنای باند حافظه و حافظه نهان (کش) است. برای جزئیات قالب پرونده، به پیکربندی RDT در نشانی زیر مراجعه کنید:
\[la]https://github.com/intel/goresctrl/blob/main/doc/rdt.md#configuration\[ra]
.RE
.IP \(bu 2
\fB[plugins."io.containerd.grpc.v1.cri".containerd]\fP شامل گزینه‌هایی برای افزونه CRI، و گره‌های فرزند برای گزینه‌های CRI است:
.RS
.IP \(bu 2
\fBdefault_runtime_name\fP (پیش‌فرض: \fB"runc"\fP) نام زمان اجرای پیش‌فرض را مشخص می‌کند
.RE
.IP \(bu 2
\fB[plugins."io.containerd.grpc.v1.cri".containerd.runtimes]\fP یک یا چند محیط زمان اجرای کانتینر، هر یک با یک نام یکتا
.IP \(bu 2
\fB[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.]\fP یک زمان اجرا با نام \fB<runtime>\fR
.IP \(bu 2
\fB[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.\&.options]\fP گزینه‌های مربوط به \fB<runtime>\fR نام‌گذاری‌شده، مهم‌ترین مورد:
.RS
.IP \(bu 2
\fBBinaryName\fP مسیر زمان اجرای واقعی که توسط شیم فراخوانی می‌شود را مشخص می‌کند، مثلاً \fB"/usr/bin/runc"\fR
.RE

.TP
\fBoom_score\fP
امتیاز کمبود حافظه (OOM score) اعمال‌شده به فرآیند دیمن containerd (پیش‌فرض: 0)

.TP
\fB[cgroup]\fP
بخش مربوط به تنظیمات خاص cgroup در لینوکس

.IP \(bu 2
\fBpath\fP (پیش‌فرض: "") تعیین یک مسیر سفارشی cgroup برای کانتینرهای ایجادشده

.TP
\fB[proxy_plugins]\fP
افزونه‌های پراکسی، افزونه‌هایی را پیکربندی می‌کنند که ارتباط با آن‌ها از طریق gRPC صورت می‌گیرد

.IP \(bu 2
\fBtype\fP (پیش‌فرض: "")
.IP \(bu 2
\fBaddress\fP (پیش‌فرض: "")

.TP
\fBtimeouts\fP
مهلت‌های زمانی مشخص‌شده به عنوان یک مدت زمان

.TP
\fBimports\fP
فهرستی از پرونده‌های پیکربندی اضافی برای گنجاندن.
این امکان را فراهم می‌کند که پرونده پیکربندی اصلی تقسیم شده و برخی بخش‌ها به طور جداگانه نگهداری شوند (به عنوان مثال ارائه‌دهندگان می‌توانند پیکربندی زمان اجرای سفارشی را در یک پرونده جداگانه بدون دستکاری \fBconfig.toml\fR اصلی نگه دارند).
پرونده‌های واردشده (imported) فیلدهای ساده مانند \fBint\fR یا \fBstring\fR را (در صورت خالی نبودن) بازنویسی می‌کنند و فیلدهای \fBarray\fR و \fBmap\fR را ضمیمه می‌نمایند.
پرونده‌های واردشده نیز دارای نسخه هستند و نسخه آن‌ها نمی‌تواند بالاتر از پیکربندی اصلی باشد.

.PP
\fBstream_processors\fP
.IP \(bu 2
\fBaccepts\fP (پیش‌فرض: "[]") انواع رسانه (media-types) خاص را می‌پذیرد
.IP \(bu 2
\fBreturns\fP (پیش‌فرض: "") نوع رسانه را بازمی‌گرداند
.IP \(bu 2
\fBpath\fP (پیش‌فرض: "") مسیر یا نام باینری
.IP \(bu 2
\fBargs\fP (پیش‌فرض: "[]") آرگومان‌های ارسالی به باینری

.SH "مثال‌ها (EXAMPLES)"
.SS پیکربندی نسخه ۴
در ادامه یک نمونه از \fBconfig.toml\fR با استفاده از نسخه ۴ آمده است که در آن تنظیمات سرور به عنوان افزونه پیکربندی شده‌اند:

.EX
version = 4

root = "/var/lib/containerd"
state = "/run/containerd"
oom_score = 0
imports = ["/etc/containerd/runtime_*.toml", "./debug.toml"]

[plugins."io.containerd.server.v1.grpc"]
  address = "/run/containerd/containerd.sock"

[plugins."io.containerd.server.v1.ttrpc"]
  address = "/run/containerd/containerd.sock.ttrpc"

[plugins."io.containerd.server.v1.debug"]
  address = "/run/containerd/debug.sock"
  level = "info"

[cgroup]
  path = ""

[plugins]
  [plugins."io.containerd.monitor.v1.cgroups"]
    no_prometheus = false
  [plugins."io.containerd.service.v1.diff-service"]
    default = ["walking"]
  [plugins."io.containerd.gc.v1.scheduler"]
    pause_threshold = 0.02
    deletion_threshold = 0
    mutation_threshold = 100
    schedule_delay = 0
    startup_delay = "100ms"
  [plugins."io.containerd.runtime.v2.task"]
    platforms = ["linux/amd64"]
    sched_core = true
  [plugins."io.containerd.service.v1.tasks-service"]
    blockio_config_file = ""
    rdt_config_file = ""
.EE

.SS چندین محیط زمان اجرا (Multiple Runtimes)
در ادامه نمونه‌ای از یک پیکربندی جزئی با دو محیط زمان اجرا آمده است:

.EX
[plugins]

  [plugins."io.containerd.grpc.v1.cri"]

    [plugins."io.containerd.grpc.v1.cri".containerd]
      default_runtime_name = "runc"

      [plugins."io.containerd.grpc.v1.cri".containerd.runtimes]
        [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc]
          privileged_without_host_devices = false
          runtime_type = "io.containerd.runc.v2"

          [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
            BinaryName = "/usr/bin/runc"

        [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.other]
          privileged_without_host_devices = false
          runtime_type = "io.containerd.runc.v2"

          [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.other.options]
            BinaryName = "/usr/bin/path-to-runtime"
.EE

.PP
موارد فوق دو پیکربندی زمان اجرای نام‌گذاری‌شده ایجاد می‌کند \- با نام‌های \fBrunc\fR و \fBother\fR \- و زمان اجرای پیش‌فرض را روی \fBrunc\fR قرار می‌دهد.
موارد فوق \fIصرفاً\fP برای زمان‌های اجرایی که از طریق CRI فراخوانی می‌شوند به کار می‌روند. برای استفاده از زمان اجرای غیر پیش‌فرض "other" در این مثال، یک مشخصه (spec) شامل گرداننده زمان اجرای با نام "other" خواهد بود تا تمایل به استفاده از پیکربندی زمان اجرای نام‌گذاری‌شده را مشخص کند.

.PP
مشخصات CRI شامل پیوند
\[la]https://github.com/kubernetes/cri\-api/blob/de5f1318aede866435308f39cb432618a15f104e/pkg/apis/runtime/v1/api.proto#L476\[ra]
است که به زمان اجرای نام‌گذاری‌شده ارجاع می‌دهد.

.PP
توجه به قرارداد نام‌گذاری اهمیت دارد. زمان‌های اجرا زیرمجموعه \fB[plugins."io.containerd.grpc.v1.cri".containerd.runtimes]\fR هستند که به هر زمان اجرا یک نام یکتا داده می‌شود، مثلاً \fB[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc]\fR\&.
علاوه بر این، هر زمان اجرا می‌تواند گزینه‌های خاص شیم را در زیر \fB[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.<runtime>.options]\fR داشته باشد، برای مثال \fB[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]\fR\&.

.PP
زمان اجرای \fBio.containerd.runc.v2\fR برای اجرای زمان‌های اجرای سازگار با OCI در لینوکس مانند runc استفاده می‌شود. در مثال بالا، فیلد \fBruntime_type\fR شیم مورد استفاده (\fBio.containerd.runc.v2\fR) را مشخص می‌کند در حالی که فیلد \fBBinaryName\fR یک گزینه خاص شیم است که مسیر زمان اجرای OCI را مشخص می‌نماید.

.PP
برای نمونه پیکربندی با نام "runc"، شیم \fB/usr/bin/runc\fR را به عنوان زمان اجرای OCI راه‌اندازی می‌کند. برای نمونه پیکربندی با نام "other"، شیم به جای آن \fB/usr/bin/path-to-runtime\fR را اجرا خواهد کرد.

.SH "اشکالات (BUGS)"
لطفاً هرگونه مشکل خاصی را که با آن مواجه می‌شوید در نشانی زیر ثبت کنید:
https://github.com/containerd/containerd

.SH "نویسنده (AUTHOR)"
Phil Estes estesp@gmail.com
\[la]mailto:estesp@gmail.com\[ra]

.SH "همچنین ببینید (SEE ALSO)"
ctr(8), containerd-config(8), containerd(8)