namespace.yaml(5) Slurm Configuration File namespace.yaml(5)

namespace.yaml - فایل پیکربندی اسلورم برای پلاگین namespace/linux

فایل namespace.yaml یک فایل پیکربندی با قالب YAML است که پارامترهای مورد استفاده توسط پلاگین namespace/linux اسلورم را تعریف می‌کند. بر اساس این پارامترها، پلاگین فضای‌نام (یا فضاهای‌نام) متناسب و مختص به هر کار را ایجاد خواهد کرد. پلاگین namespace/linux می‌تواند یک فضای‌نام سیستم‌فایل ایجاد کرده و یک فضای‌نام سیستم‌فایل خصوصی (یا به صورت اختیاری مشترک) بسازد و فهرستی از دایرکتوری‌ها (به طور پیش‌فرض /tmp و /dev/shm) را درون آن سوار کند، که نمایی اختصاصی از این دایرکتوری‌ها به کار ارائه می‌دهد. این مسیرها درون مکانی که توسط base_path در فایل namespace.yaml مشخص شده است سوار می‌شوند. این پلاگین همچنین می‌تواند فضاهای‌نام جدید کاربر (User) و شناسه فرایند (PID) را برای کار ایجاد کند.

هنگامی که کار به پایان می‌رسد، فضای‌نام پیاده‌سازی (unmount) شده و تمامی فایل‌های درون آن به طور خودکار حذف می‌شوند.

برای استفاده از این پلاگین‌ها، عبارت 'PrologFlags=Contain' نیز باید مطابق نمونه زیر در فایل slurm.conf شما وجود داشته باشد:

NamespaceType=namespace/linux
PrologFlags=Contain

این فایل همیشه در همان دایرکتوری حاوی slurm.conf قرار خواهد داشت.

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

فایل namespace.yaml شامل ویژگی‌های زیر است:

پیکربندی پیش‌فرض فضای‌نام. در صورت مشخص شدن، شامل فیلدهای شرح داده‌شده در گزینه‌ها (options) خواهد بود.
در صورت تعیین، استفاده از توکن‌های bpf را در پلاگین فضای‌نام غیرفعال می‌کند. استفاده از این گزینه هنگامی که ConstrainDevices در فایل cgroup.conf تنظیم شده باشد، منجر به این می‌شود که دستگاه‌ها فقط در سطح کار محدود شوند؛ اگر گام‌های مجزا دستگاه‌های کمتری نسبت به کار درخواست کنند، در عمل محدود نخواهند شد. این همچنین به ConstrainDevices اجازه می‌دهد روی هسته‌هایی (کرنل‌هایی) که توکن‌های bpf در دسترس نیستند کار کند.
فهرستی از پیکربندی‌های فضای‌نام گره. ویژگی‌های عناصر این فهرست در ادامه شرح داده شده است.

هر عنصر node_confs شامل ویژگی‌های زیر است:

فهرستی از نام‌های گره‌ها که گزینه‌ها روی آن‌ها اعمال خواهند شد.
گزینه‌های پیکربندی فضای‌نام. گزینه‌های مشخص‌شده، موارد تعیین‌شده توسط defaults را بازنویسی (override) خواهند کرد.

بخش options شامل ویژگی‌های زیر است:

