Clarify systemd configuration based on Containerd version (#51386)

* Clarify systemd configuration based on Containerd version

In versions 2 and up of Containerd(config version 3), systemd should be configured via the following instead:
plugins.'io.containerd.cri.v1.runtime'.containerd.runtimes.runc.options

Supporting doc:
https://github.com/containerd/containerd/blob/main/docs/cri/config.md

* Update container-runtimes.md

---------

Co-authored-by: Qiming Teng <tengqm@outlook.com>
pull/51601/head
Brian Sampson 2025-07-14 14:10:25 -05:00 committed by GitHub
parent b646a981ee
commit 7004a73682
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 13 additions and 1 deletions

View File

@ -204,7 +204,10 @@ On Windows the default CRI endpoint is `npipe://./pipe/containerd-containerd`.
#### Configuring the `systemd` cgroup driver {#containerd-systemd}
To use the `systemd` cgroup driver in `/etc/containerd/config.toml` with `runc`, set
To use the `systemd` cgroup driver in `/etc/containerd/config.toml` with `runc`,
set the following config based on your Containerd version
Containerd versions 1.x:
```
[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc]
@ -213,6 +216,15 @@ To use the `systemd` cgroup driver in `/etc/containerd/config.toml` with `runc`,
SystemdCgroup = true
```
Containerd versions 2.x:
```
[plugins.'io.containerd.cri.v1.runtime'.containerd.runtimes.runc]
...
[plugins.'io.containerd.cri.v1.runtime'.containerd.runtimes.runc.options]
SystemdCgroup = true
```
The `systemd` cgroup driver is recommended if you use [cgroup v2](/docs/concepts/architecture/cgroups).
{{< note >}}