diff --git a/docs/deprecated.md b/docs/deprecated.md index 7a68c0f60b6d..3160d8409fb8 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` and `ContainerConfig` fields in Image inspect](#image-container-fields) | v25.0 | v26.0 | | Deprecated | [Deprecate legacy API versions](#deprecate-legacy-api-versions) | v25.0 | v26.0 | | 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 | v26.0 | @@ -110,6 +111,19 @@ The table below provides an overview of the current status of deprecated feature | Removed | [`--run` flag on `docker commit`](#--run-flag-on-docker-commit) | v0.10 | v1.13 | | Removed | [Three arguments form in `docker import`](#three-arguments-form-in-docker-import) | v0.6.7 | v1.12 | +### `Container` and `ContainerConfig` fields in Image inspect + +**Deprecated in Release: v25.0** +**Target For Removal In Release: v26.0** + +The `Container` and `ContainerConfig` fields returned by `docker inspect` are +mostly an implementation detail of the classic (non-buildkit) image builder. +These informations are not portable and are empty anyway when using the +buildkit based builder (enabled by default since v23.0). +These fields are deprecated in v25.0 and will be omitted starting from v26.0. +If image configuration of an image is needed, it should be obtained from the +`Config` field. + ### Deprecate legacy API versions **Deprecated in Release: v25.0**