این گزینه تعیین می‌کند که آیا پلاگین باید دایرکتوری BasePath را بسازد یا خیر. اگر دایرکتوری پیش از راه‌اندازی slurm از قبل ایجاد نشده است، آن را برابر 'true' قرار دهید. اگر روی true تنظیم شود، دایرکتوری با مجوز 0755 ایجاد می‌شود. دایرکتوری در طول خاموش شدن slurm حذف نمی‌گردد. اگر برابر 'false' تنظیم شود یا مشخص نگردد، پلاگین انتظار دارد دایرکتوری از قبل وجود داشته باشد. این گزینه می‌تواند به صورت سراسری یا سطربه‌سطر استفاده شود. هنگامی که dir_confs تنظیم شده باشد، هر ورودی base_path مربوط به هر دایرکتوری در dir_confs نیز ایجاد خواهد شد. این پارامتر اختیاری است.
مسیر (PATH) پایه‌ای را مشخص کنید که پلاگین فضای‌نام باید به عنوان پایه برای سوار کردن دایرکتوری‌های اختصاصی استفاده کند. این مسیر باید توسط پلاگین قابل خواندن و نوشتن باشد. پلاگین درون این مسیر دایرکتوری ویژه‌ای برای هر کار می‌سازد که سپس برای سوار کردن استفاده می‌شود. مقدار base_path در طول شروع slurmd به عنوان 'private' سوار می‌شود و تا زمان خاموش شدن سوار باقی می‌ماند. اولین «%h» در نام با نام میزبان (hostname) که slurmd روی آن اجرا می‌شود جایگزین می‌گردد. اولین «%n» در نام با نام گره Slurm که slurmd روی آن اجرا می‌شود جایگزین می‌شود. برای غیرفعال کردن پلاگین namespace/linux روی زیرمجموعه‌ای از گره‌ها هنگامی که یک تنظیم سراسری در defaults وجود دارد، PATH را برابر 'none' قرار دهید.

نکته: مقدار base_path باید برای هر گره منحصربه‌فرد باشد. اگر base_path روی یک سیستم‌فایل مشترک قرار دارد، می‌توانید از «%h» یا «%n» برای ایجاد دایرکتوری‌های منحصربه‌فرد برای هر گره استفاده کنید.

نکته: پارامتر base_path نمی‌تواند روی هیچ‌یک از مسیرهای مشخص‌شده توسط dirs تنظیم شود. استفاده از این دایرکتوری‌ها هنگام تلاش برای سوار کردن و پیاده‌سازی دایرکتوری‌های اختصاصی برای کار باعث بروز تداخل خواهد شد.

مسیر کامل و مطلق یک اسکریپت راه‌اندازی اختیاری را مشخص می‌کند. این اسکریپت پس از ساخت فضای‌نام یک کار اجرا می‌شود. متغیر محیطی SLURM_NS حاوی مسیر فضای‌نام که می‌تواند توسط دستور nsenter استفاده شود، در اختیار این اسکریپت قرار می‌گیرد. این متغیر به اسکریپت اجازه می‌دهد تا به فضای‌نام تازه ایجادشده بپیوندد و کارهای پیکربندی بیشتری را انجام دهد. این پارامتر اختیاری است.
تعداد ثانیه‌هایی که باید منتظر تکمیل clone_ns_script ماند پیش از آنکه اسکریپت شکست‌خورده تلقی شود. مقدار پیش‌فرض ۱۰ ثانیه است.
مسیر کامل و مطلق یک اسکریپت پس‌گفتار (epilog) اختیاری را مشخص می‌کند. این اسکریپت درست قبل از برچیده شدن فضای‌نام اجرا می‌شود. متغیر محیطی SLURM_NS حاوی مسیر فضای‌نام که می‌تواند توسط دستور nsenter استفاده شود، در اختیار این اسکریپت قرار می‌گیرد. این متغیر به اسکریپت اجازه می‌دهد تا به فضای‌نامی که به‌زودی حذف می‌شود بپیوندد و کارهای پاک‌سازی را انجام دهد. این پارامتر اختیاری است.
تعداد ثانیه‌هایی که باید منتظر تکمیل clone_ns_epilog ماند پیش از آنکه اسکریپت شکست‌خورده تلقی شود. مقدار پیش‌فرض ۱۰ ثانیه است.
این پارامتر حاوی فهرستی از مقادیر رشته‌ای پرچم است و مشخص می‌کند چه فضاهای‌نام دیگری باید برای کار ایجاد شوند. مقادیر معتبر شامل "CLONE_NEWPID" و "CLONE_NEWUSER" به ترتیب برای ایجاد فضاهای‌نام جدید PID و USER هستند. مقدار "CLONE_NEWNS" نیز پذیرفته می‌شود، اما همیشه فعال است.

