.TH "oci.conf" "5" "Slurm Configuration File" "Slurm 26.05" "Slurm Configuration File"

.SH "نام (NAME)"
oci.conf \- فایل پیکربندی Slurm برای کانتینرها

.SH "توضیحات (DESCRIPTION)"
اسلورم (Slurm) از فراخوانی محیط‌های زمان اجرای سازگار با OCI پشتیبانی می‌کند. فایل \fBoci.conf\fP یک فایل متنی ASCII است که پارامترهای مورد استفاده توسط رابط زمان اجرای OCI را تعریف می‌کند.
این فایل همواره در همان دایرکتوری قرار دارد که \fBslurm.conf\fR در آن واقع شده است.

.LP
نام پارامترها نسبت به بزرگی و کوچکی حروف حساس نیستند.
هر متنی پس از یک کاراکتر «#» در فایل پیکربندی، تا انتهای همان سطر به عنوان توضیح (کامنت) در نظر گرفته می‌شود.
تغییرات اعمال‌شده در فایل پیکربندی پس از راه‌اندازی مجدد دیمن‌های Slurm اعمال خواهند شد.

.SH "پارامترها (PARAMETERS)"
.LP
پارامترهای زیر در oci.conf برای کنترل رفتار آرگومان \fB\-\-container\fR در دستورات \fBsalloc\fR، \fBsrun\fR و \fBsbatch\fR تعریف شده‌اند:

.TP
\fBContainerPath\fR
یک الگوی مسیر سفارشی را برای قرار دادن دایرکتوری اسپول (spool) به ازای هر گام مشخص می‌کند.
اگر این گزینه تنظیم شود، مسیر بسته کانتینر OCI حاصل به ازای هر تسک، به عنوان یک زیردایرکتوری از این مسیر ایجاد خواهد شد.
برای جزئیات بیشتر درباره جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
به‌طور پیش‌فرض، یک زیردایرکتوری با نام یکتا به ازای هر گام در مسیر \fBSlurmdSpoolDir\fR ایجاد می‌شود.
.IP

.TP
\fBCreateEnvFile=(null|newline|disabled)\fR
ایجاد فایل متغیرهای محیطی برای کانتینر. اگر مقدار "newline" باشد، فایل به ازای هر متغیر محیطی دارای یک سطر خواهد بود. اگر مقدار "null" باشد، انتهای هر متغیر محیطی با یک نویسه NUL (یا همان '\\0') مشخص می‌شود. اگر مقدار "disabled" باشد، فایل محیط ایجاد نخواهد شد.

مقدار "true" برای سازگاری با نسخه‌های پیشین، معادل "null" در نظر گرفته می‌شود.
مقدار "false" برای سازگاری با نسخه‌های پیشین، معادل "disabled" در نظر گرفته می‌شود.

نکته: هنگامی که CreateEnvFile=newline باشد، هر متغیر محیطی که دارای خط جدید (newline) باشد، پیش از نوشته شدن در فایل محیط حذف خواهد شد.
.sp
پیش‌فرض: "disabled".
.IP

.TP
\fBDebugFlags\fR
بازنویسی فلگ‌های اشکال‌زدایی در طول عملیات کانتینر. گزینه \fBdebugflags\fR در \fBslurm.conf\fR را ببینید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBDisableCleanup\fR
غیرفعال کردن حذف فایل‌های تولیدشده که به زمان اجرای OCI تحویل داده شده‌اند.
.sp
پیش‌فرض: false
.IP

.TP
\fBDisableHooks\fR
فهرستی از انواع هوک‌ها که با کاما از یکدیگر جدا شده‌اند تا غیرفعال شوند.
.sp
پیش‌فرض: مجاز بودن تمام هوک‌ها.
.IP

.TP
\fBEnvExclude\fR
عبارت باقاعده گسترده (Extended regular expression) برای فیلتر کردن متغیرهای محیطی از قبل. این گزینه امکان حذف متغیرها را فراهم می‌کند تا از ورود متغیرهای محیطی ناخواسته به درون کانتینرها جلوگیری شود.
.sp
مثال: \fBEnvExclude\fR="^(SLURM_CONF|SLURM_CONF_SERVER)="
.sp
پیش‌فرض هیچ متغیر محیطی را مستثنی نمی‌کند.
.IP

.TP
\fBMountSpoolDir\fR
الگوی جایگزین برای مسیری در داخل کانتینر جهت مانت کردن \fBContainerPath\fR. برای جزئیات مربوط به جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
پیش‌فرض: به \fBContainerPath\fR مراجعه کنید.
.IP

.TP
\fBRunTimeEnvExclude\fR
عبارت باقاعده گسترده برای فیلتر کردن متغیرهای محیطی پیش از فراخوانی هر یک از دستورات \fBRunTime*\fR. این گزینه امکان حذف متغیرها را برای جلوگیری از ارث‌بری ناخواسته آن‌ها در زمان‌های اجرای OCI فراهم می‌کند.
.sp
مثال: \fBRunTimeEnvExclude\fR="^(SLURM_CONF|SLURM_CONF_SERVER)="
.sp
پیش‌فرض هیچ متغیر محیطی را مستثنی نمی‌کند.
.IP

.TP
\fBFileDebug\fR
بازنویسی سطح پیش‌فرض لاگ فایل در طول عملیات کانتینر. گزینه \fBSlurmdDebug\fR در \fBslurm.conf\fR را ببینید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBIgnoreFileConfigJson=(true|false)\fR
نادیده گرفتن وجود config.json در مسیر بسته OCI و غیرفعال کردن بارگذاری config.json در صورت وجود آن.
.sp
پیش‌فرض: false است.
.IP

