oci.conf - Man Page

Slurm configuration file for containers.

Description

Slurm supports calling OCI compliant runtimes. oci.conf is an ASCII file which defines parameters used by OCI runtime interface.

Parameter names are case insensitive. Any text following a "#" in the configuration file is treated as a comment through the end of that line. Changes to the configuration file take effect upon restart of Slurm daemons.

The following oci.conf parameters are defined to control the behavior of the --container argument of salloc, srun, and sbatch

ContainerPath

Override path pattern for placement of the generated OCI Container bundle directory. See the section OCI Pattern for details on pattern replacement.

Default is unique directory generated in SlurmdSpoolDir.

CreateEnvFile=(true|false)

Create environment file for container. File will have one environment variable per line.

Default is false.

RunTimeCreate

Pattern for OCI runtime create operation.  See the section OCI Pattern for details on pattern replacement.

Default: (disabled)

RunTimeDelete

Pattern for OCI runtime delete operation.  See the section OCI Pattern for details on pattern replacement.

Default: (disabled)

RunTimeKill

Pattern for OCI runtime kill operation.  See the section OCI Pattern for details on pattern replacement.

Default: (disabled)

RunTimeQuery

Pattern for OCI runtime query operation (also known as state).  See the section OCI Pattern for details on pattern replacement.

Default: (disabled)

RunTimeRun

Pattern for OCI runtime run operation. This is not provided in the OCI runtime specification (<=v1.0) but is provided by multiple OCI runtimes to simplify execution of containers. If provided, it will be used in the place of create and start operations. It avoids the need to poll state of the container resulting in less monitoring overhead. See the section OCI Pattern for details on pattern replacement.

Default: (disabled)

RunTimeStart

Pattern for OCI runtime start operation.  See the section OCI Pattern for details on pattern replacement.

Default: (disabled)

Notes

OCI container support is disabled if oci.conf does not exist. If disabled, any user passing --container will be doing so in a purely advisor manner.

OCI Pattern

All of the OCI patterns will replace the following characters:

Replacements:

%%

Replace as "%".

%@

Replace as the command and arguments. Each argument will be enclosed with single quotes and escaped.

%b

Replace as OCI Bundle Path.

%e

Replace as path to file containing environment if CreateEnvFile=true.

%j

Replace as numeric job id.

%n

Replace as nodename.

%r

Replace as original path to rootfs.

%s

Replace as numeric step id.

%t

Replace as numeric step task id.

%u

Replace as user name.

Copying

Copyright (C) 2021 SchedMD LLC.

This file is part of Slurm, a resource management program. For details, see <https://slurm.schedmd.com/>.

Slurm is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Slurm is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

See Also

slurm.conf(5)

Info

July 2021 Slurm Configuration File