From 4708e0d609906c3e7748b39e25e1fbd7df9d491e Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Tue, 9 Oct 2018 18:27:42 +0200 Subject: [PATCH 1/2] Deprecate legacy overlay storage driver The `overlay` storage driver is deprecated in favor of the `overlay2` storage driver, which has all the benefits of `overlay`, without its limitations (excessive inode consumption). The legacy `overlay` storage driver will be removed in a future release. Users of the `overlay` storage driver should migrate to the `overlay2` storage driver. The legacy `overlay` storage driver allowed using overlayFS-backed filesystems on pre 4.x kernels. Now that all supported distributions are able to run `overlay2` (as they are either on kernel 4.x, or have support for multiple lowerdirs backported), there is no reason to keep maintaining the `overlay` storage driver. Signed-off-by: Sebastiaan van Stijn (cherry picked from commit 8bc2aa45a64226db86469ee2d91248937755dcca) Signed-off-by: Sebastiaan van Stijn Upstream-commit: aa6314c6639b5d35be390e8736a69f9d5bdc3037 Component: cli --- components/cli/docs/deprecated.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/components/cli/docs/deprecated.md b/components/cli/docs/deprecated.md index 75514a0ff9..74a5a44a53 100644 --- a/components/cli/docs/deprecated.md +++ b/components/cli/docs/deprecated.md @@ -19,6 +19,22 @@ The following list of features are deprecated in Engine. To learn more about Docker Engine's deprecation policy, see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy). +### Legacy "overlay" storage driver + +**Deprecated in Release: v18.09.0** + +The `overlay` storage driver is deprecated in favor of the `overlay2` storage +driver, which has all the benefits of `overlay`, without its limitations (excessive +inode consumption). The legacy `overlay` storage driver will be removed in a future +release. Users of the `overlay` storage driver should migrate to the `overlay2` +storage driver. + +The legacy `overlay` storage driver allowed using overlayFS-backed filesystems +on pre 4.x kernels. Now that all supported distributions are able to run `overlay2` +(as they are either on kernel 4.x, or have support for multiple lowerdirs +backported), there is no reason to keep maintaining the `overlay` storage driver. + + ### Reserved namespaces in engine labels **Deprecated in Release: v18.06.0** From ff7d5feab1aa49c667a744fab164f4174abdd06a Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Tue, 9 Oct 2018 18:51:13 +0200 Subject: [PATCH 2/2] Deprecate "devicemapper" storage driver. The `devicemapper` storage driver is deprecated in favor of `overlay2`, and will be removed in a future release. Users of the `devicemapper` storage driver are recommended to migrate to a different storage driver, such as `overlay2`, which is now the default storage driver. The `devicemapper` storage driver facilitates running Docker on older (3.x) kernels that have no support for other storage drivers (such as overlay2, or AUFS). Now that support for `overlay2` is added to all supported distros (as they are either on kernel 4.x, or have support for multiple lowerdirs backported), there is no reason to continue maintenance of the `devicemapper` storage driver. Signed-off-by: Sebastiaan van Stijn (cherry picked from commit 662441ba311b98ac8eaf5b54475fa878278c0552) Signed-off-by: Sebastiaan van Stijn Upstream-commit: fde819236bbc4e706df8e83cba7020fe97fd5bc7 Component: cli --- components/cli/docs/deprecated.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/components/cli/docs/deprecated.md b/components/cli/docs/deprecated.md index 74a5a44a53..0a6e359183 100644 --- a/components/cli/docs/deprecated.md +++ b/components/cli/docs/deprecated.md @@ -34,6 +34,21 @@ on pre 4.x kernels. Now that all supported distributions are able to run `overla (as they are either on kernel 4.x, or have support for multiple lowerdirs backported), there is no reason to keep maintaining the `overlay` storage driver. +### device mapper storage driver + +**Deprecated in Release: v18.09.0** + +The `devicemapper` storage driver is deprecated in favor of `overlay2`, and will +be removed in a future release. Users of the `devicemapper` storage driver are +recommended to migrate to a different storage driver, such as `overlay2`, which +is now the default storage driver. + +The `devicemapper` storage driver facilitates running Docker on older (3.x) kernels +that have no support for other storage drivers (such as overlay2, or AUFS). + +Now that support for `overlay2` is added to all supported distros (as they are +either on kernel 4.x, or have support for multiple lowerdirs backported), there +is no reason to continue maintenance of the `devicemapper` storage driver. ### Reserved namespaces in engine labels