نکته: هنگامی که CLONE_NEWUSER مشخص شود، در صورت استفاده از ConstrainDevices در cgroup.conf، پشتیبانی از توکن bpf نیز الزامی است.

فهرستی جداشده با کاما از دایرکتوری‌هایی که باید نقاط سوار کردن اختصاصی برای آن‌ها ایجاد شود. این پارامتر اختیاری است و در صورت عدم تعیین، مقدار پیش‌فرض آن "/tmp,/dev/shm" خواهد بود. این گزینه با dir_confs مانعةالجمع است. در صورت تنظیم هر دو، dir_confs اولویت خواهد داشت.

نکته: مسیر /dev/shm مدیریت ویژه‌ای دارد و به جای یک سوار کردن اتصالی (bind mount)، همیشه یک سیستم‌فایل تازه tmpfs است.

نکته: هنگامی که CLONE_NEWPID مشخص شود، یک سیستم‌فایل منحصربه‌فرد /proc برای کانتینر به طور خودکار سوار خواهد شد.

فهرستی ساختاریافته از پیکربندی‌های سوار کردن به ازای هر دایرکتوری. هر ورودی یک مسیر، ذخیره‌سازی پشتیبان اختیاری برای هر دایرکتوری، و گزینه‌های سوار کردن اختیاری را مشخص می‌کند. در صورت تنظیم، جایگزین dirs می‌شود. ویژگی‌های عناصر این فهرست در بخش تعاریف عناصر فهرست dir_confs (dir_confs list element definitions) در ادامه شرح داده شده است. این پارامتر اختیاری است.
مسیر کامل و مطلق یک اسکریپت راه‌اندازی اختیاری را مشخص می‌کند. این اسکریپت قبل از ساخت فضای‌نام یک کار اجرا می‌شود. می‌توان از آن برای پیوستن کار به فضاهای‌نام دیگر پیش از ساخت فضای‌نام /tmp یا برای هرگونه راه‌اندازی ویژه سیستم استفاده کرد. این پارامتر اختیاری است.
تنظیم Shared=true سوار کردن‌های جدید را بین فضای‌نام سیستم‌فایل مختص کار و فضای‌نام سیستم‌فایل ریشه منتقل می‌کند و استفاده از autofs را روی گره فعال می‌سازد. این پارامتر اختیاری است.
مکان اسکریپتی را مشخص می‌کند که راه‌اندازی فضای‌نام کاربر (user namespace) را انجام می‌دهد. این اسکریپت هنگام راه‌اندازی فضای‌نام در ابتدا اجرا می‌شود. متغیر محیطی "SLURM_NS_PID" برای امکان‌پذیر ساختن ساخت مسیر به فایل‌های نقشه‌برداری گوناگونی که این اسکریپت می‌تواند در آن‌ها بنویسد فراهم شده است. اگر مشخص نشود، هر کاربر و گروهی نگاشت خواهد شد.

هر عنصر dir_confs شامل ویژگی‌های زیر است:

