1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
.TH "oci.conf" "5" "Slurm Configuration File" "July 2021" "Slurm Configuration File"
.SH "NAME"
oci.conf \- Slurm configuration file for containers.
.SH "DESCRIPTION"
Slurm supports calling OCI compliant runtimes. \fBoci.conf\fP is an ASCII
file which defines parameters used by OCI runtime interface.
.LP
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.
.LP
The following oci.conf parameters are defined to control the behavior
of the \fB\-\-container\fR argument of \fBsalloc\fR, \fBsrun\fR, and \fBsbatch\fR
.TP
\fBContainerPath\fR
Override path pattern for placement of the generated OCI Container bundle
directory. See the section \fBOCI Pattern\fR for details on pattern
replacement.
.sp
Default is unique directory generated in \fBSlurmdSpoolDir\fR.
.IP
.TP
\fBCreateEnvFile=(true|false)\fR
Create environment file for container. File will have one environment variable
per line.
.sp
Default is false.
.IP
.TP
\fBRunTimeCreate\fR
Pattern for OCI runtime create operation. See the section \fBOCI Pattern\fR
for details on pattern replacement.
.sp
Default: (disabled)
.IP
.TP
\fBRunTimeDelete\fR
Pattern for OCI runtime delete operation. See the section \fBOCI Pattern\fR
for details on pattern replacement.
.sp
Default: (disabled)
.IP
.TP
\fBRunTimeKill\fR
Pattern for OCI runtime kill operation. See the section \fBOCI Pattern\fR
for details on pattern replacement.
.sp
Default: (disabled)
.IP
.TP
\fBRunTimeQuery\fR
Pattern for OCI runtime query operation (also known as state). See the section
\fBOCI Pattern\fR for details on pattern replacement.
.sp
Default: (disabled)
.IP
.TP
\fBRunTimeRun\fR
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 \fBOCI Pattern\fR for
details on pattern replacement.
.sp
Default: (disabled)
.IP
.TP
\fBRunTimeStart\fR
Pattern for OCI runtime start operation. See the section \fBOCI Pattern\fR
for details on pattern replacement.
.sp
Default: (disabled)
.IP
.SH "NOTES"
.LP
OCI container support is disabled if oci.conf does not exist. If disabled, any
user passing \fB\-\-container\fR will be doing so in a purely advisor manner.
.SH "OCI Pattern"
All of the OCI patterns will replace the following characters:
.LP
\fBReplacements\fR:
.TP
\fB%%\fR
Replace as "%".
.IP
.TP
\fB%@\fR
Replace as the command and arguments. Each argument will be
enclosed with single quotes and escaped.
.IP
.TP
\fB%b\fR
Replace as OCI Bundle Path.
.IP
.TP
\fB%e\fR
Replace as path to file containing environment if
\fBCreateEnvFile=true\fR.
.IP
.TP
\fB%j\fR
Replace as numeric job id.
.IP
.TP
\fB%n\fR
Replace as nodename.
.IP
.TP
\fB%r\fR
Replace as original path to rootfs.
.IP
.TP
\fB%s\fR
Replace as numeric step id.
.IP
.TP
\fB%t\fR
Replace as numeric step task id.
.IP
.TP
\fB%u\fR
Replace as user name.
.IP
.SH "COPYING"
Copyright (C) 2021 SchedMD LLC.
.LP
This file is part of Slurm, a resource management program.
For details, see <https://slurm.schedmd.com/>.
.LP
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.
.LP
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.
.SH "SEE ALSO"
.LP
\fBslurm.conf\fR(5)
|
