From aaaeb80cebccf6a75cad1bd4e5a1f43ba3ca5836 Mon Sep 17 00:00:00 2001 From: Albin Kerouanton Date: Thu, 22 Feb 2024 12:13:16 +0100 Subject: [PATCH] Add a deprecation warning about --link on default nw Signed-off-by: Albin Kerouanton Signed-off-by: Sebastiaan van Stijn --- docs/deprecated.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/deprecated.md b/docs/deprecated.md index 4271bbf0ac78..37ffcbc4705b 100644 --- a/docs/deprecated.md +++ b/docs/deprecated.md @@ -113,6 +113,7 @@ The following table provides an overview of the current status of deprecated fea | Deprecated | [`-h` shorthand for `--help`](#-h-shorthand-for---help) | v1.12 | v17.09 | | Removed | [`-e` and `--email` flags on `docker login`](#-e-and---email-flags-on-docker-login) | v1.11 | v17.06 | | Deprecated | [Separator (`:`) of `--security-opt` flag on `docker run`](#separator--of---security-opt-flag-on-docker-run) | v1.11 | v17.06 | +| Deprecated | [Links on the default bridge network](#links-on-the-default-bridge-network) | v1.10 | - | | Deprecated | [Ambiguous event fields in API](#ambiguous-event-fields-in-api) | v1.10 | - | | Removed | [`-f` flag on `docker tag`](#-f-flag-on-docker-tag) | v1.10 | v1.12 | | Removed | [HostConfig at API container start](#hostconfig-at-api-container-start) | v1.10 | v1.12 | @@ -1203,6 +1204,19 @@ The `docker login` no longer automatically registers an account with the target The flag `--security-opt` doesn't use the colon separator (`:`) anymore to divide keys and values, it uses the equal symbol (`=`) for consistency with other similar flags, like `--storage-opt`. +### Links on the default bridge network + +**Deprecated in release: v1.10** +**Target for removal in release: v30.0** + +The `--link` option on `docker create` and `docker run`, when used with no +`--network` specified, was deprecated in v1.10 and will be removed in a future +release. Custom networks should be used instead. Docker 29.6 added a deprecation +warning when this option is used for the default bridge network. + +Note that the `--link` option is still supported when a non-default network +is used. + ### Ambiguous event fields in API **Deprecated in release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)**