oci.conf

节: Slurm 配置文件 (5)
更新: Slurm 配置文件
索引

 

名称

oci.conf - Slurm 容器配置文件。

 

描述

Slurm 支持调用符合 OCI 的运行时。 oci.conf 是一个 ASCII 文件,定义了 OCI 运行时接口使用的参数。 该文件将始终位于与 slurm.conf 相同的目录中。

参数名称不区分大小写。 配置文件中以 "#" 开头的任何文本都被视为注释,直到该行结束。 对配置文件的更改将在 Slurm 守护进程重启时生效。

 

参数

以下 oci.conf 参数用于控制 --container 参数在 sallocsrunsbatch 中的行为。

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。仅用于 RunTimeKillRunTimeDelete

%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)


 

索引

名称
描述
参数
注意
OCI 模式
版权
另见

该文档由 man2html 使用手册页创建。
时间: 2025 年 7 月 02 日 13:21:55 GMT