| crio(8) | System Manager's Manual | crio(8) |
نام (NAME)
crio - پیادهسازی مبتنی بر OCI برای رابط زمان اجرای کانتینر کوبرنتیز (CRI)
خلاصه دستور (SYNOPSIS)
crio
[--absent-mount-sources-to-reject]=[value] [--add-inheritable-capabilities] [--additional-artifact-stores]=[value] [--additional-devices]=[value] [--allowed-devices]=[value] [--apparmor-profile]=[value] [--auto-reload-registries] [--big-files-temporary-dir]=[value] [--bind-mount-prefix]=[value] [--blockio-config-file]=[value] [--blockio-reload] [--cdi-spec-dirs]=[value] [--cgroup-manager]=[value] [--clean-shutdown-file]=[value] [--cni-config-dir]=[value] [--cni-default-network]=[value] [--cni-plugin-dir]=[value] [--cni-status-grace-period]=[value] [--collection-period]=[value] [--config-dir|-d]=[value] [--config|-c]=[value] [--conmon-cgroup]=[value] [--conmon-env]=[value] [--conmon]=[value] [--container-attach-socket-dir]=[value] [--container-exits-dir]=[value] [--ctr-stop-timeout]=[value] [--decryption-keys-path]=[value] [--default-capabilities]=[value] [--default-env]=[value] [--default-mounts-file]=[value] [--default-runtime]=[value] [--default-sysctls]=[value] [--default-transport]=[value] [--default-ulimits]=[value] [--device-ownership-from-security-context] [--disable-hostport-mapping] [--drop-infra-ctr] [--enable-criu-support] [--enable-metrics] [--enable-nri] [--enable-pod-events] [--enable-profile-unix-socket] [--enable-tracing] [--gid-mappings]=[value] [--global-auth-file]=[value] [--grpc-max-recv-msg-size]=[value] [--grpc-max-send-msg-size]=[value] [--help|-h] [--hooks-dir]=[value] [--hostnetwork-disable-selinux] [--image-volumes]=[value] [--imagestore]=[value] [--included-pod-metrics]=[value] [--infra-ctr-cpuset]=[value] [--insecure-registry]=[value] [--internal-repair] [--internal-wipe] [--irqbalance-config-file]=[value] [--irqbalance-config-restore-file]=[value] [--listen]=[value] [--log-dir]=[value] [--log-filter]=[value] [--log-format]=[value] [--log-journald] [--log-level|-l]=[value] [--log-size-max]=[value] [--log]=[value] [--metrics-cert]=[value] [--metrics-collectors]=[value] [--metrics-host]=[value] [--metrics-key]=[value] [--metrics-port]=[value] [--metrics-socket]=[value] [--min-injected-gomaxprocs]=[value] [--minimum-mappable-gid]=[value] [--minimum-mappable-uid]=[value] [--namespaces-dir]=[value] [--no-pivot] [--nri-disable-connections] [--nri-enable-default-validator] [--nri-listen]=[value] [--nri-plugin-config-dir]=[value] [--nri-plugin-dir]=[value] [--nri-plugin-registration-timeout]=[value] [--nri-plugin-request-timeout]=[value] [--nri-validator-reject-custom-seccomp-adjustment] [--nri-validator-reject-namespace-adjustment] [--nri-validator-reject-oci-hook-adjustment] [--nri-validator-reject-runtime-default-seccomp-adjustment] [--nri-validator-reject-unconfined-seccomp-adjustment] [--nri-validator-required-plugins]=[value] [--nri-validator-tolerate-missing-plugins-annotation]=[value] [--oci-artifact-mount-support] [--pause-command]=[value] [--pause-image-auth-file]=[value] [--pause-image]=[value] [--pids-limit]=[value] [--pinned-images]=[value] [--pinns-path]=[value] [--privileged-seccomp-profile]=[value] [--profile-cpu]=[value] [--profile-mem]=[value] [--profile-port]=[value] [--profile] [--pull-progress-timeout]=[value] [--rdt-config-file]=[value] [--read-only] [--root|-r]=[value] [--runroot]=[value] [--runtimes]=[value] [--seccomp-profile]=[value] [--selinux] [--separate-pull-cgroup]=[value] [--shared-cpuset]=[value] [--short-name-mode]=[value] [--signature-policy-dir]=[value] [--signature-policy]=[value] [--stats-collection-period]=[value] [--storage-driver|-s]=[value] [--storage-opt]=[value] [--stream-address]=[value] [--stream-enable-tls] [--stream-idle-timeout]=[value] [--stream-port]=[value] [--stream-tls-ca]=[value] [--stream-tls-cert]=[value] [--stream-tls-key]=[value] [--timezone|--tz]=[value] [--tls-cipher-suites]=[value] [--tls-min-version]=[value] [--tracing-endpoint]=[value] [--tracing-sampling-rate-per-million]=[value] [--uid-mappings]=[value] [--version-file-persist]=[value] [--version-file]=[value] [--version|-v]
توضیحات (DESCRIPTION)
پیادهسازی دیمن رابط زمان اجرای کانتینر کوبرنتیز (CRI) مبتنی بر OCI
ابزار crio برای فراهم ساختن مسیر یکپارچهسازی میان زمانهای اجرای منطبق بر استاندارد OCI و kubelet طراحی شده است. بهطور خاص، این ابزار رابط زمان اجرای کانتینر (CRI) کوبرنتیز را با استفاده از زمانهای اجرای منطبق بر OCI پیادهسازی میکند. دامنه عملکرد crio به محدوده وظایف CRI گره خورده است:
- 1.
- پشتیبانی از قالبهای چندگانه تصویر از جمله قالبهای Docker و OCI.
- 2.
- پشتیبانی از روشهای متعدد بارگیری تصاویر، شامل اعتبارسنجی و اعتماد به تصویر.
- 3.
- مدیریت تصویر کانتینر (مدیریت لایههای تصویر، سیستمهای فایل overlay و غیره).
- 4.
- مدیریت چرخه حیات فرآیندهای کانتینر.
- 5.
- پایش و ثبت وقایع (لاگین) مورد نیاز برای برآورده ساختن مشخصات CRI.
- 6.
- جداسازی منابع بر اساس الزامات CRI.
نحوه استفاده (Usage):
crio [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]
گزینههای عمومی (GLOBAL OPTIONS)
--absent-mount-sources-to-reject="": فهرستی از مسیرها که در صورت عدم وجود روی هاست، باعث شکست در ساخت کانتینر میشوند (برخلاف رفتار کنونی که یک پوشه میسازد).
--add-inheritable-capabilities: افزودن قابلیتها به مجموعه ارثبرنده (inheritable)، علاوه بر گروه پیشفرض مجاز (permitted)، کراندار (bounding) و مؤثر (effective).
--additional-artifact-stores="": مسیرهای اضافی و فقطخواندنی مخزن آرتیفکتهای OCI.
--additional-devices="": دستگاهها جهت افزودن به کانتینرها.
--allowed-devices="": دستگاههایی که کاربر مجاز است با یادداشت مجاز "io.kubernetes.cri-o.Devices" تعیین کند. (پیشفرض: "/dev/fuse", "/dev/net/tun")
--apparmor-profile="": نام پروفایل apparmor برای استفاده به عنوان پیشفرض زمان اجرا. این گزینه تنها زمانی اثر دارد که کاربر پروفایلی را از طریق یادداشت متادیتای پاد کوبرنتیز تعیین نکرده باشد. (پیشفرض: "crio-default")
--auto-reload-registries: در صورت تنظیم روی true، با بهروزرسانی دایرکتوری 'registries.conf.d'، ابزار CRI-O بهطور خودکار مخزن آینهای را مجدداً بارگذاری میکند. مقدار پیشفرض 'false' است.
--big-files-temporary-dir="": مسیر دایرکتوری موقت برای ذخیرهسازی فایلهای حجیم، جهت ذخیره blobهای تصویر و جریانهای داده مرتبط با مدیریت تصویر کانتینرها.
--bind-mount-prefix="": پیشوندی برای استفاده در مبدأ مانتهای اتصالی (bind mounts). این گزینه زمانی مفید است که CRI-O را درون یک کانتینر اجرا کنید و '/' روی '/host' در کانتینر شما مانت شده باشد. در این حالت اگر CRI-O را با گزینه '--bind-mount-prefix=/host' اجرا کنید، CRI-O مقدار /host را به هر bind mount ارائهشده از طریق CRI اضافه میکند. اگر کوبرنتیز بخواهد '/var/lib/foobar' به صورت bind درون کانتینر مانت شود، CRI-O مسیر '/host/var/lib/foobar' را مانت خواهد کرد. از آنجا که خود CRI-O درون یک کانتینر با '/' یا هاست مانتشده روی '/host' اجرا میشود، کانتینر در نهایت به '/var/lib/foobar' از هاست دسترسی پیدا میکند نه '/var/lib/foobar' از کانتینر CRI-O.
--blockio-config-file="": مسیر فایل پیکربندی کلاس blockio برای تنظیم کنترلکننده blockio در cgroup.
--blockio-reload: بارگذاری مجدد فایل blockio-config-file و اسکن دوباره دستگاههای blockio در سیستم پیش از اعمال پارامترهای blockio.
--cdi-spec-dirs="": دایرکتوریها جهت اسکن فایلهای مشخصات CDI. (پیشفرض: "/etc/cdi", "/run/cdi")
--cgroup-manager="": مدیر cgroup (مقادیر cgroupfs یا systemd). (پیشفرض: "systemd")
--clean-shutdown-file="": مکانی که CRI-O فایل خاموشی تمیز را در آن قرار میدهد. این فایل نشان میدهد که آیا پیش از خاموش شدن، زمان کافی برای همگامسازی تغییرات روی دیسک وجود داشته است یا خیر. در صورت عدم یافتن، crio wipe دایرکتوری ذخیرهسازی را پاک خواهد کرد. (پیشفرض: "/var/lib/crio/clean.shutdown")
--cni-config-dir="": دایرکتوری فایلهای پیکربندی CNI. (پیشفرض: "/etc/cni/net.d/")
--cni-default-network="": نام شبکه پیشفرض CNI برای انتخاب. در صورت عدم تنظیم یا مقدار ""، ابزار CRI-O اولین شبکه یافتشده در --cni-config-dir را انتخاب میکند.
--cni-plugin-dir="": دایرکتوری فایلهای باینری پلاگین CNI.
--cni-status-grace-period="": فعالسازی پایش پیوسته وضعیت CNI با دوره مهلت دادهشده. هنگامی که روی 0 (پیشفرض) تنظیم شود، پایش غیرفعال بوده و سلامت پلاگین فقط در زمان راهاندازی تعیین میشود. در صورت تنظیم روی مقدار مثبت (مثلاً 1m)، یک goroutine در پسزمینه هر 5 ثانیه پلاگین را بررسی کرده و پیش از علامتگذاری نود به عنوان ناآماده (not-ready)، به اندازه این دوره مهلت منتظر میماند. (پیشفرض: 0s)
--collection-period="": تعداد ثانیهها بین جمعآوری آمار پاد/کانتینر و معیارهای سندباکس پاد. در صورت تنظیم روی 0، معیارها/آمار در صورت تقاضا جمعآوری میشوند. (پیشفرض: 0)
--config, -c="": مسیر فایل پیکربندی (پیشفرض: "/etc/crio/crio.conf")
--config-dir, -d="":
مسیر
دایرکتوری
drop-in پیکربندی.
این
دایرکتوری
به صورت
بازگشتی
پیمایش شده
و هر فایل به
ترتیب
پردازش در
پیکربندی
اعمال
میشود.
بدین معنا
که فایلی با
نام '00-default'
اولویت
کمتری نسبت
به فایلی به
نام '01-my-overwrite' دارد.
فایل
پیکربندی
سراسری
ارائهشده
از طریق '--config,-c'
یا به صورت
پیشفرض در
/etc/crio/crio.conf
همواره
اولویت
کمتری نسبت
به
فایلهای
موجود در
دایرکتوری
مشخصشده
توسط '--config-dir,-d'
دارد.
علاوه بر
این،
پارامترهای
ارائهشده
در خط فرمان
اولویت
بالاتری
نسبت به هر
فایل
پیکربندی
دارند.
(پیشفرض:
"/etc/crio/crio.conf.d")
--conmon="": مسیر فایل باینری conmon، مورد استفاده برای نظارت بر زمان اجرای OCI. در صورت خالی بودن، در $PATH جستجو میشود. این گزینه منسوخ شده و در آینده حذف خواهد شد.
--conmon-cgroup="": گروه cgroup مورد استفاده برای فرآیند conmon. این گزینه منسوخ شده و در آینده حذف خواهد شد.
--conmon-env="": فهرست متغیرهای محیطی برای فرآیند conmon، جهت ارسال متغیرهای محیطی لازم به conmon یا زمان اجرا. این گزینه منسوخ شده و در آینده حذف خواهد شد.
--container-attach-socket-dir="": مسیر دایرکتوری برای سوکتهای اتصال کانتینر. (پیشفرض: "/run/crio")
--container-exits-dir="": مسیر دایرکتوری که فایلهای خروج کانتینر توسط conmon در آن نوشته میشوند. (پیشفرض: "/run/crio/exits")
--ctr-stop-timeout="": حداقل زمان بر حسب ثانیه برای انتظار پیش از اعمال تایماوت در خصوص توقف مناسب کانتینر. کمترین مقدار ممکن 30s است و مقادیر کمتر توسط CRI-O در نظر گرفته نمیشوند. (پیشفرض: 30)
--decryption-keys-path="": مسیر بارگذاری کلیدها جهت رمزگشایی تصویر. (پیشفرض: "/etc/crio/keys/")
--default-capabilities="": قابلیتها جهت افزودن به کانتینرها. (پیشفرض: "CHOWN", "DAC_OVERRIDE", "FSETID", "FOWNER", "SETGID", "SETUID", "SETPCAP", "NET_BIND_SERVICE", "KILL")
--default-env="": متغیرهای محیطی اضافی جهت تنظیم برای تمام کانتینرها.
--default-mounts-file="": مسیر فایل مانتهای پیشفرض.
--default-runtime="": زمان اجرای پیشفرض OCI از پیکربندی runtimes. (پیشفرض: "crun")
--default-sysctls="": مقادیر sysctl جهت افزودن به کانتینرها.
--default-transport="": پیشوندی برای اضافه کردن به ابتدای نام تصاویری که نمیتوان آنها را بدون پیشوند دریافت کرد. (پیشفرض: "docker://")
--default-ulimits="": محدودیتهای ulimit پیشفرض برای اعمال روی کانتینرها (name=soft:hard).
--device-ownership-from-security-context: تنظیم مالکیت uid/gid دستگاهها بر اساس runAsUser/runAsGroup.
--disable-hostport-mapping: در صورت تنظیم روی true، ابزار CRI-O نگاشت hostport را غیرفعال میکند.
--drop-infra-ctr: تعیین میکند که آیا هنگام عدم استفاده پاد از فضای نام PID در سطح پاد، پادها بدون کانتینر infra ساخته شوند یا خیر.
--enable-criu-support: فعالسازی یکپارچهسازی با CRIU؛ نیازمند در دسترس بودن باینری criu در $PATH است.
--enable-metrics: فعالسازی اندپوینت معیارها (metrics) برای سرور.
--enable-nri: فعالسازی پشتیبانی از NRI (رابط منابع نود).
--enable-pod-events: در صورت تنظیم روی true، ابزار CRI-O ارسال رویدادهای کانتینر به kubelet را آغاز میکند.
--enable-profile-unix-socket: فعالسازی پروفایلر pprof روی سوکت یونیکس دامین crio.
--enable-tracing: فعالسازی صادر کردن دادههای ردگیری (trace) به OpenTelemetry.
--gid-mappings="": تعیین نگاشتهای GID مورد استفاده برای فضای نام کاربر. این گزینه منسوخ شده و در آینده با پشتیبانی فضای نام کاربر در کوبرنتیز (KEP-127) جایگزین خواهد شد.
--global-auth-file="": مسیر فایلی مانند /var/lib/kubelet/config.json که حاوی اطلاعات احراز هویت لازم برای دریافت تصاویر از رجیستریهای امن است.
--grpc-max-recv-msg-size="": حداکثر اندازه پیام دریافتی gRPC به بایت. (پیشفرض: 83886080)
--grpc-max-send-msg-size="": حداکثر اندازه پیام ارسالی gRPC به بایت. (پیشفرض: 83886080)
--help, -h: نمایش راهنما
--hooks-dir="":
تنظیم مسیر
دایرکتوری
هوکهای OCI
(میتواند
چند بار
مشخص شود).
اگر یکی از
دایرکتوریها
وجود
نداشته
باشد، CRI-O
بهطور
خودکار از
آن رد
میشود.
هر فایل '*.json' در
مسیر، یک
هوک برای
کانتینرهای
CRI-O پیکربندی
میکند.
برای
جزئیات
بیشتر در
مورد نحو
فایلهای JSON
و معنای
تزریق هوک،
به 'oci-hooks(5)'
مراجعه
کنید.
در حال حاضر
CRI-O از هر دو
طرحواره 1.0.0 و
0.1.0 هوک
پشتیبانی
میکند،
اگرچه
طرحواره
0.1.0 منسوخ شده
است.
این گزینه
ممکن است
چند بار
مشخص شود؛
مسیرهای
گزینههای
بعدی
اولویت
بالاتری
دارند
('oci-hooks(5)' اولویت
دایرکتوریها
را شرح
میدهد).
برای شرایط
یادداشتها،
CRI-O از
یادداشتهای
کوبرنتیز
استفاده
میکند که
زیرمجموعهای
از
یادداشتهای
ارسالی به
زمان اجرای
OCI هستند.
برای مثال،
'io.kubernetes.cri-o.Volumes'
بخشی از
یادداشتهای
پیکربندی
زمان اجرای
OCI است، اما
جزو
یادداشتهای
کوبرنتیز
که برای
هوکها
تطبیق داده
میشوند
نیست.
برای شرایط
مانت
اتصالی (bind-mount)،
فقط
مانتهایی
که صراحتاً
توسط
پیکربندی
کوبرنتیز
درخواست
شدهاند در
نظر گرفته
میشوند.
مانتهای
اتصالی
پیشفرض CRI-O
(مانند '/dev/shm')
در نظر
گرفته
نمیشوند.
(پیشفرض:
"/usr/share/containers/oci/hooks.d")
--hostnetwork-disable-selinux: تعیین میکند که آیا در صورت اجرای پاد در فضای نام شبکه هاست، SELinux درون پاد غیرفعال شود یا خیر.
--image-volumes="":
نحوه
مدیریت
حجمهای
تصویر ('mkdir'، 'bind'
یا 'ignore')
1. mkdir: یک
دایرکتوری
درون سیستم
فایل ریشه
کانتینر
برای
حجمها
ایجاد
میشود.
2. bind: یک
دایرکتوری
درون
دایرکتوری
وضعیت
کانتینر
ایجاد شده و
به صورت bind
درون
کانتینر
برای
حجمها
مانت
میشود.
3. ignore: تمام
حجمها
نادیده
گرفته شده و
هیچ اقدامی
انجام
نمیشود.
(پیشفرض:
"mkdir")
--imagestore="": ذخیرهسازی تصاویر تازه دریافتشده در مسیر مشخصشده، به جای مسیر ارائهشده با --root.
--included-pod-metrics="": فهرستی از معیارهای پاد جهت گنجاندن. نام معیارهایی که باید در این لیست قرار گیرند را مشخص کنید.
--infra-ctr-cpuset="": مجموعه CPU برای اجرای کانتینرهای infra؛ در صورت عدم تعیین، CRI-O از تمام CPUهای فعال برای اجرای کانتینرهای infra استفاده خواهد کرد.
--insecure-registry="":
فعالسازی
ارتباط
ناامن با
رجیستری
(مخزن)، یعنی
فعالسازی
ارتباط
رمزگذارینشده
یا غیرقابل
اعتماد.
این گزینه
منسوخ شده
است؛ لطفاً
به جای آن از
"insecure" در registries.conf
استفاده
کنید.
1. فهرست
رجیستریهای
ناامن
میتواند
شامل عنصری
با نماد CIDR
برای تعیین
یک زیرشبکه
کامل باشد.
2.
رجیستریهای
ناامن
ارتباط HTTP یا
ارتباط HTTPS با
گواهیهای
صادرشده
توسط CAهای
ناشناخته
را
میپذیرند.
3. فعالسازی
'--insecure-registry' هنگام
اجرای
رجیستری
محلی
کاربرد
دارد. با این
حال، به
دلیل اینکه
استفاده از
آن
آسیبپذیریهای
امنیتی به
همراه
دارد، فقط
باید برای
اهداف
آزمایشی
فعال شود.
برای امنیت
بالاتر،
کاربران
باید مرجع
صدور گواهی
(CA) خود را به
جای
استفاده از
'--insecure-registry'، به
فهرست CAهای
معتمد
سیستم
اضافه
کنند.
--internal-repair: در صورت تنظیم روی true، ابزار CRI-O پس از راهاندازی مجدد ناگهانی، سلامت فضای ذخیرهسازی کانتینر و تصویر را بررسی کرده و در صورت خرابی، سعی در تعمیر آن میکند.
--internal-wipe: تعیین میکند که آیا CRI-O هنگام راهاندازی سرور، کانتینرها را پس از راهاندازی مجدد و تصاویر را پس از ارتقا پاک کند یا خیر. در صورت تنظیم روی false، باید دستور 'crio wipe' را برای پاکسازی کانتینرها و تصاویر در این شرایط اجرا کرد. این گزینه منسوخ شده و در آینده حذف خواهد شد.
--irqbalance-config-file="": فایل پیکربندی سرویس irqbalance که توسط CRI-O استفاده میشود. (پیشفرض: "/etc/sysconfig/irqbalance")
--irqbalance-config-restore-file="": تعیین میکند که آیا CRI-O در زمان راهاندازی سعی در بازیابی پیکربندی irqbalance با ماسک موجود در این فایل داشته باشد یا خیر. از مقدار 'disable' برای غیرفعالسازی کامل روند بازیابی استفاده کنید. (پیشفرض: "/etc/sysconfig/orig_irq_banned_cpus")
--listen="": مسیر سوکت CRI-O. (پیشفرض: "/run/crio/crio.sock")
--log="": تنظیم مسیر فایل لاگ که اطلاعات اشکالزدایی داخلی در آن نوشته میشود.
--log-dir="": دایرکتوری لاگ پیشفرض که تمام گزارشها در آن ذخیره میشوند، مگر اینکه مستقیماً توسط kubelet مشخص شود. (پیشفرض: "/var/log/crio/pods")
--log-filter="": فیلتر کردن پیامهای لاگ بر اساس عبارت منظم (regex) ارائهشده. به عنوان مثال 'request.*' تمام درخواستهای gRPC را فیلتر میکند.
--log-format="": تنظیم قالب مورد استفاده لاگها: 'text' یا 'json'. (پیشفرض: "text")
--log-journald: ثبت گزارشها در ژورنال systemd (journald) علاوه بر فایل لاگ کوبرنتیز.
--log-level, -l="": ثبت پیامهای بالاتر از سطح مشخصشده: trace یا debug یا info یا warn یا error یا fatal یا panic. (پیشفرض: "info")
--log-size-max="": حداکثر اندازه لاگ به بایت برای یک کانتینر. در صورت مثبت بودن، باید >= 8192 باشد تا با بافر خواندن conmon برابر باشد یا از آن بیشتر شود. این گزینه منسوخ شده است. فلگ '--container-log-max-size' در Kubelet باید به جای آن استفاده شود. (پیشفرض: -1)
--metrics-cert="": گواهی برای اندپوینت معیارهای امن (secure metrics endpoint).
--metrics-collectors="": جمعآورندههای فعال معیارها. (پیشفرض: "image_pulls_layer_size", "containers_events_dropped_total", "containers_oom_total", "processes_defunct", "operations_total", "operations_latency_seconds", "operations_latency_seconds_total", "operations_errors_total", "image_pulls_bytes_total", "image_pulls_skipped_bytes_total", "image_pulls_failure_total", "image_pulls_success_total", "image_layer_reuse_total", "containers_oom_count_total", "containers_seccomp_notifier_count_total", "resources_stalled_at_stage", "containers_stopped_monitor_count", "default_runtime")
--metrics-host="": میزبان اندپوینت معیارها. (پیشفرض: "127.0.0.1")
--metrics-key="": کلید گواهی برای اندپوینت معیارهای امن.
--metrics-port="": درگاه (پورت) برای اندپوینت معیارها. (پیشفرض: 9090)
--metrics-socket="": سوکت برای اندپوینت معیارها.
--min-injected-gomaxprocs="": فعالسازی تزریق GOMAXPROCS. پادهای Burstable بر اساس درخواست CPU به طور خودکار محاسبه میشوند و این مقدار به عنوان حداقل کف در نظر گرفته میشود. پادهای Best-effort مستقیماً از این مقدار استفاده میکنند. مقدار 0 برای غیرفعالسازی. (پیشفرض: 0)
--minimum-mappable-gid="": تعیین کمترین GID هاست که میتواند در نگاشتها برای پادی که با UID غیر از 0 اجرا میشود مشخص گردد. این گزینه منسوخ شده و در آینده با پشتیبانی فضای نام کاربر در کوبرنتیز (KEP-127) جایگزین خواهد شد. (پیشفرض: -1)
--minimum-mappable-uid="": تعیین کمترین UID هاست که میتواند در نگاشتها برای پادی که با UID غیر از 0 اجرا میشود مشخص گردد. این گزینه منسوخ شده و در آینده با پشتیبانی فضای نام کاربر در کوبرنتیز (KEP-127) جایگزین خواهد شد. (پیشفرض: -1)
--namespaces-dir="": دایرکتوری که وضعیت فضاهای نام مدیریتشده در آن رهگیری میشود. فقط زمانی استفاده میشود که manage-ns-lifecycle مقدار true داشته باشد. (پیشفرض: "/run")
--no-pivot: در صورت تنظیم روی true، زمان اجرا از 'pivot_root' استفاده نخواهد کرد و در عوض از 'MS_MOVE' استفاده میکند.
--nri-disable-connections: غیرفعال کردن اتصالات از سوی پلاگینهای NRI که از خارج راهاندازی شدهاند.
--nri-enable-default-validator: فعالسازی پلاگین اعتبارسنج پیشفرض NRI.
--nri-listen="": سوکت گوش دادن برای اتصال پلاگینهای NRI راهاندازیشده از خارج. (پیشفرض: "/run/nri/nri.sock")
--nri-plugin-config-dir="": دایرکتوری جهت اسکن پیکربندی پلاگینهای پیشنصبشده NRI. (پیشفرض: "/etc/nri/conf.d")
--nri-plugin-dir="": دایرکتوری جهت اسکن پلاگینهای پیشنصبشده NRI برای شروع خودکار. (پیشفرض: "/opt/nri/plugins")
--nri-plugin-registration-timeout="": مهلت زمانی برای ثبت پلاگین در NRI. (پیشفرض: 5s)
--nri-plugin-request-timeout="": مهلت زمانی برای رسیدگی پلاگین به یک درخواست NRI. (پیشفرض: 2s)
--nri-validator-reject-custom-seccomp-adjustment: رد کردن تنظیم خطمشی seccomp سفارشی توسط پلاگین NRI.
--nri-validator-reject-namespace-adjustment: رد کردن تنظیم فضاهای نام لینوکس توسط پلاگین NRI.
--nri-validator-reject-oci-hook-adjustment: رد کردن تنظیم هوکهای OCI توسط پلاگین NRI.
--nri-validator-reject-runtime-default-seccomp-adjustment: رد کردن تنظیم خطمشی seccomp پیشفرض زمان اجرا توسط پلاگین NRI.
--nri-validator-reject-unconfined-seccomp-adjustment: رد کردن تنظیم خطمشی seccomp نامحدود (unconfined) توسط پلاگین NRI.
--nri-validator-required-plugins="": فهرست پلاگینهای ضروری NRI که باید حضور داشته باشند.
--nri-validator-tolerate-missing-plugins-annotation="": نام یادداشتی که برای نشان دادن تحمل فقدان پلاگینهای ضروری NRI استفاده میشود.
--oci-artifact-mount-support: در صورت تنظیم روی true، ابزار CRI-O میتواند آرتیفکتهای OCI را به عنوان حجم (volume) مانت کند.
--pause-command="": مسیر فایل اجرایی pause در تصویر pause. (پیشفرض: "/pause")
--pause-image="": تصویری که حاوی فایل اجرایی pause است. (پیشفرض: "registry.k8s.io/pause:3.10.1")
--pause-image-auth-file="": مسیر فایل پیکربندی حاوی اعتبارنامهها برای --pause-image.
--pids-limit="": حداکثر تعداد فرآیندهای مجاز در یک کانتینر. این گزینه منسوخ شده است. فلگ '--pod-pids-limit' در Kubelet باید به جای آن استفاده شود. (پیشفرض: -1)
--pinned-images="": فهرستی از تصاویری که از فرآیند جمعآوری زباله (garbage collection) کوبلت مستثنی خواهند شد.
--pinns-path="": مسیر باینری pinns، که برای مدیریت چرخه حیات فضای نام مورد نیاز است. در صورت خالی بودن، در $PATH جستجو میشود.
--privileged-seccomp-profile="": فعالسازی یک پروفایل seccomp برای کانتینرهای ممتاز از مسیر محلی.
--profile: فعالسازی پروفایلر از راه دور pprof روی 127.0.0.1:6060.
--profile-cpu="": نوشتن پروفایل CPU با pprof در مسیر مشخصشده.
--profile-mem="": نوشتن پروفایل حافظه با pprof در مسیر مشخصشده.
--profile-port="": درگاه (پورت) برای پروفایلر pprof. (پیشفرض: 6060)
--pull-progress-timeout="": مهلت زمانی برای پیشرفت در دریافت تصویر پیش از لغو عملیات. این مقدار همچنین برای محاسبه بازه گزارش پیشرفت دریافت برابر با --pull-progress-timeout / 10 استفاده میشود. میتوان آن را روی 0 تنظیم کرد تا هم مهلت زمانی و هم نمایش خروجی پیشرفت غیرفعال شوند. (پیشفرض: 0s)
--rdt-config-file="": مسیر فایل پیکربندی RDT برای تنظیم شبهسیستم فایل resctrl.
--read-only: پیکربندی تمام کانتینرهای غیرممتاز برای اجرا به صورت فقطخواندنی. بهطور خودکار tmpfs کانتینرها را روی '/run' و '/tmp' و '/var/tmp' مانت میکند.
--root, -r="": دایرکتوری ریشه CRI-O. (پیشفرض: "/var/lib/containers/storage")
--runroot="": دایرکتوری وضعیت اجرایی CRI-O. (پیشفرض: "/run/containers/storage")
--runtimes="": زمانهای اجرای OCI، با قالب 'runtime_name:runtime_path:runtime_root:runtime_type:privileged_without_host_devices:runtime_config_path:container_min_memory'.
--seccomp-profile="": مسیر پروفایل seccomp.json برای استفاده به عنوان پیشفرض زمان اجرا. در صورت عدم تعیین، پروفایل seccomp پیشفرض داخلی استفاده خواهد شد.
--selinux: فعالسازی پشتیبانی از selinux. این گزینه منسوخ شده و در آینده بر اساس وضعیت فعال بودن SELinux روی هاست تفسیر خواهد شد.
--separate-pull-cgroup="": [آزمایشی] دریافت تصویر در cgroup جدید.
--shared-cpuset="": مجموعه CPUهایی که برای کانتینرهای تضمینشده (guaranteed) که خواهان دسترسی به CPUهای اشتراکی هستند استفاده خواهد شد.
--short-name-mode="": توصیف حالت تحلیل نام کوتاه. مقادیر مجاز 'enforcing' و 'disabled' هستند. (پیشفرض: "enforcing")
--signature-policy="": مسیر فایل JSON خطمشی امضا.
--signature-policy-dir="": مسیر دایرکتوری ریشه برای خطمشیهای امضای دارای فضای نام. باید یک مسیر مطلق باشد. (پیشفرض: "/etc/crio/policies")
--stats-collection-period="": تعداد ثانیهها بین جمعآوری آمار پاد و کانتینر. در صورت تنظیم روی 0، آمار در صورت تقاضا جمعآوری میشود. منسوخشده: این گزینه در آینده حذف خواهد شد. (پیشفرض: 0)
--storage-driver, -s="": درایور ذخیرهسازی OCI.
--storage-opt="": گزینه درایور ذخیرهسازی OCI.
--stream-address="": آدرس اتصال برای سوکت استریمینگ. (پیشفرض: "127.0.0.1")
--stream-enable-tls: فعالسازی انتقال رمزگذاریشده TLS برای سرور استریمینگ.
--stream-idle-timeout="": مدت زمان تا پایان استریمهای باز به دلیل عدم فعالیت.
--stream-port="": درگاه اتصال برای سوکت استریمینگ. اگر روی '0' تنظیم شود، CRI-O یک شماره پورت آزاد تصادفی اختصاص میدهد. (پیشفرض: "0")
--stream-tls-ca="": مسیر فایل مرجع صدور گواهی (CA) با فرمت x509 مورد استفاده برای اعتبارسنجی و احراز هویت ارتباط کلاینت با استریم رمزگذاریشده. این فایل میتواند تغییر کند و CRI-O بهطور خودکار تغییرات را اعمال خواهد کرد.
--stream-tls-cert="": مسیر فایل گواهی x509 مورد استفاده برای سرویسدهی استریم رمزگذاریشده. این فایل میتواند تغییر کند و CRI-O بهطور خودکار تغییرات را اعمال خواهد کرد.
--stream-tls-key="": مسیر فایل کلید مورد استفاده برای سرویسدهی استریم رمزگذاریشده. این فایل میتواند تغییر کند و CRI-O بهطور خودکار تغییرات را اعمال خواهد کرد.
--timezone, --tz="": تنظیم منطقه زمانی برای کانتینر در CRI-O. در صورت ارائه یک رشته خالی، CRI-O رفتار پیشفرض خود را حفظ میکند. برای تطابق با منطقه زمانی ماشین هاست از 'Local' استفاده کنید.
--tls-cipher-suites="": فهرست جداشده با کاما از مجموعهالگوریتمهای رمزنگاری (cipher suites) برای TLS 1.2.
--tls-min-version="": حداقل نسخه TLS برای سرورهای استریمینگ و معیارها (VersionTLS12 یا VersionTLS13). (پیشفرض: "VersionTLS12")
--tracing-endpoint="": آدرسی که جمعآورنده ردگیری gRPC روی آن گوش خواهد داد. (پیشفرض: "127.0.0.1:4317")
--tracing-sampling-rate-per-million="": تعداد نمونهها جهت جمعآوری به ازای هر یک میلیون span در OpenTelemetry. برای نمونهگیری دائمی روی 1000000 تنظیم کنید. (پیشفرض: 0)
--uid-mappings="": تعیین نگاشتهای UID مورد استفاده برای فضای نام کاربر. این گزینه منسوخ شده و در آینده با پشتیبانی فضای نام کاربر در کوبرنتیز (KEP-127) جایگزین خواهد شد.
--version, -v: چاپ نسخه
--version-file="": مکانی که CRI-O فایل موقت نسخه را در آن قرار میدهد. برای بررسی اینکه آیا crio wipe باید کانتینرها را پاک کند استفاده میشود، که همیشه هنگام راهاندازی مجدد نود باید اتفاق بیفتد. (پیشفرض: "/run/crio/version")
--version-file-persist="": مکانی که CRI-O فایل دائمی نسخه را در آن قرار میدهد. برای بررسی اینکه آیا crio wipe باید تصاویر را پاک کند استفاده میشود، که فقط هنگام ارتقای CRI-O باید اتفاق بیفتد.
دستورها (COMMANDS)
check
بررسی دایرکتوری ذخیرهسازی CRI-O برای یافتن خطاها.
این دستور همچنین میتواند کانتینرها، تصاویر و لایههای آسیبدیده را تعمیر کند.
بهطور پیشفرض، یکپارچگی دادههای دایرکتوری ذخیرهسازی بررسی میشود که میتواند عملیاتی سنگین از نظر ورودی/خروجی (I/O) و پردازنده (CPU) باشد. گزینه --quick میتواند برای کاهش تعداد بررسیهای اجراشده استفاده شود.
هنگام استفاده از گزینه --repair، بهویژه همراه با گزینه --force، در صورت امکان باید CRI-O و تمام کانتینرهای در حال اجرای کنونی متوقف شوند تا اطمینان حاصل شود که هیچ دسترسی همزمانی به دایرکتوری ذخیرهسازی رخ نمیدهد.
گزینه --wipe میتواند برای تلاش خودکار جهت حذف کانتینرها و تصاویر در صورت شکست عملیات تعمیر استفاده شود. این گزینه در ترکیب با گزینه --force، میتواند برای حذف کامل محتوای دایرکتوری ذخیرهسازی در صورت بروز خطاهای غیرقابل جبران استفاده شود. این کار باید به عنوان آخرین راهکار استفاده شود و مشابه گزینه --repair، بهتر است CRI-O و تمامی کانتینرهای در حال اجرای کنونی متوقف شده باشند.
--age, -a="": حداکثر سن مجاز برای لایههای بدون ارجاع (پیشفرض: "24h")
--force, -f: حذف کانتینرهای آسیبدیده
--quick, -q: انجام فقط بررسیهای سریع
--repair, -r: حذف تصاویر و لایههای آسیبدیده
--wipe, -w: پاکسازی دایرکتوری ذخیرهسازی در صورت شکست تعمیر
تکمیل خودکار (complete, completion)
تولید تکمیلکننده دستورات برای شلهای bash یا fish یا zsh.
پیکربندی (config)
خروجی گرفتن از نسخه کامنتگذاریشده فایل پیکربندی که میتواند توسط CRI-O استفاده شود. این قابلیت به شما امکان میدهد تنظیمات پیکربندی کنونی خود را ذخیره کرده و سپس بعداً با --config بارگذاری کنید. گزینههای عمومی خروجی را تغییر میدهند.
--default: خروجی پیکربندی پیشفرض (بدون در نظر گرفتن هیچ گزینه پیکربندی).
صفحه راهنما (man)
تولید مستندات صفحه راهنما (man page).
مارکداون (markdown, md)
تولید مستندات در قالب Markdown.
--help, -h: نمایش راهنما
راهنما (help, h)
نمایش فهرستی از دستورات یا راهنمای مربوط به یک دستور
وضعیت (status)
نمایش اطلاعات وضعیت
--socket, -s="": مسیر مطلق به سوکت یونیکس (پیشفرض: "/run/crio/crio.sock")
config, c
نمایش پیکربندی CRI-O در قالب یک رشته TOML.
containers, container, cs, s
نمایش اطلاعات دقیق درباره شناسه کانتینر ارائهشده.
--id, -i="": شناسه کانتینر
info, i
بازیابی اطلاعات عمومی درباره CRI-O، مانند cgroup و درایور ذخیرهسازی.
goroutines, g
نمایش پشته گورتینها (goroutine stack).
heap, hp
نوشتن دامپ هیپ (heap dump) درون یک فایل موقت و چاپ مکان آن روی دیسک.
--file, -f="": فایل خروجی دامپ هیپ.
نسخه (VERSION)
نمایش اطلاعات دقیق نسخه
--json, -j: چاپ خروجی به صورت JSON به جای متن معمولی
--verbose, -v: چاپ اطلاعات با جزئیات کامل (برای مثال تمام وابستگیهای golang)
wipe
پاکسازی فضای ذخیرهسازی کانتینر و تصویر در CRI-O
--force, -f: اجبار به پاکسازی با رد کردن بررسی نسخه
راهنما (help, h)
نمایش فهرستی از دستورات یا راهنمای یک دستور
فایلها (FILES)
crio.conf (/etc/crio/crio.conf)
فایل
پیکربندی cri-o
برای تمام
گزینههای
خط فرمان
موجود در
برنامه crio(8)،
اما در قالب
TOML که ویرایش
و
نسخهبندی
آن آسانتر
است.
policy.json (/etc/containers/policy.json)
فایلهای
خطمشی
اعتبارسنجی
امضا برای
تعیین
خطمشی
(مانند
کلیدهای
معتمد)
هنگام
تصمیمگیری
درباره
پذیرش یک
تصویر یا
امضاهای
مجزای آن
تصویر به
عنوان
معتبر
استفاده
میشوند.
registries.conf (/etc/containers/registries.conf)
فایل
پیکربندی
رجیستری،
مخازنی را
مشخص
میکند که
هنگام
تکمیل نام
تصاویری که
شامل بخش
رجیستری یا
دامنه
نیستند، به
آنها
مراجعه
میشود.
storage.conf (/etc/containers/storage.conf)
فایل
پیکربندی
ذخیرهسازی،
تمامی
گزینههای
موجود
ذخیرهسازی
کانتینر را
برای
ابزارهایی
که از فضای
ذخیرهسازی
اشتراکی
کانتینر
استفاده
میکنند
تعیین
مینماید.
محیط (ENVIRONMENT)
تمام گزینههای خط فرمان ممکن است به عنوان متغیرهای محیطی نیز تعیین شوند. با این حال، گزینههای شرح دادهشده در این بخش فقط میتوانند از طریق متغیرهای محیطی تنظیم گردند.
KUBENSMNT: مسیر یک فضای نام مانت متصلشده (bind-mounted) که CRI-O باید پیش از راهاندازی هر کانتینری به آن بپیوندد. اگر مسیر وجود نداشته باشد یا به یک bindmount فضای نام مانت اشاره نکند، CRI-O در فضای نام مانت والد خود اجرا شده و هشداری مبنی بر عدم پیوستن به فضای نام درخواستی ثبت میکند.
همچنین ببینید (SEE ALSO)
crio.conf(5), crio.conf.d(5), oci-hooks(5), policy.json(5), registries.conf(5), storage.conf(5)