oci.conf
节: Slurm 配置文件 (5)更新: Slurm 配置文件
索引
名称
oci.conf - Slurm 容器配置文件。描述
Slurm 支持调用符合 OCI 的运行时。 oci.conf 是一个 ASCII 文件,定义了 OCI 运行时接口使用的参数。 该文件将始终位于与 slurm.conf 相同的目录中。
参数名称不区分大小写。 配置文件中以 "#" 开头的任何文本都被视为注释,直到该行结束。 对配置文件的更改将在 Slurm 守护进程重启时生效。
参数
以下 oci.conf 参数用于控制 --container 参数在 salloc、srun 和 sbatch 中的行为。
- ContainerPath
- 指定用于放置每步临时目录的覆盖路径模式。
如果设置此选项,生成的每个任务 OCI 容器包路径将作为该路径的子目录创建。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认情况下,每个步骤的唯一生成子目录将创建在 SlurmdSpoolDir 下。
-
- CreateEnvFile=(null|newline|disabled)
- 为容器创建环境文件。如果值为 "newline",文件将每行包含一个环境变量。如果值为 "null",文件将以 NUL(即 '\0')终止每个环境变量。如果值为 "disabled",则环境文件将不会被创建。
值 "true" 被视为 "null" 以保持向后兼容。 值 "false" 被视为 "disabled" 以保持向后兼容。
注意:当 CreateEnvFile=newline 时,任何包含换行符的环境变量将在写入环境文件之前被丢弃。
默认值为 "disabled"。
-
- DebugFlags
- 在容器操作期间覆盖调试标志。请参阅 slurm.conf 中的 debugflags。
默认值: (disabled)
-
- DisableCleanup
- 禁用删除传递给 OCI 运行时的生成文件。
默认值: false
-
- DisableHooks
- 要禁用的钩子类型的以逗号分隔的列表。
默认值: 允许所有钩子。
-
- EnvExclude
- 用于过滤环境的扩展正则表达式。这允许排除变量,以避免在容器内部出现不必要的环境变量。
示例: EnvExclude="^(SLURM_CONF|SLURM_CONF_SERVER)="
默认情况下不排除任何环境变量。
-
- MountSpoolDir
- 覆盖容器内部的路径模式以挂载 ContainerPath。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认值: 参见 ContainerPath
-
- RunTimeEnvExclude
- 在调用任何 RunTime* 命令之前过滤环境的扩展正则表达式。这允许排除变量,以避免在 OCI 运行时内部出现不必要的继承。
示例: RunTimeEnvExclude="^(SLURM_CONF|SLURM_CONF_SERVER)="
默认情况下不排除任何环境变量。
-
- FileDebug
- 在容器操作期间覆盖默认文件日志记录级别。请参阅 slurm.conf 中的 SlurmdDebug。
默认值: (disabled)
-
- IgnoreFileConfigJson=(true|false)
- 忽略 OCI 包路径中 config.json 的存在,并禁用加载 config.json(如果存在)。
默认值为 false。
-
- RunTimeCreate
- OCI 运行时创建操作的模式。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认值: (disabled)
-
- RunTimeDelete
- OCI 运行时删除操作的模式。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认值: (disabled)
-
- RunTimeKill
- OCI 运行时杀死操作的模式。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认值: (disabled)
-
- RunTimeQuery
- OCI 运行时查询操作的模式(也称为状态)。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认值: (disabled)
-
- RunTimeRun
- OCI 运行时运行操作的模式。此模式在 OCI 运行时规范中未提供(<=v1.0),但由多个 OCI 运行时提供,以简化容器的执行。如果提供,将用于替代创建和启动操作。它避免了轮询容器状态的需要,从而减少了监控开销。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认值: (disabled)
-
- RunTimeStart
- OCI 运行时启动操作的模式。有关模式替换的详细信息,请参阅 OCI 模式 部分。
默认值: (disabled)
-
- SrunPath
- srun 可执行文件的绝对路径。
默认值: (搜索 PATH)
-
- SrunArgs
- 传递给 srun 的附加参数。每个参数添加一个 SrunArgs 条目。
默认值: (disabled)
-
- StdIODebug
- 在容器操作期间覆盖默认 STDIO 日志记录级别。请参阅 slurm.conf 中的 SlurmdDebug。
默认值: (disabled)
-
- SyslogDebug
- 在容器操作期间覆盖默认 syslog 日志记录级别。请参阅 slurm.conf 中的 SlurmdSyslogDebug。
默认值: (disabled)
-
注意
如果 oci.conf 不存在,则 OCI 容器支持被禁用。如果禁用,任何传递 --container 的用户将仅以建议的方式进行。
OCI 模式
所有 OCI 模式将替换以下字符:
替换:
- %%
- 替换为 "%"。
-
- %@
- 替换为命令和参数。每个参数将用单引号括起来并转义。
-
- %b
- 替换为 OCI 包路径。
-
- %e
- 替换为包含环境的文件路径(如果 CreateEnvFile=true)。
-
- %j
- 替换为数字作业 ID。
-
- %m
- 替换为容器的每步临时目录路径,按 ContainerPath 模式。如果未设置 ContainerPath,则替换为在 SlurmdSpoolDir 下生成的唯一子目录,如 slurm.conf(5) 中定义,或默认为 "/var/spool/slurmd"。
-
- %n
- 替换为节点名称。
-
- %p
- 替换为第一个派生进程的 PID。仅用于 RunTimeKill 或 RunTimeDelete。
-
- %r
- 替换为原始根文件系统路径。
-
- %s
- 替换为数字步骤 ID。
-
- %t
- 替换为数字步骤任务 ID。
-
- %u
- 替换为用户名。
-
- %U
- 替换为数字用户 ID。
-
版权
版权所有 (C) 2021 SchedMD LLC。
该文件是 Slurm 的一部分,Slurm 是一个资源管理程序。 有关详细信息,请参见 <https://slurm.schedmd.com/>。
Slurm 是自由软件;您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发和/或修改它;许可证的第 2 版或(根据您的选择)任何更高版本。
Slurm 的分发是希望它能有用,但不提供任何担保;甚至不包括对适销性或特定用途适用性的隐含担保。有关更多详细信息,请参阅 GNU 通用公共许可证。
另见
slurm.conf(5)
索引
该文档由 man2html 使用手册页创建。
时间: 2025 年 7 月 02 日 13:21:55 GMT