.TH "topology.yaml" "5" "Slurm Configuration File" "Slurm 26.05" "Slurm Configuration File"

.SH "نام (NAME)"
topology.yaml \- فایل پیکربندی Slurm برای پلاگین‌های توپولوژی

.SH "توضیحات (DESCRIPTION)"

.LP
پرونده
\fBtopology.yaml\fR
یک فایل پیکربندی در قالب YAML است که چندین توپولوژی شبکه را برای بهینه‌سازی تخصیص منابع کارها در Slurm تعریف می‌کند. این فایل باید در همان دایرکتوری پرونده
\fBslurm.conf\fR
قرار داشته باشد. هر متنی پس از یک «#» در این فایل تا انتهای آن سطر به عنوان توضیح (کامنت) در نظر گرفته می‌شود.

جزئیات بیشتر در
\fBtopology.conf\fR(5)
و در راهنمای توپولوژی در دسترس است: <https://slurm.schedmd.com/topology.html>

\fBNOTE\fR:
سامانه Slurm ابتدا وجود topology.yaml را بررسی می‌کند. اگر این فایل وجود داشته باشد، topology.conf نادیده گرفته خواهد شد.
.LP

.SH "پارامترها (PARAMETERS)"
.LP
هر توپولوژی شامل مشخصه‌های زیر است:
.LP

.TP
\fBtopology\fR
نام یکتای توپولوژی که برای شناسایی آن در پیکربندی‌های پارتیشن استفاده می‌شود. این گزینه باید نخستین مشخصه باشد.
.IP

.TP
\fBcluster_default\fR
نخستین توپولوژی تعریف‌شده با
\fBcluster_default: true\fR
برای پارتیشن‌های بدون توپولوژی صریحاً مشخص‌شده و عملیات‌های سراسری کلاستر که وابسته به پارتیشن خاصی نیستند (مانند ارتباطات میان slurmctld و slurmd) استفاده خواهد شد. مقدار پیش‌فرض
\fBfalse\fR
است.
.IP

.LP
هر توپولوژی همچنین باید دقیقاً یکی از انواع توپولوژی زیر را تعریف کند:
.RS
.TP
\fBblock\fR
این توپولوژی از پلاگین
\fBtopology/block\fR
استفاده خواهد کرد. باید شامل فیلدهای اضافی باشد؛ بخش زیر را ببینید.
.IP

.TP
\fBflat\fR
در صورت تنظیم روی
\fBtrue\fR،
این توپولوژی از پلاگین
\fBtopology/flat\fR
استفاده می‌کند که در صورت مشخص نشدن TopologyPlugin یا topology.yaml پیش‌فرض است. همچنین می‌تواند روی یک فرهنگ‌لغت (dictionary) از گزینه‌ها تنظیم شود؛ بخش «تعاریف مسطح (Flat definitions)» در زیر را ببینید.
.IP

.TP
\fBring\fR
این توپولوژی از پلاگین
\fBtopology/ring\fR
استفاده خواهد کرد. باید شامل فیلدهای اضافی باشد؛ بخش زیر را ببینید.
.IP

.TP
\fBtorus3d\fR
این توپولوژی از پلاگین
\fBtopology/torus3d\fR
استفاده خواهد کرد. باید شامل فیلدهای اضافی باشد؛ بخش زیر را ببینید.
.IP

.TP
\fBtree\fR
این توپولوژی از پلاگین
\fBtopology/tree\fR
استفاده خواهد کرد. باید شامل فیلدهای اضافی باشد؛ بخش زیر را ببینید.
.IP
.RE

.SS "تعاریف بلوکی (Block definitions)"
.LP
هر توپولوژی بلوکی شامل مشخصه‌های زیر است:
.LP

.TP
\fBblock_sizes\fR
فهرستی از اندازه بلوک پایه برنامه‌ریزی‌شده، به همراه اندازه‌های بلوک سطوح بالاتری که باید اعمال شوند. مقادیر متوالی
\fBBlockSizes\fR
باید توانی از دو و بزرگ‌تر از مقادیر قبلی باشند.
.IP

