Skip to content

Commit c97c321

Browse files
committed
docs: deprecation: OOM-score adjust for the daemon
The `oom-score-adjust` option was added to prevent the daemon from being OOM-killed before other processes. This option was mostly added as a convenience, as running the daemon as a systemd unit was not yet common. Having the daemon set its own limits is not best-practice, and something better handled by the process-manager starting the daemon. Docker v20.10 and newer no longer adjust the daemon's OOM score by default, instead setting the OOM-score to the systemd unit (OOMScoreAdjust) that's shipped with the packages. Users currently depending on this feature are recommended to adjust the daemon's OOM score using systemd or through other means, when starting the daemon. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
1 parent 67c4570 commit c97c321

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

docs/deprecated.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ The table below provides an overview of the current status of deprecated feature
5050

5151
| Status | Feature | Deprecated | Remove |
5252
|------------|------------------------------------------------------------------------------------------------------------------------------------|------------|---------|
53+
| Deprecated | [OOM-score adjust for the daemon](#oom-score-adjust-for-the-daemon) | v24.0.0 | v25.0.0 |
5354
| Removed | [Buildkit build information](#buildkit-build-information) | v23.0.0 | v24.0.0 |
5455
| Deprecated | [Legacy builder for Linux images](#legacy-builder-for-linux-images) | v23.0.0 | - |
5556
| Deprecated | [Legacy builder fallback](#legacy-builder-fallback) | v23.0.0 | - |
@@ -105,6 +106,26 @@ The table below provides an overview of the current status of deprecated feature
105106
| Removed | [`--run` flag on `docker commit`](#--run-flag-on-docker-commit) | v0.10 | v1.13 |
106107
| Removed | [Three arguments form in `docker import`](#three-arguments-form-in-docker-import) | v0.6.7 | v1.12 |
107108

109+
### OOM-score adjust for the daemon
110+
111+
**Deprecated in Release: v24.0.0**
112+
**Target For Removal In Release: v25.0.0**
113+
114+
The `oom-score-adjust` option was added to prevent the daemon from being
115+
OOM-killed before other processes. This option was mostly added as a
116+
convenience, as running the daemon as a systemd unit was not yet common.
117+
118+
Having the daemon set its own limits is not best-practice, and something
119+
better handled by the process-manager starting the daemon.
120+
121+
Docker v20.10 and newer no longer adjust the daemon's OOM score by default,
122+
instead setting the OOM-score to the systemd unit (OOMScoreAdjust) that's
123+
shipped with the packages.
124+
125+
Users currently depending on this feature are recommended to adjust the
126+
daemon's OOM score using systemd or through other means, when starting
127+
the daemon.
128+
108129
### Buildkit build information
109130

110131
**Deprecated in Release: v23.0.0**

0 commit comments

Comments
 (0)