deprecate experimental graphdriver plugins

[Graphdriver plugins] are an experimental feature that allow extending the Docker Engine with custom storage drivers for storing images and containers. This feature was not maintained since its inception, and will no longer be supported in upcoming releases. Users of this feature are recommended to instead configure the Docker Engine to use the [containerd image store], and a custom [snapshotter]. [Graphdriver plugins]: https://github.com/docker/cli/blob/v26.1.4/docs/extend/plugins_graphdriver.md [containerd image store]: https://github.com/docker/docs/blob/31a16f1da2f4a4c94b5a82713aa012f052fb7e6d/content/storage/containerd.md [snapshotter]: https://github.com/containerd/containerd/tree/v1.7.18/docs/snapshotters Signed-off-by: Sebastiaan van Stijn <[email protected]>
docker · Jun 18, 2024 · 0bc0924 · 0bc0924
1 parent 1f1b70d
commit 0bc0924
Show file tree

Hide file tree

Showing 4 changed files with 18 additions and 411 deletions.
diff --git a/docs/deprecated.md b/docs/deprecated.md
@@ -52,6 +52,7 @@ The table below provides an overview of the current status of deprecated feature
 |------------|------------------------------------------------------------------------------------------------------------------------------------|------------|--------|
 | Deprecated | [Non-standard fields in image inspect](#non-standard-fields-in-image-inspect)                                                      | v27.0      | v28.0  |
 | Deprecated | [API CORS headers](#api-cors-headers)                                                                                              | v27.0      | v28.0  |
+| Deprecated | [Graphdriver plugins (experimental)](#graphdriver-plugins-experimental)                                                            | v27.0      | v28.0  |
 | Deprecated | [Unauthenticated TCP connections](#unauthenticated-tcp-connections)                                                                | v26.0      | v28.0  |
 | Deprecated | [`Container` and `ContainerConfig` fields in Image inspect](#container-and-containerconfig-fields-in-image-inspect)                | v25.0      | v26.0  |
 | Deprecated | [Deprecate legacy API versions](#deprecate-legacy-api-versions)                                                                    | v25.0      | v26.0  |
@@ -148,6 +149,21 @@ part of the underlying image's Config, and deprecated:
 [Docker image spec]: https://github.com/moby/docker-image-spec/blob/v1.3.1/specs-go/v1/image.go#L19-L32
 [OCI Image Spec]: https://github.com/opencontainers/image-spec/blob/v1.1.0/specs-go/v1/config.go#L24-L62
 
+### Graphdriver plugins (experimental)
+
+**Deprecated in Release: v27.0**
+**Target For Removal In Release: v28.0**
+
+[Graphdriver plugins](https://github.com/docker/cli/blob/v26.1.4/docs/extend/plugins_graphdriver.md)
+are an experimental feature that allow extending the Docker Engine with custom
+storage drivers for storing images and containers. This feature was not
+maintained since its inception, and will no longer be supported in upcoming
+releases.
+
+Users of this feature are recommended to instead configure the Docker Engine
+to use the [containerd image store](https://docs.docker.com/storage/containerd/),
+and a custom [snapshotter](https://github.com/containerd/containerd/tree/v1.7.18/docs/snapshotters)
+
 ### API CORS headers
 
 **Deprecated in Release: v27.0**

diff --git a/docs/extend/index.md b/docs/extend/index.md
@@ -2,6 +2,8 @@
 title: Docker Engine managed plugin system
 description: Develop and use a plugin with the managed plugin system
 keywords: "API, Usage, plugins, documentation, developer"
+aliases:
+  - "/engine/extend/plugins_graphdriver/"
 ---
 
 - [Installing and using a plugin](index.md#installing-and-using-a-plugin)