mirror of
https://github.com/docker/docs.git
synced 2026-10-28 07:15:09 +03:00
engine: 28.3.0 release notes (#22891)
<!--Delete sections as needed --> ## Description <!-- Tell us what you did and why --> ## Related issues or tickets <!-- Related issues, pull requests, or Jira tickets --> ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
This commit is contained in:
Paweł Gronowski
GitHub
30
_vendor/github.com/docker/cli/docs/deprecated.md
generated
30
_vendor/github.com/docker/cli/docs/deprecated.md
generated
@@ -53,6 +53,7 @@ The following table provides an overview of the current status of deprecated fea
|
||||
|
||||
| Status | Feature | Deprecated | Remove |
|
||||
|------------|------------------------------------------------------------------------------------------------------------------------------------|------------|--------|
|
||||
| Deprecated | [Empty/nil fields in image Config from inspect API](#emptynil-fields-in-image-config-from-inspect-api) | v28.3 | v29.0 |
|
||||
| Deprecated | [Configuration for pushing non-distributable artifacts](#configuration-for-pushing-non-distributable-artifacts) | v28.0 | v29.0 |
|
||||
| Deprecated | [`--time` option on `docker stop` and `docker restart`](#--time-option-on-docker-stop-and-docker-restart) | v28.0 | - |
|
||||
| Removed | [Non-standard fields in image inspect](#non-standard-fields-in-image-inspect) | v27.0 | v28.2 |
|
||||
@@ -120,7 +121,34 @@ The following table provides an overview of the current status of deprecated fea
|
||||
| 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 |
|
||||
|
||||
## Configuration for pushing non-distributable artifacts
|
||||
### Empty/nil fields in image Config from inspect API
|
||||
|
||||
**Deprecated in Release: v28.3**
|
||||
**Target For Removal In Release: v29.0**
|
||||
|
||||
The `Config` field returned by `docker image inspect` (and the `GET /images/{name}/json`
|
||||
API endpoint) currently includes certain fields even when they are empty or nil.
|
||||
Starting in Docker v29.0, the following fields will be omitted from the API response
|
||||
when they contain empty or default values:
|
||||
|
||||
- `Cmd`
|
||||
- `Entrypoint`
|
||||
- `Env`
|
||||
- `Labels`
|
||||
- `OnBuild`
|
||||
- `User`
|
||||
- `Volumes`
|
||||
- `WorkingDir`
|
||||
|
||||
Applications consuming the image inspect API should be updated to handle the
|
||||
absence of these fields gracefully, treating missing fields as having their
|
||||
default/empty values.
|
||||
|
||||
For API version corresponding to Docker v29.0, these fields will be omitted when
|
||||
empty. They will continue to be included when using clients that request an older
|
||||
API version for backward compatibility.
|
||||
|
||||
### Configuration for pushing non-distributable artifacts
|
||||
|
||||
**Deprecated in Release: v28.0**
|
||||
**Target For Removal In Release: v29.0**
|
||||
|
||||
@@ -1302,7 +1302,7 @@ The list of currently supported options that can be reconfigured is this:
|
||||
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|
||||
| `debug` | Toggles debug mode of the daemon. |
|
||||
| `labels` | Replaces the daemon labels with a new set of labels. |
|
||||
| `live-restore` | Toggles [live restore](https://docs.docker.com/engine/containers/live-restore/). |
|
||||
| `live-restore` | Toggles [live restore](https://docs.docker.com/engine/daemon/live-restore/). |
|
||||
| `max-concurrent-downloads` | Configures the max concurrent downloads for each pull. |
|
||||
| `max-concurrent-uploads` | Configures the max concurrent uploads for each push. |
|
||||
| `max-download-attempts` | Configures the max download attempts for each pull. |
|
||||
|
||||
2
_vendor/github.com/moby/moby/docs/api/v1.48.yaml
generated
2
_vendor/github.com/moby/moby/docs/api/v1.48.yaml
generated
@@ -5988,7 +5988,7 @@ definitions:
|
||||
type: "integer"
|
||||
format: "uint64"
|
||||
x-nullable: true
|
||||
example: 18446744073709551615
|
||||
example: "18446744073709551615"
|
||||
|
||||
ContainerThrottlingData:
|
||||
description: |
|
||||
|
||||
2
_vendor/github.com/moby/moby/docs/api/v1.49.yaml
generated
2
_vendor/github.com/moby/moby/docs/api/v1.49.yaml
generated
@@ -5988,7 +5988,7 @@ definitions:
|
||||
type: "integer"
|
||||
format: "uint64"
|
||||
x-nullable: true
|
||||
example: 18446744073709551615
|
||||
example: "18446744073709551615"
|
||||
|
||||
ContainerThrottlingData:
|
||||
description: |
|
||||
|
||||
2
_vendor/github.com/moby/moby/docs/api/v1.50.yaml
generated
2
_vendor/github.com/moby/moby/docs/api/v1.50.yaml
generated
@@ -5863,7 +5863,7 @@ definitions:
|
||||
type: "integer"
|
||||
format: "uint64"
|
||||
x-nullable: true
|
||||
example: 18446744073709551615
|
||||
example: "18446744073709551615"
|
||||
|
||||
ContainerThrottlingData:
|
||||
description: |
|
||||
|
||||
13430
_vendor/github.com/moby/moby/docs/api/v1.51.yaml
generated
Normal file
13430
_vendor/github.com/moby/moby/docs/api/v1.51.yaml
generated
Normal file
File diff suppressed because it is too large
Load Diff
@@ -13,6 +13,14 @@ keywords: "API, Docker, rcli, REST, documentation"
|
||||
will be rejected.
|
||||
-->
|
||||
|
||||
## v1.51 API changes
|
||||
|
||||
[Docker Engine API v1.51](https://docs.docker.com/reference/api/engine/version/v1.51/) documentation
|
||||
|
||||
* `GET /images/json` now sets the value of `Containers` field for all images
|
||||
to the count of containers using the image.
|
||||
This field was previously always -1.
|
||||
|
||||
## v1.50 API changes
|
||||
|
||||
[Docker Engine API v1.50](https://docs.docker.com/reference/api/engine/version/v1.50/) documentation
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# github.com/moby/moby v28.2.1+incompatible
|
||||
# github.com/moby/moby v28.3.0+incompatible
|
||||
# github.com/moby/buildkit v0.23.1
|
||||
# github.com/docker/buildx v0.25.0
|
||||
# github.com/docker/cli v28.2.2+incompatible
|
||||
# github.com/docker/cli v28.3.0+incompatible
|
||||
# github.com/docker/compose/v2 v2.37.3
|
||||
# github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01
|
||||
# github.com/docker/scout-cli v1.15.0
|
||||
|
||||
@@ -23,6 +23,67 @@ For more information about:
|
||||
- Deprecated and removed features, see [Deprecated Engine Features](../deprecated.md).
|
||||
- Changes to the Engine API, see [Engine API version history](/reference/api/engine/version-history.md).
|
||||
|
||||
## 28.3.0
|
||||
|
||||
{{< release-date date="2025-06-24" >}}
|
||||
|
||||
For a full list of pull requests and changes in this release, refer to the relevant GitHub milestones:
|
||||
|
||||
- [docker/cli, 28.3.0 milestone](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.3.0)
|
||||
- [moby/moby, 28.3.0 milestone](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.3.0)
|
||||
|
||||
### New
|
||||
|
||||
- Add support for AMD GPUs in `docker run --gpus`. [moby/moby#49952](https://github.com/moby/moby/pull/49952)
|
||||
- Use `DOCKER_AUTH_CONFIG` as a credential store. [docker/cli#6008](https://github.com/docker/cli/pull/6008)
|
||||
|
||||
### Bug fixes and enhancements
|
||||
|
||||
- Ensure that the state of the container in the daemon database (used by [/containers/json](https://docs.docker.com/reference/api/engine/version/v1.49/#tag/Container/operation/ContainerList) API) is up to date when the container is stopped using the [/containers/{id}/stop](https://docs.docker.com/reference/api/engine/version/v1.49/#tag/Container/operation/ContainerStop) API (before response of API). [moby/moby#50136](https://github.com/moby/moby/pull/50136)
|
||||
- Fix `docker image inspect inspect` omitting empty fields. [moby/moby#50135](https://github.com/moby/moby/pull/50135)
|
||||
- Fix `docker images --tree` not marking images as in-use when the containerd image store is disabled. [docker/cli#6140](https://github.com/docker/cli/pull/6140)
|
||||
- Fix `docker pull/push` hang in non-interactive when authentication is required caused by prompting for login credentials. [docker/cli#6141](https://github.com/docker/cli/pull/6141)
|
||||
- Fix a potential resource leak when a node leaves a Swarm. [moby/moby#50115](https://github.com/moby/moby/pull/50115)
|
||||
- Fix a regression where a login prompt on `docker pull` would show Docker Hub-specific hints when logging in on other registries. [docker/cli#6135](https://github.com/docker/cli/pull/6135)
|
||||
- Fix an issue where all new tasks in the Swarm could get stuck in the PENDING state forever after scaling up a service with placement preferences. [moby/moby#50211](https://github.com/moby/moby/pull/50211)
|
||||
- Remove an undocumented, hidden, top-level `docker remove` command that was accidentally introduced in Docker 23.0. [docker/cli#6144](https://github.com/docker/cli/pull/6144)
|
||||
- Validate registry-mirrors configuration as part of `dockerd --validate` and improve error messages for invalid mirrors. [moby/moby#50240](https://github.com/moby/moby/pull/50240)
|
||||
- `dockerd-rootless-setuptool.sh`: Fix the script from silently returning with no error message when subuid/subgid system requirements are not satisfied. [moby/moby#50059](https://github.com/moby/moby/pull/50059)
|
||||
- containerd image store: Fix `docker push` not creating a tag on the remote repository. [moby/moby#50199](https://github.com/moby/moby/pull/50199)
|
||||
- containerd image store: Improve handling of errors returned by the token server during `docker pull/push`. [moby/moby#50176](https://github.com/moby/moby/pull/50176)
|
||||
|
||||
### Packaging updates
|
||||
|
||||
- Allow customizing containerd service name for OpenRC. [moby/moby#50156](https://github.com/moby/moby/pull/50156)
|
||||
- Update BuildKit to [v0.23.1](https://github.com/moby/buildkit/releases/tag/v0.23.1). [moby/moby#50243](https://github.com/moby/moby/pull/50243)
|
||||
- Update Buildx to [v0.25.0](https://github.com/docker/buildx/releases/tag/v0.25.0). [docker/docker-ce-packaging#1217](https://github.com/docker/docker-ce-packaging/pull/1217)
|
||||
- Update Compose to [v2.37.2](https://github.com/docker/compose/releases/tag/v2.37.2). [docker/docker-ce-packaging#1219](https://github.com/docker/docker-ce-packaging/pull/1219)
|
||||
- Update Docker Model CLI plugin to [v0.1.30](https://github.com/docker/model-cli/releases/tag/v0.1.30). [docker/docker-ce-packaging#1218](https://github.com/docker/docker-ce-packaging/pull/1218)
|
||||
- Update Go runtime to [1.24.4](https://go.dev/doc/devel/release#go1.24.4). [docker/docker-ce-packaging#1213](https://github.com/docker/docker-ce-packaging/pull/1213), [moby/moby#50153](https://github.com/moby/moby/pull/50153), [docker/cli#6124](https://github.com/docker/cli/pull/6124)
|
||||
|
||||
### Networking
|
||||
|
||||
- Revert Swarm related changes added in 28.2.x builds, due to a regression reported in https://github.com/moby/moby/issues/50129. [moby/moby#50169](https://github.com/moby/moby/pull/50169)
|
||||
* Revert: Fix an issue where `docker network inspect --verbose` could sometimes crash the daemon (https://github.com/moby/moby/pull/49937).
|
||||
* Revert: Fix an issue where the load-balancer IP address for an overlay network would not be released in certain cases if the Swarm was lacking an ingress network (https://github.com/moby/moby/pull/49948).
|
||||
* Revert: Improve the reliability of NetworkDB in busy clusters and lossy networks (https://github.com/moby/moby/pull/49932).
|
||||
* Revert: Improvements to the reliability and convergence speed of NetworkDB (https://github.com/moby/moby/pull/49939).
|
||||
- Fix an issue that could cause container startup to fail, or lead to failed UDP port mappings, when some container ports are mapped to `0.0.0.0` and others are mapped to specific host addresses. [moby/moby#50054](https://github.com/moby/moby/pull/50054)
|
||||
- The `network inspect` response for an overlay network now reports that `EnableIPv4` is true. [moby/moby#50147](https://github.com/moby/moby/pull/50147)
|
||||
- Windows: Improve daemon startup time in cases where the host has networks of type `"Mirrored"`. [moby/moby#50155](https://github.com/moby/moby/pull/50155)
|
||||
- Windows: Make sure `docker system prune` and `docker network prune` only remove networks created by Docker. [moby/moby#50154](https://github.com/moby/moby/pull/50154)
|
||||
|
||||
### API
|
||||
|
||||
- Update API version to 1.51. [moby/moby#50145](https://github.com/moby/moby/pull/50145)
|
||||
- `GET /images/json` now sets the value of the `Containers` field for all images to the count of containers using the image. [moby/moby#50146](https://github.com/moby/moby/pull/50146)
|
||||
|
||||
### Deprecations
|
||||
|
||||
- Empty/nil image config fields in the `GET /images/{name}/json` response are now deprecated and will be removed in v29.0. [docker/cli#6129](https://github.com/docker/cli/pull/6129)
|
||||
- api/types/container: deprecate `ExecOptions.Detach`. This field is not used, and will be removed in a future release. [moby/moby#50219](https://github.com/moby/moby/pull/50219)
|
||||
- pkg/idtools: deprecate `IdentityMapping` and `Identity.Chown`. [moby/moby#50210](https://github.com/moby/moby/pull/50210)
|
||||
|
||||
## 28.2.2
|
||||
|
||||
{{< release-date date="2025-05-30" >}}
|
||||
|
||||
@@ -73,22 +73,22 @@ To see the highest version of the API your Docker daemon and client support, use
|
||||
```console
|
||||
$ docker version
|
||||
Client: Docker Engine - Community
|
||||
Version: 28.2.2
|
||||
API version: 1.50
|
||||
Go version: go1.24.3
|
||||
Git commit: e6534b4
|
||||
Built: Fri May 30 12:07:29 2025
|
||||
OS/Arch: linux/arm64
|
||||
Version: 28.3.0
|
||||
API version: 1.51
|
||||
Go version: go1.24.4
|
||||
Git commit: 38b7060
|
||||
Built: Tue Jun 24 15:44:12 2025
|
||||
OS/Arch: linux/amd64
|
||||
Context: default
|
||||
|
||||
Server: Docker Engine - Community
|
||||
Engine:
|
||||
Version: 28.2.2
|
||||
API version: 1.50 (minimum version 1.24)
|
||||
Go version: go1.24.3
|
||||
Git commit: 45873be
|
||||
Built: Fri May 30 12:07:29 2025
|
||||
OS/Arch: linux/arm64
|
||||
Version: 28.3.0
|
||||
API version: 1.51 (minimum version 1.24)
|
||||
Go version: go1.24.4
|
||||
Git commit: 265f709
|
||||
Built: Tue Jun 24 15:44:12 2025
|
||||
OS/Arch: linux/amd64
|
||||
...
|
||||
```
|
||||
|
||||
|
||||
@@ -3,6 +3,4 @@ linkTitle: v1.50
|
||||
title: Docker Engine API v1.50 reference
|
||||
aliases:
|
||||
- /engine/api/v1.50/
|
||||
- /engine/api/latest/
|
||||
- /reference/api/engine/latest/
|
||||
---
|
||||
|
||||
8
content/reference/api/engine/version/v1.51.md
Normal file
8
content/reference/api/engine/version/v1.51.md
Normal file
@@ -0,0 +1,8 @@
|
||||
---
|
||||
linkTitle: v1.51
|
||||
title: Docker Engine API v1.51 reference
|
||||
aliases:
|
||||
- /engine/api/v1.51/
|
||||
- /engine/api/latest/
|
||||
- /reference/api/engine/latest/
|
||||
---
|
||||
8
go.mod
8
go.mod
@@ -4,20 +4,20 @@ go 1.24.0
|
||||
|
||||
require (
|
||||
github.com/docker/buildx v0.25.0 // indirect
|
||||
github.com/docker/cli v28.2.2+incompatible // indirect
|
||||
github.com/docker/cli v28.3.0+incompatible // indirect
|
||||
github.com/docker/compose/v2 v2.37.3 // indirect
|
||||
github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01 // indirect
|
||||
github.com/docker/scout-cli v1.15.0 // indirect
|
||||
github.com/moby/buildkit v0.23.1 // indirect
|
||||
github.com/moby/moby v28.2.1+incompatible // indirect
|
||||
github.com/moby/moby v28.3.0+incompatible // indirect
|
||||
)
|
||||
|
||||
replace (
|
||||
github.com/docker/buildx => github.com/docker/buildx v0.24.0
|
||||
github.com/docker/cli => github.com/docker/cli v28.2.1+incompatible
|
||||
github.com/docker/cli => github.com/docker/cli v28.3.0+incompatible
|
||||
github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.37.3
|
||||
github.com/docker/model-cli => github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01
|
||||
github.com/docker/scout-cli => github.com/docker/scout-cli v1.15.0
|
||||
github.com/moby/buildkit => github.com/moby/buildkit v0.22.0
|
||||
github.com/moby/moby => github.com/moby/moby v28.2.1+incompatible
|
||||
github.com/moby/moby => github.com/moby/moby v28.3.0+incompatible
|
||||
)
|
||||
|
||||
4
go.sum
4
go.sum
@@ -20,6 +20,8 @@ github.com/docker/buildx v0.24.0 h1:qiD+xktY+Fs3R79oz8M+7pbhip78qGLx6LBuVmyb+64=
|
||||
github.com/docker/buildx v0.24.0/go.mod h1:vYkdBUBjFo/i5vUE0mkajGlk03gE0T/HaGXXhgIxo8E=
|
||||
github.com/docker/cli v28.2.1+incompatible h1:AYyTcuwvhl9dXdyCiXlOGXiIqSNYzTmaDNpxIISPGsM=
|
||||
github.com/docker/cli v28.2.1+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
|
||||
github.com/docker/cli v28.3.0+incompatible h1:s+ttruVLhB5ayeuf2BciwDVxYdKi+RoUlxmwNHV3Vfo=
|
||||
github.com/docker/cli v28.3.0+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
|
||||
github.com/docker/compose/v2 v2.36.2 h1:rxk1PUUbhbAS6HkGsYo9xUmMBpKtVwFMNCQjE4+i5fk=
|
||||
github.com/docker/compose/v2 v2.36.2/go.mod h1:mZygkne+MAMu/e1B28PBFmG0Z0WefbxZ/IpcjSFdrw8=
|
||||
github.com/docker/compose/v2 v2.37.0 h1:R8Yik9ssiRz7T9BRfdOZy0xHDzOFPIJX40DrxzJ62dQ=
|
||||
@@ -92,6 +94,8 @@ github.com/moby/docker-image-spec v1.3.1 h1:jMKff3w6PgbfSa69GfNg+zN/XLhfXJGnEx3N
|
||||
github.com/moby/docker-image-spec v1.3.1/go.mod h1:eKmb5VW8vQEh/BAr2yvVNvuiJuY6UIocYsFu/DxxRpo=
|
||||
github.com/moby/moby v28.2.1+incompatible h1:UYmHExYP8S0uGKDozhYw7RJ+LpANL51g4fa3qT0Q2GA=
|
||||
github.com/moby/moby v28.2.1+incompatible/go.mod h1:fDXVQ6+S340veQPv35CzDahGBmHsiclFwfEygB/TWMc=
|
||||
github.com/moby/moby v28.3.0+incompatible h1:BnZpCciB9dCnfNC+MerxqsHV4I6/gLiZIzzbRFJIhUY=
|
||||
github.com/moby/moby v28.3.0+incompatible/go.mod h1:fDXVQ6+S340veQPv35CzDahGBmHsiclFwfEygB/TWMc=
|
||||
github.com/moby/sys/atomicwriter v0.1.0 h1:kw5D/EqkBwsBFi0ss9v1VG3wIkVhzGvLklJ+w3A14Sw=
|
||||
github.com/moby/sys/atomicwriter v0.1.0/go.mod h1:Ul8oqv2ZMNHOceF643P6FKPXeCmYtlQMvpizfsSoaWs=
|
||||
github.com/moby/sys/sequential v0.6.0 h1:qrx7XFUd/5DxtqcoH1h438hF5TmOvzC/lspjy7zgvCU=
|
||||
|
||||
@@ -133,16 +133,16 @@ params:
|
||||
# Use `grep` to figure out how they might be used.
|
||||
|
||||
# Latest version of the Docker Engine API
|
||||
latest_engine_api_version: "1.50"
|
||||
latest_engine_api_version: "1.51"
|
||||
# Latest version of Docker Engine
|
||||
docker_ce_version: "28.2.2"
|
||||
docker_ce_version: "28.3.0"
|
||||
# Previous version of the Docker Engine
|
||||
# (Used to show e.g., "latest" and "latest"-1 in engine install examples
|
||||
docker_ce_version_prev: "28.1.0"
|
||||
docker_ce_version_prev: "28.2.2"
|
||||
# Latest Docker Compose version
|
||||
compose_version: "v2.37.3"
|
||||
# Latest BuildKit version
|
||||
buildkit_version: "0.22.0"
|
||||
buildkit_version: "0.23.1"
|
||||
|
||||
# Example runtime/library/os versions
|
||||
example_go_version: "1.24"
|
||||
|
||||
Reference in New Issue
Block a user