oci.conf(5) Slurm Configuration File oci.conf(5)

oci.conf - فایل پیکربندی Slurm برای کانتینرها

اسلورم (Slurm) از فراخوانی محیط‌های زمان اجرای سازگار با OCI پشتیبانی می‌کند. فایل oci.conf یک فایل متنی ASCII است که پارامترهای مورد استفاده توسط رابط زمان اجرای OCI را تعریف می‌کند. این فایل همواره در همان دایرکتوری قرار دارد که slurm.conf در آن واقع شده است.

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

پارامترهای زیر در oci.conf برای کنترل رفتار آرگومان --container در دستورات salloc، srun و sbatch تعریف شده‌اند:

یک الگوی مسیر سفارشی را برای قرار دادن دایرکتوری اسپول (spool) به ازای هر گام مشخص می‌کند. اگر این گزینه تنظیم شود، مسیر بسته کانتینر OCI حاصل به ازای هر تسک، به عنوان یک زیردایرکتوری از این مسیر ایجاد خواهد شد. برای جزئیات بیشتر درباره جایگزینی الگو، به بخش الگوی OCI (OCI Pattern) مراجعه کنید.

به‌طور پیش‌فرض، یک زیردایرکتوری با نام یکتا به ازای هر گام در مسیر SlurmdSpoolDir ایجاد می‌شود.

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

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

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

پیش‌فرض: "disabled".

بازنویسی فلگ‌های اشکال‌زدایی در طول عملیات کانتینر. گزینه debugflags در slurm.conf را ببینید.

پیش‌فرض: (غیرفعال)

غیرفعال کردن حذف فایل‌های تولیدشده که به زمان اجرای OCI تحویل داده شده‌اند.

پیش‌فرض: false

فهرستی از انواع هوک‌ها که با کاما از یکدیگر جدا شده‌اند تا غیرفعال شوند.

پیش‌فرض: مجاز بودن تمام هوک‌ها.

عبارت باقاعده گسترده (Extended regular expression) برای فیلتر کردن متغیرهای محیطی از قبل. این گزینه امکان حذف متغیرها را فراهم می‌کند تا از ورود متغیرهای محیطی ناخواسته به درون کانتینرها جلوگیری شود.

مثال: EnvExclude="^(SLURM_CONF|SLURM_CONF_SERVER)="

پیش‌فرض هیچ متغیر محیطی را مستثنی نمی‌کند.

الگوی جایگزین برای مسیری در داخل کانتینر جهت مانت کردن ContainerPath. برای جزئیات مربوط به جایگزینی الگو، به بخش الگوی OCI (OCI Pattern) مراجعه کنید.

پیش‌فرض: به ContainerPath مراجعه کنید.

عبارت باقاعده گسترده برای فیلتر کردن متغیرهای محیطی پیش از فراخوانی هر یک از دستورات RunTime*. این گزینه امکان حذف متغیرها را برای جلوگیری از ارث‌بری ناخواسته آن‌ها در زمان‌های اجرای OCI فراهم می‌کند.

مثال: RunTimeEnvExclude="^(SLURM_CONF|SLURM_CONF_SERVER)="

پیش‌فرض هیچ متغیر محیطی را مستثنی نمی‌کند.

بازنویسی سطح پیش‌فرض لاگ فایل در طول عملیات کانتینر. گزینه SlurmdDebug در slurm.conf را ببینید.

پیش‌فرض: (غیرفعال)

نادیده گرفتن وجود config.json در مسیر بسته OCI و غیرفعال کردن بارگذاری config.json در صورت وجود آن.

پیش‌فرض: false است.

الگو برای عملیات create در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش الگوی OCI (OCI Pattern) مراجعه کنید.

پیش‌فرض: (غیرفعال)

الگو برای عملیات delete در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش الگوی OCI (OCI Pattern) مراجعه کنید.

پیش‌فرض: (غیرفعال)