.TP
\fBRunTimeCreate\fR
الگو برای عملیات create در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBRunTimeDelete\fR
الگو برای عملیات delete در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBRunTimeKill\fR
الگو برای عملیات kill در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBRunTimeQuery\fR
الگو برای عملیات query (که با نام state نیز شناخته می‌شود) در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBRunTimeRun\fR
الگو برای عملیات run در زمان اجرای OCI. این عملیات در مشخصات زمان اجرای OCI (نسخه 1.0 یا پیش از آن) ارائه نشده است، اما توسط چندین محیط زمان اجرای OCI پشتیبانی می‌شود تا اجرای کانتینرها ساده‌تر گردد. در صورت مشخص شدن، این الگو به جای عملیات‌های create و start استفاده خواهد شد. این کار نیاز به بررسی دوره‌ای وضعیت (polling) کانتینر را برطرف کرده و در نتیجه بار نظارتی کمتری به همراه دارد. برای جزئیات مربوط به جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBRunTimeStart\fR
الگو برای عملیات start در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش \fBالگوی OCI (OCI Pattern)\fR مراجعه کنید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBSrunPath\fR
مسیر مطلق به فایل اجرایی srun.
.sp
پیش‌فرض: (جستجو در PATH)
.IP

.TP
\fBSrunArgs\fR
آرگومان‌های اضافی برای ارسال به srun. برای هر آرگومان یک مدخل \fBSrunArgs\fR جداگانه اضافه کنید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBStdIODebug\fR
بازنویسی سطح پیش‌فرض لاگ STDIO در طول عملیات کانتینر. گزینه \fBSlurmdDebug\fR در \fBslurm.conf\fR را ببینید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.TP
\fBSyslogDebug\fR
بازنویسی سطح پیش‌فرض لاگ syslog در طول عملیات کانتینر. گزینه \fBSlurmdSyslogDebug\fR در \fBslurm.conf\fR را ببینید.
.sp
پیش‌فرض: (غیرفعال)
.IP

.SH "نکات (NOTES)"
.LP
اگر oci.conf وجود نداشته باشد، پشتیبانی از کانتینرهای OCI غیرفعال است. در صورت غیرفعال بودن، اگر کاربری گزینه \fB\-\-container\fR را مشخص کند، این کار صرفاً جنبه مشورتی خواهد داشت.

.SH "الگوی OCI (OCI Pattern)"

تمام الگوهای OCI نویسه‌های زیر را جایگزین خواهند کرد:
.LP
\fBجایگزینی‌ها (Replacements)\fR:

.TP
\fB%%\fR
با "%" جایگزین می‌شود.
.IP

.TP
\fB%@\fR
با دستور و آرگومان‌ها جایگزین می‌شود. هر آرگومان درون علامت نقل‌قول تکی (single quote) قرار گرفته و اسکیپ می‌شود.
.IP

.TP
\fB%b\fR
با مسیر بسته OCI (یا OCI Bundle Path) جایگزین می‌شود.
.IP

.TP
\fB%e\fR
اگر \fBCreateEnvFile=true\fR باشد، با مسیر فایل حاوی متغیرهای محیطی جایگزین می‌شود.
.IP

.TP
\fB%j\fR
با شناسه عددی کار (numeric job id) جایگزین می‌شود.
.IP

.TP
\fB%m\fR
با مسیر دایرکتوری اسپول کانتینر به ازای هر گام مطابق الگوی \fBContainerPath\fR جایگزین می‌شود. اگر \fBContainerPath\fR تنظیم نشده باشد، این مقدار با یک زیردایرکتوری منحصربه‌فرد تحت \fBSlurmdSpoolDir\fR همان‌طور که در \fBslurm.conf\fR(5) تعریف شده جایگزین می‌گردد، یا پیش‌فرض آن "/var/spool/slurmd" خواهد بود.
.IP

.TP
\fB%n\fR
با نام گره (nodename) جایگزین می‌شود.
.IP

.TP
\fB%p\fR
با شناسه پردازه (PID) نخستین پردازه‌های منشعب‌شده جایگزین می‌شود. تنها برای استفاده در \fBRunTimeKill\fR یا \fBRunTimeDelete\fR.
.IP

.TP
\fB%r\fR
با مسیر اصلی به rootfs جایگزین می‌شود.
.IP

.TP
\fB%s\fR
با شناسه عددی گام (numeric step id) جایگزین می‌شود.
.IP

.TP
\fB%t\fR
با شناسه عددی تسک در گام (numeric step task id) جایگزین می‌شود.
.IP

.TP
\fB%u\fR
با نام کاربری (user name) جایگزین می‌شود.
.IP

.TP
\fB%U\fR
با شناسه کاربری عددی (numeric user id) جایگزین می‌شود.
.IP

.TP
\fB%Z\fR
با دایرکتوری کاری کار (مقدار گزینه \fB\-\-chdir\fR) جایگزین می‌شود.
.IP

.SH "کپی‌رایت و تکثیر (COPYING)"
Copyright (C) 2021 SchedMD LLC.

.LP
این فایل بخشی از Slurm، یک برنامه مدیریت منابع است.
برای جزئیات بیشتر، <https://slurm.schedmd.com> را ببینید.
.LP
اسلورم یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، مجدداً توزیع کرده و/یا تغییر دهید.
.LP
اسلورم با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

.SH "همچنین ببینید (SEE ALSO)"
.LP
\fBslurm.conf\fR(5)