.TP
\fBblocks\fR
فهرست بلوک‌های موجود در این توپولوژی. هر بلوک شامل مشخصه‌های زیر است:

.RS
.TP
\fBblock\fR
نام یک بلوک. این نام برای Slurm داخلی و اختیاری است. هر بلوک باید نامی یکتا داشته باشد. این فیلد باید مشخص شود.
.IP

.TP
\fBnodes\fR
گره‌های فرزند بلوک نام‌برده‌شده.
.IP
.RE
.IP

.SS "تعاریف درختی (Tree definitions)"
.LP
هر توپولوژی درختی شامل مشخصه زیر است:
.LP

.TP
\fBswitches\fR
فهرست سوییچ‌های موجود در این توپولوژی. هر سوییچ شامل مشخصه‌های زیر است:

.RS
.TP
\fBswitch\fR
نام یک سوییچ. این نام برای Slurm داخلی و اختیاری است. هر سوییچ باید نامی یکتا داشته باشد. این فیلد باید مشخص شود و نباید طولانی‌تر از ۶۴ نویسه باشد.
.IP

.TP
\fBchildren\fR
سوییچ‌های فرزند سوییچ نام‌برده‌شده.
.IP

.TP
\fBnodes\fR
گره‌های فرزند سوییچ برگ نام‌برده‌شده.
.IP

.RE
.IP

.SS "تعاریف حلقه‌ای (Ring definitions)"
.LP
هر توپولوژی حلقه‌ای شامل مشخصه زیر است:
.LP

.TP
\fBrings\fR
فهرست حلقه‌های موجود در این توپولوژی. هر حلقه شامل مشخصه‌های زیر است:

.RS
.TP
\fBring\fR
نام یک حلقه. این نام برای Slurm داخلی و اختیاری است. هر حلقه باید نامی یکتا داشته باشد. این فیلد باید مشخص شود.
.IP

.TP
\fBnodes\fR
فهرست مرتب‌شده‌ای از گره‌های فرزند در حلقه. برای هر حلقه حداکثر ۱۶ گره را می‌توان مشخص کرد.
.IP
.RE
.IP

.SS "تعاریف تورس سه‌بعدی (Torus3d definitions)"
.LP
هر توپولوژی torus3d شامل مشخصه زیر است:
.LP

.TP
\fBtoruses\fR
فهرستی از تعاریف تورس سه‌بعدی. هر تورس شامل مشخصه‌های زیر است:

.RS
.TP
\fBname\fR
نام تورس. این نام برای Slurm داخلی و اختیاری است. هر تورس باید نامی یکتا داشته باشد. این فیلد باید مشخص شود.
.IP

.TP
\fBdims\fR
ابعاد تورس به صورت یک شیء با فیلدهای
\fBx\fR،
\fBy\fR
و
\fBz\fR
(هر کدام یک عدد صحیح مثبت). حاصل‌ضرب x*y*z کل تعداد سلول‌های مختصاتی در تورس را مشخص می‌کند.
.IP

.TP
\fBnodes\fR
گره‌های فرزند تورس. گره‌ها به ترتیب اولویت x (تغییر سریع‌تر x) روی مختصات نگاشت می‌شوند. با
\fBregions\fR
مانعة‌الجمع است.
.IP

.TP
\fBregions\fR
فهرستی از نواحی درون تورس که زیرمجموعه‌هایی از مختصات را به گره‌ها نگاشت می‌کنند. با
\fBnodes\fR
مانعة‌الجمع است. هر ناحیه شامل مشخصه‌های زیر است:

.RS
.TP
\fBanchor\fR
مختصات شروع ناحیه به صورت یک شیء با فیلدهای
\fBx\fR،
\fBy\fR
و
\fBz\fR.
.IP

.TP
\fBdims\fR
اندازه ناحیه به صورت یک شیء با فیلدهای
\fBx\fR،
\fBy\fR
و
\fBz\fR.
این ناحیه مختصات از
\fBanchor\fR
تا
\fBanchor\fR + \fBdims\fR \- 1
را در بر می‌گیرد. این ناحیه باید درون ابعاد تورس جای گیرد (بدون پیچش یا دور زدن مرزها).
.IP

