From c1c6198aede0d334430f0ba4a1ab9aca7e0eb3f6 Mon Sep 17 00:00:00 2001 From: Albin Kerouanton Date: Wed, 20 Dec 2023 22:45:15 +0100 Subject: [PATCH] docs: deprecate short cid in Aliases field Related to https://github.com/moby/moby/pull/46853 Co-Authored-by: Sebastiaan van Stijn Signed-off-by: Albin Kerouanton --- docs/deprecated.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/deprecated.md b/docs/deprecated.md index 95eee9df3c..758f4014be 100644 --- a/docs/deprecated.md +++ b/docs/deprecated.md @@ -50,6 +50,7 @@ The table below provides an overview of the current status of deprecated feature | Status | Feature | Deprecated | Remove | |------------|------------------------------------------------------------------------------------------------------------------------------------|------------|--------| +| Deprecated | [Container short ID in network Aliases field](#container-short-id-in-network-aliases-field) | v25.0 | v26.0 | | Deprecated | [IsAutomated field, and "is-automated" filter on docker search](#isautomated-field--and-is--automated-filter-on-docker-search) | v25.0 | - | | Removed | [logentries logging driver](#logentries-logging-driver) | v24.0 | v25.0 | | Deprecated | [OOM-score adjust for the daemon](#oom-score-adjust-for-the-daemon) | v24.0 | v25.0 | @@ -109,6 +110,21 @@ The table below provides an overview of the current status of deprecated feature | Removed | [Three arguments form in `docker import`](#three-arguments-form-in-docker-import) | v0.6.7 | v1.12 | +### Container short ID in network Aliases field + +**Deprecated in Release: v25.0** +**Target For Remove In Release: v26.0** + +The `Aliases` field returned by `docker inspect` contains the container short +ID once the container is started. This behavior is deprecated in v25.0 but +kept until the next release, v26.0. Starting with that version, the `Aliases` +field will only contain the aliases set through the `docker container create` +and `docker run` flag `--network-alias`. + +A new field `DNSNames` containing the container name (if one was specified), +the hostname, the network aliases, as well as the container short ID, has been +introduced in v25.0 and should be used instead of the `Aliases` field. + ### IsAutomated field, and "is-automated" filter on docker search **Deprecated in Release: v25.0**