@@ -12,28 +12,30 @@ Usage
12
12
13
13
Command line summary::
14
14
15
- usage: nspawn-runner [-h] [-v] [--debug]
16
- {chroot-create,chroot-login,prepare,run,cleanup,gitlab-config,toml}
15
+ usage: nspawn-runner [-h] [-v] [--debug] [--ram-disk]
16
+ {chroot-list,chroot- create,chroot-login,chroot-maintenance ,prepare,run,cleanup,gitlab-config,toml}
17
17
...
18
-
18
+
19
19
Manage systemd-nspawn machines for CI runs.
20
-
20
+
21
21
positional arguments:
22
- {chroot-create,chroot-login,prepare,run,cleanup,gitlab-config,toml}
22
+ {chroot-list,chroot- create,chroot-login,chroot-maintenance ,prepare,run,cleanup,gitlab-config,toml}
23
23
sub-command help
24
- chroot-create create a chroot that serves as a base for ephemeral
25
- machines
24
+ chroot-list list available chroots
25
+ chroot-create create a chroot that serves as a base for ephemeral machines
26
26
chroot-login enter the chroot to perform maintenance
27
+ chroot-maintenance perform routine maintenance of chroots
27
28
prepare start an ephemeral system for a CI run
28
29
run run a command inside a CI machine
29
30
cleanup cleanup a CI machine after it's run
30
31
gitlab-config configuration step for gitlab-runner
31
32
toml output the toml configuration for the custom runner
32
-
33
- optional arguments :
33
+
34
+ options :
34
35
-h, --help show this help message and exit
35
36
-v, --verbose verbose output
36
37
--debug verbose output
38
+ --ram-disk use ram disks
37
39
38
40
Steps:
39
41
@@ -73,9 +75,17 @@ __ https://github.com/Truelite/nspawn-runner/issues/3
73
75
* ``nspawn_runner_chroot_suite ``: suite to use for debootstrap
74
76
* ``nspawn_runner_maint_recreate ``: set to true to always recreate the chroot
75
77
during maintenance. See `issue #4 `__ for details.
78
+ * ``nspawn_runner_cpu_weight ``: enable CPU accounting and set CPUWeight to this value. Defaults to 50. Set null to disable.
79
+ * ``nspawn_runner_memory_high ``: enable memory accounting and set MemoryHigh to this value. Defaults to 30%. Set null to disable.
80
+ * ``nspawn_runner_memory_max ``: enable memory accounting and set MemoryMax to this value. Defaults to 40%. Set null to disable.
81
+ * ``nspawn_runner_seccomp ``: set to true to enable seccomp filtering. Defaults to false (SYSTEMD_SECCOMP=0) to improve performance.
76
82
77
83
__ https://github.com/Truelite/nspawn-runner/issues/4
78
84
85
+ Please refer to the `systemd documentation `__ for more details on resource control.
86
+
87
+ __ https://www.freedesktop.org/software/systemd/man/systemd.resource-control.html
88
+
79
89
If ``nspawn-runner chroot-create `` finds a matching playbook, it will get
80
90
creation defaults from it, and run the playbook to customize the chroot after
81
91
creation.
0 commit comments