.TP
\fBnodes\fR
گره‌هایی که باید در ناحیه قرار گیرند، که به ترتیب اولویت x درون محدوده مختصاتی ناحیه نگاشت می‌شوند.
.IP
.RE
.IP

.TP
\fBplacements\fR
فهرستی از اشکال جای‌گذاری مجاز برای این تورس. کارهایی که درخواست تعدادی گره منطبق با اندازه یک جای‌گذاری دارند، به صورت یک زیرمکعب پیوسته تخصیص خواهند یافت که ممکن است مرزهای تورس را دور بزند (wrap around). کارهایی که با هیچ اندازه جای‌گذاری مطابقت نداشته باشند، تخصیصی دریافت نخواهند کرد. هر جای‌گذاری شامل مشخصه‌های زیر است:

.RS
.TP
\fBdims\fR
ابعاد شکل جای‌گذاری به صورت یک شیء با فیلدهای
\fBx\fR،
\fBy\fR
و
\fBz\fR.
حاصل‌ضرب x*y*z اندازه جای‌گذاری (تعداد گره‌ها) را تعیین می‌کند.
.IP

.TP
\fBanchor_seed\fR
آفست مختصات شروع اختیاری برای شبکه لنگر (anchor grid) به صورت یک شیء با فیلدهای
\fBx\fR،
\fBy\fR
و
\fBz\fR.
کل شبکه لنگر را به اندازه آفست داده‌شده جابه‌جا می‌کند. مقدار پیش‌فرض آن {0, 0, 0} است.
.IP

.TP
\fBanchor_spacing\fR
فاصله‌گذاری اختیاری میان لنگرهای جای‌گذاری به صورت یک شیء با فیلدهای
\fBx\fR،
\fBy\fR
و
\fBz\fR.
نحوه تولید موقعیت‌های لنگر در سراسر تورس را کنترل می‌کند. در صورت مشخص نشدن، مقدار پیش‌فرض آن
\fBdims\fR
مربوط به placement است.
.IP
.RE
.IP
.RE

.SS "تعاریف مسطح (Flat definitions)"
.LP
هر توپولوژی مسطح می‌تواند شامل مشخصه زیر باشد:
.LP

.TP
\fBalpha_step_rank\fR
در صورت تنظیم روی
\fBtrue\fR،
گره‌های تخصیص‌یافته به کار هنگام انتخاب گره‌های گام و چینش تسک‌ها، بر اساس حروف الفبا و بر حسب نام مرتب می‌شوند. به طور پیش‌فرض، ترتیب از اندیس جدول داخلی گره‌ها پیروی می‌کند که برای گره‌های پویای ثبت‌شده، نشان‌دهنده ترتیب ثبت است نه ترتیب الفبایی نام‌ها.
.IP

.SH "مثال‌ها (EXAMPLES)"
.nf
---
- topology: topo1
  cluster_default: true
  tree:
    switches:
      - switch: sw_root
        children: s[1-2]
      - switch: s1
        nodes: node[01-02]
      - switch: s2
        nodes: node[03-04]
- topology: topo2
  cluster_default: false
  block:
    block_sizes:
      - 4
      - 16
    blocks:
      - block: b1
        nodes: node[01-04]
      - block: b2
        nodes: node[05-08]
      - block: b3
        nodes: node[09-12]
      - block: b4
        nodes: node[13-16]
- topology: topo3
  cluster_default: false
  flat: true
- topology: topo3a
  cluster_default: false
  flat:
    alpha_step_rank: true
- topology: topo4
  cluster_default: false
  ring:
    rings:
      - ring: ring0
        nodes: node[01-08]
      - ring: ring1
        nodes: node[09-16]
- topology: topo5
  cluster_default: false
  torus3d:
    toruses:
      - name: pod1
        dims:
          x: 4
          y: 4
          z: 2
        nodes: node[01-32]
        placements:
          - dims:
              x: 2
              y: 2
              z: 1
          - dims:
              x: 2
              y: 2
              z: 2
          - dims:
              x: 4
              y: 4
              z: 2
.fi

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

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

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