الگو برای عملیات kill در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش الگوی OCI (OCI Pattern) مراجعه کنید.

پیش‌فرض: (غیرفعال)

الگو برای عملیات query (که با نام state نیز شناخته می‌شود) در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش الگوی OCI (OCI Pattern) مراجعه کنید.

پیش‌فرض: (غیرفعال)

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

پیش‌فرض: (غیرفعال)

الگو برای عملیات start در زمان اجرای OCI. برای جزئیات مربوط به جایگزینی الگو، به بخش الگوی OCI (OCI Pattern) مراجعه کنید.

پیش‌فرض: (غیرفعال)

مسیر مطلق به فایل اجرایی srun.

پیش‌فرض: (جستجو در PATH)

آرگومان‌های اضافی برای ارسال به srun. برای هر آرگومان یک مدخل SrunArgs جداگانه اضافه کنید.

پیش‌فرض: (غیرفعال)

بازنویسی سطح پیش‌فرض لاگ STDIO در طول عملیات کانتینر. گزینه SlurmdDebug در slurm.conf را ببینید.

پیش‌فرض: (غیرفعال)

بازنویسی سطح پیش‌فرض لاگ syslog در طول عملیات کانتینر. گزینه SlurmdSyslogDebug در slurm.conf را ببینید.

پیش‌فرض: (غیرفعال)

اگر oci.conf وجود نداشته باشد، پشتیبانی از کانتینرهای OCI غیرفعال است. در صورت غیرفعال بودن، اگر کاربری گزینه --container را مشخص کند، این کار صرفاً جنبه مشورتی خواهد داشت.

تمام الگوهای OCI نویسه‌های زیر را جایگزین خواهند کرد:

جایگزینی‌ها (Replacements):

%%
با "%" جایگزین می‌شود.
%@
با دستور و آرگومان‌ها جایگزین می‌شود. هر آرگومان درون علامت نقل‌قول تکی (single quote) قرار گرفته و اسکیپ می‌شود.
%b
با مسیر بسته OCI (یا OCI Bundle Path) جایگزین می‌شود.
%e
اگر CreateEnvFile=true باشد، با مسیر فایل حاوی متغیرهای محیطی جایگزین می‌شود.
%j
با شناسه عددی کار (numeric job id) جایگزین می‌شود.
%m
با مسیر دایرکتوری اسپول کانتینر به ازای هر گام مطابق الگوی ContainerPath جایگزین می‌شود. اگر ContainerPath تنظیم نشده باشد، این مقدار با یک زیردایرکتوری منحصربه‌فرد تحت SlurmdSpoolDir همان‌طور که در slurm.conf(5) تعریف شده جایگزین می‌گردد، یا پیش‌فرض آن "/var/spool/slurmd" خواهد بود.
%n
با نام گره (nodename) جایگزین می‌شود.
%p
با شناسه پردازه (PID) نخستین پردازه‌های منشعب‌شده جایگزین می‌شود. تنها برای استفاده در RunTimeKill یا RunTimeDelete.
%r
با مسیر اصلی به rootfs جایگزین می‌شود.
%s
با شناسه عددی گام (numeric step id) جایگزین می‌شود.
%t
با شناسه عددی تسک در گام (numeric step task id) جایگزین می‌شود.
%u
با نام کاربری (user name) جایگزین می‌شود.
%U
با شناسه کاربری عددی (numeric user id) جایگزین می‌شود.
%Z
با دایرکتوری کاری کار (مقدار گزینه --chdir) جایگزین می‌شود.

Copyright (C) 2021 SchedMD LLC.

این فایل بخشی از Slurm، یک برنامه مدیریت منابع است. برای جزئیات بیشتر، https://slurm.schedmd.com را ببینید.

اسلورم یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، مجدداً توزیع کرده و/یا تغییر دهید.

اسلورم با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

slurm.conf(5)

Slurm Configuration File Slurm 26.05