دایرکتوری مقصد برای سوار کردن اختصاصی، مانند "/tmp". جایگزینی‌های زیر پشتیبانی می‌شوند: %j (شناسه کار)، %S (SLUID)، و %u (نام کاربری). این پارامتر الزامی است.
ریشه فضای ذخیره‌سازی پشتیبان اختیاری برای هر دایرکتوری. مقدار سراسری base_path را برای این سوار کردن بازنویسی می‌کند. یک زیردایرکتوری مختص کار در اینجا برای پشتیبانی از سوار کردن اختصاصی ایجاد خواهد شد. هنگام تنظیم tmpfs نادیده گرفته می‌شود. این پارامتر اختیاری است.
فهرستی جداشده با کاما از گزینه‌های mount. پشتیبانی برای ارسال گزینه‌های زیر به دستور mount فراهم شده است:
زمان‌های دسترسی به inode را در این سیستم‌فایل به‌روزرسانی نکن.
دستگاه‌های ویژه کاراکتری یا بلوکی را در این سیستم‌فایل تفسیر نکن.
زمان‌های دسترسی به inode دایرکتوری را در این سیستم‌فایل به‌روزرسانی نکن.
اجرای مستقیم فایل‌های باینری را در سیستم‌فایل سوارشده مجاز ندان.
بیت‌های set-user-ID و set-group-ID یا قابلیت‌های فایل را هنگام اجرای برنامه‌ها از این سیستم‌فایل در نظر نگیر.
زمان‌های دسترسی به inode را متناسب با زمان تغییر یا اصلاح به‌روزرسانی کن.
سیستم‌فایل را به صورت فقط‌خواندنی سوار کن.
برای سوار کردن‌های tmpfs، گزینه‌های داده‌ای اضافی مانند size=4g و mode=1777 نیز می‌توانند مشخص شوند و مستقیماً به هسته (کرنل) ارسال می‌شوند. گزینه‌هایی که به عنوان پرچم شناخته نشوند به عنوان داده سوار کردن tmpfs تلقی شده و در سوار کردن‌های bind بدون اعلام خطا نادیده گرفته می‌شوند. این پارامتر اختیاری است.

نکته: سوار کردن‌های tmpfs صرف‌نظر از این تنظیم، همیشه دارای nosuid و nodev هستند.

اگر روی true تنظیم شود، به جای ایجاد یک سوار کردن bind پشتیبانی‌شده توسط base_path، یک tmpfs تازه را در این مسیر سوار می‌کند. این پارامتر اختیاری است.

اگر هر پارامتری در namespace.yaml در هنگام اجرای slurm تغییر داده شود، سرویس slurmd در گره‌های مربوطه برای اعمال تغییرات باید مجدداً راه‌اندازی شود (اجرای دستور scontrol reconfigure کافی نیست). علاوه بر این، این موضوع می‌تواند باعث اختلال در کارهایی شود که هم‌اکنون روی گره در حال اجرا هستند. بنابراین باید دقت شود تا در صورت استقرار هرگونه تغییری در namespace.yaml، هیچ کاری در حال اجرا نباشد.

راه‌اندازی مجدد slurmd تا زمانی که namespace.yaml بین راه‌اندازی‌های مجدد تغییر نکرده باشد، ایمن بوده و بدون اختلال در کارهای در حال اجرا انجام می‌شود، که در غیر این صورت نکته بالا صادق خواهد بود.

---
defaults:
  auto_base_path: true
  base_path: "/var/nvme/storage_0"
  clone_ns_flags:
    - "CLONE_NEWPID"
    - "CLONE_NEWUSER"
    - "CLONE_NEWNS"
  clone_ns_epilog: "/path/to/epilog_script"
  clone_ns_epilog_wait: 10
  clone_ns_script: "/path/to/ns_script"
  init_script: "/path/to/init_script"
  shared: true
node_confs:
  - nodes:
    - "n1"
    - "n[2-4,6]"
    options:
      auto_base_path: true
      base_path: "/var/nvme/storage_1"
      clone_ns_script_wait: 20
      dir_confs:
        - path: "/tmp"
          options: "noexec,nosuid,size=8g"
          tmpfs: true
        - path: "/scratch"
          base_path: "/var/nvme/storage_1"
          options: "noexec,nosuid"
      shared: false
      user_ns_script: "/path/to/user_script"
  - nodes:
    - "n[7-10]"
    options:
      auto_base_path: true
      base_path: "/var/nvme/storage_2"
      init_script: "/etc/slurm/init.sh"

Copyright (C) 2025 SchedMD LLC.

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

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

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

slurm.conf(5)

Slurm Configuration File Slurm 26.05