Skip to content

Prepare release notes for api/v1.52.0-beta.0#50904

Merged
austinvazquez merged 2 commits intomoby:masterfrom
dmcgowan:prepare-api-1.52-beta
Sep 5, 2025
Merged

Prepare release notes for api/v1.52.0-beta.0#50904
austinvazquez merged 2 commits intomoby:masterfrom
dmcgowan:prepare-api-1.52-beta

Conversation

@dmcgowan
Copy link
Member

@dmcgowan dmcgowan commented Sep 5, 2025

Generated notes with containerd/release-tool#58

Welcome to the api/v1.52.0-beta.0 release of moby!
This is a pre-release of moby

The first dedicated release for the Moby API. This release continues the 1.x
line of API compatibility with the 52nd minor release of the 1.x API.

Highlights

API

  • The types "github.com/moby/moby/api/types/network".Summary and "github.com/moby/moby/api/types/network".Inspect are no longer aliases, and most of their fields have been moved into an embedded struct. Engine API clients may require some source-level changes to build successfully after switching to the new github.com/moby/moby/api module. (#50878)
  • api: remove unused DefaultVersion, MinSupportedAPIVersion consts (#50587)
  • API: Deprecation: the Engine was automatically backfilling empty PortBindings lists with a PortBinding with an empty HostIP and HostPort when starting a container. This behavior is deprecated for API 1.52, and will be dropped in API 1.53. (#50874)
  • Update deprecation message for AuthConfig.Email field (#50792)
  • Prefer explicit device driver name over GPU capabilities when selecting the device driver with docker run --gpus (#50717)
  • Go SDK: api/types/container: rename Port to PortSummary. (#50711)
  • GET /images/{name}/get and POST /images/load now accept multiple platform query parameters, allowing export and load of images for multiple platforms. (#50166)
  • GET /containers/json now includes a Health field describing container healthcheck status. (#50281)
  • Go SDK: api/types: remove deprecated aliases. (#50452)
  • Go SDK: api: deprecate NoBaseImageSpecifier const. This const is no longer used and will be removed in the next release. (#50437)
  • Go SDK: api/types/registry: EncodeAuthConfig: use empty string for zero value (#50426)
  • Go SDK: api/types/container: remove deprecated ContainerUpdateOKBody alias.
  • Go SDK: api/types/container: remove deprecated ContainerTopOKBody alias. (#50400)
  • Go SDK: api/types/registry: remove deprecated ServiceConfig.AllowNondistributableArtifactsCIDRs and ServiceConfig.AllowNondistributableArtifactsHostnames fields. (#50375)
  • api/types/container: deprecate ExecOptions.Detach. This field is not used, and will be removed in a future release. (#50218)
  • GET /images/json now sets the value of the Containers field for all images to the count of containers using the image. (#50146)
  • Update API version to 1.51 (#50145)
  • Fix docker image inspect inspect omitting empty fields. (#50135)

Core Engine

  • API: Deprecation: the Engine was automatically backfilling empty PortBindings lists with a PortBinding with an empty HostIP and HostPort when starting a container. This behavior is deprecated for API 1.52, and will be dropped in API 1.53. (#50874)
  • GET /images/{name}/get and POST /images/load now accept multiple platform query parameters, allowing export and load of images for multiple platforms. (#50166)

Image Distribution

  • GET /images/json now sets the value of the Containers field for all images to the count of containers using the image. (#50146)

Networking

  • The types "github.com/moby/moby/api/types/network".Summary and "github.com/moby/moby/api/types/network".Inspect are no longer aliases, and most of their fields have been moved into an embedded struct. Engine API clients may require some source-level changes to build successfully after switching to the new github.com/moby/moby/api module. (#50878)
  • API: Deprecation: the Engine was automatically backfilling empty PortBindings lists with a PortBinding with an empty HostIP and HostPort when starting a container. This behavior is deprecated for API 1.52, and will be dropped in API 1.53. (#50874)

Deprecations

  • API: Deprecation: the Engine was automatically backfilling empty PortBindings lists with a PortBinding with an empty HostIP and HostPort when starting a container. This behavior is deprecated for API 1.52, and will be dropped in API 1.53. (#50874)
  • Go-SDK: Deprecate field NetworkSettingsBase.Bridge, struct NetworkSettingsBase, all the fields of DefaultNetworkSettings, and struct DefaultNetworkSettings. (#50848)
  • api/types/strslice: deprecate StrSlice in favor of using a regular []string. (#50292)
  • api/types: move plugin types to api/types/plugin (#48114)
  • Go SDK: api: remove NoBaseImageSpecifier (#50574)
  • GO SDK: api/types/filters: remove deprecated ToParamWithVersion (#50561)
  • Go-SDK: remove deprecated types/plugins/logdriver and types/swarm/runtime packages; plugin-runtime spec is now exposed as types/swarm.RuntimeSpec and types/swarm.RuntimePrivilege (#50554)
  • Go SDK: api/types/container: remove deprecated Stats type. (#50492)
  • Go-SDK: deprecate pkg/stdcopy, which was moved to api/stdcopy. (#50462)
  • Go SDK: api/types: remove deprecated aliases. (#50452)
  • Go SDK: api: deprecate NoBaseImageSpecifier const. This const is no longer used and will be removed in the next release. (#50437)
  • Go SDK: api/types/container: remove deprecated ContainerUpdateOKBody alias.
  • Go SDK: api/types/container: remove deprecated ContainerTopOKBody alias. (#50400)
  • Go SDK: api/types/registry: remove deprecated ServiceConfig.AllowNondistributableArtifactsCIDRs and ServiceConfig.AllowNondistributableArtifactsHostnames fields. (#50375)
  • api/types/container: deprecate ExecOptions.Detach. This field is not used, and will be removed in a future release. (#50218)

Please try out the release binaries and report any issues at
https://github.com/moby/moby/issues.

Contributors

  • Sebastiaan van Stijn
  • Austin Vazquez
  • Derek McGowan
  • Paweł Gronowski
  • Cory Snider
  • Akihiro Suda
  • Matthieu MOREL
  • Albin Kerouanton
  • Hannes Ortmeier
  • Rob Murray
  • Cesar Talledo
  • Evan Lezar
  • Jiří Moravčík
  • Muhammad Daffa Dinaya
  • Nicolas De Loof
  • Niel Drummond

Changes

254 commits

  • d904f3b625 Prepare api/1.52.0-beta releases
  • api/docs: update v1.52 docs with current swagger (#50899)
    • ccf1363680 api/docs: update v1.52 docs with current swagger
  • api/types/network: separate Summary from Inspect (#50878)
    • 1a86389419 api/types/network: separate Summary from Inspect
  • api/types/image: make InspectResponse.GraphDriver optional (#50893)
    • c441b2ef19 api/types/image: make InspectResponse.GraphDriver optional
  • daemon: filter networks before converting to API types (#50860)
    • f8bd170b2a daemon: validate args in network.New*Filter
  • api: remove unused DefaultVersion, MinSupportedAPIVersion consts (#50587)
    • e46a991dc5 api: remove unused DefaultVersion, MinSupportedAPIVersion consts
  • api/types/system: move SecurityOpt and DecodeSecurityOptions to client mod (#50825)
    • e2e9f36c5f api/types/system: move SecurityOpt type and DecodeSecurityOptions to client
  • daemon: backfill empty PBs slices for backward compat (#50874)
    • 0ca7ac3258 daemon: backfill empty PBs slices for backward compat
  • api/types/registry: move ServiceConfig legacy field marshaling support into daemon backend (#50826)
    • c9fdad2552 daemon: marshal legacy registry.ServiceConfig extra fields for compatability
  • api/t/ctr: deprecate NetworkSettingsBase, DefaultNetworkSettings (#50848)
    • b7c597ec35 api/t/ctr: deprecate DefaultNetworkSettings
    • 80bb864fd6 api/t/ctr: deprecate NetworkSettingsBase
    • 16dc39136c api/t/ctr: deprecate NetworkSettingsBase.Bridge
  • api/types/network: move network create/connect/disconnect options from api to client (#50817)
    • 1b4fcb8da7 api/types/network: move CreateOptions type to client module
    • 1e249cc309 api/types/network: move connect/disconnect options types to client module
  • api/types/container: merge InspectResponse and ContainerJSONBase (#50809)
    • fae54e03af api/types/container: merge InspectResponse and ContainerJSONBase
  • api/types/image: move image options from api to client (#50776)
    • 853aed171b api/types/image: move image option types to client
  • api/types/swarm: move SecretListOptions type to client (#50816)
    • 33066cddb1 api/types/swarm: move SecretListOptions type to client
  • api/types/swarm: move swarm option types to client (#50794)
    • 94d0b10503 api/types/swarm: move ServiceInspectOptions type to client
    • a2291e5eac api/types/swarm: move ServiceListOptions type to client
    • 3b1e16594b api/types/swarm: move ServiceUpdateOptions type to client
    • bb4125e89f api/types/swarm: move ServiceCreateOptions type to client
    • 4dcc7af116 api/types/swarm: move UpdateFlags type to client
    • ad0fa5a872 api/types/swarm: move TaskListOptions type to client
    • 2718f953f0 api/types/swarm: move NodeRemoveOptions to client
    • 7d2b87e95f api/types/swarm: move NodeListOptions to client mod
    • b1260cd493 api/types/swarm: move ConfigListOptions to client
  • api/types/registry: move auth config functions to pkg (#50785)
    • bdce1608c8 api: move authconfig package from types/registry to pkg
  • api: docs: update v1.52 swagger with latest changes (#50796)
    • eed354379c api: docs: update v1.52 swagger with latest changes
  • api/types/registry: update deprecation comment for AuthConfig.Email (#50792)
    • d867f9f0f1 api/docs: update description for AuthConfig.Email field
    • 6cfff7e880 api/types/registry: update deprecation comment for AuthConfig.Email
  • api/types/network: move network options from api to client (#50786)
    • 5eaed0366c api/types/network: move InspectOptions to client mod
    • d6aa6ae9bd api/types/network: move ListOptions to client
  • api/types/registry: move registry search options to client (#50787)
    • 40025bdf43 api/types/registry: move SearchOptions to client
  • api/types/volume: move volume list options from api to client (#50789)
    • 9fc6a1e437 api/types/volume: refactor volume options to prune report
    • c48585f104 api/types/volume: move ListOptions to client mod
  • api/types/system: move DiskUsageOptions to client mod (#50788)
    • 56626a1222 api/types/system: move DiskUsageOptions to client mod
  • api/types/events: move events list options from api to client (#50774)
    • d73dd4990c api/types/events: move ListOptions type to client
  • api/types/container: move container resize options from api to client (#50773)
    • 882fd68b1b api/types/container: move ResizeOptions type to client
  • api/types: move disk usage structs to daemon backend (#50764)
    • c4e82bab70 api/types/volume: move DiskUsage type internal to daemon backend
    • 0d61b55add api/types/image: move DiskUsage type internal to daemon backend
    • 566c44edfe api/types/container: move DiskUsage type internal to daemon backend
    • d588092be2 api/types/build: move internal to daemon backend
  • api: bump github.com/google/go-cmp v0.7.0 (#50723)
    • b13ea83488 api: bump github.com/google/go-cmp v0.7.0
  • Match device driver on name and ignore capabilities (#50717)
    • 48038347d7 Match device driver on name and ignore capabilities
  • Copy the api/types/time package to internal client/daemon packages (#50722)
    • 812aa46d81 Move the api/types/time package to internal daemon package
  • api/types/container: rename Port to PortSummary (#50711)
    • 82ba7fef17 api/types/container: rename Port to PortMapping
  • api: swagger: Tweak type of ForceUpdate to uint64 (#50679)
    • 185ae7ec2c docs: api: Tweak type of ForceUpdate to uin64
    • c8173c5c1f api: swagger: Tweak type of ForceUpdate to uint64
  • api/types/network: modernize EndpointIPAMConfig.Copy, EndpointSettings.Copy (#50690)
    • 11094e27b0 api/types/network: modernize EndpointIPAMConfig.Copy, EndpointSettings.Copy
  • Deprecate api/types/strslice.StrSlice and remove its use (#50292)
    • 98790830eb Deprecate api/types/strslice.StrSlice and remove its use
  • README: update, add badges (#50665)
  • vendor: github.com/docker/go-connections v0.6.0 (#50126)
    • 677c2a19d9 vendor: github.com/docker/go-connections v0.6.0
  • api/docs: sync v1.52 swagger with current version (#50643)
    • 234349d173 api/docs: sync v1.52 swagger with current version
  • docs: api: improve the docs of the outputs parameter (#50338)
    • 833dc69ad9 docs: improve the description of the outputs parameter for /build endpoint
  • api/types: move plugin types to api/types/plugin (#48114)
    • c13266d2c0 api/types: move plugin types to api/types/plugin
  • Prepare release notes for v1.52.0-alpha.0 (#50625)
  • api/types: move ErrorResponse to common/ErrorResponse (#50632)
    • c17d43ae67 api/types: move ErrorResponse to common/ErrorResponse
  • api/docs: add v1.52 swagger (#50626)
  • apk/pkg/stdcopy: remove use of iota, improve docs, and add example (#50612)
  • api/types/strslice: use slices.Equal (#50608)
  • api: update "interface{}" to "any" (#50609)
  • api/types: fix Plugin.Config.Interface.Types Swagger definition (#50519)
    • ee560a3b23 api/types: fix Plugin.Config.Interface.Types def'n
    • 2783f80ecf api/types: generate with latest go-swagger
  • update github and pkg.go.dev links (#50590)
  • Revert "api/types/registry: EncodeAuthConfig: use empty string for zero value" (#50583)
    • e55d294ea7 api/types/registry: add TODO/note about empty authConfigs
    • 8b68b977b1 Revert "api/types/registry: EncodeAuthConfig: use empty string for zero value"
  • pkg/jsonmessage: stop printing deprecated progressDetail, errorDetail, remove DisplayJSONMessagesToStream and Stream interface (#49264)
    • fdaccdb233 pkg/jsonmessage: stop printing deprecated progressDetail, errorDetail
  • api/types/container: add aliases for go-connections/nat types (#50573)
    • 494677f93f api/types/container: add aliases for go-connections/nat types
  • Move jsonmessage, streamformatter, and progress (#50565)
    • d00ecdc479 Move pkg/streamformatter to api/pkg/streamformatter
    • 66862e14d1 Move pkg/progress to api/pkg/progress
    • 1da417980c Move api/stdcopy to api/pkg/stdcopy
    • f4127d76c5 pkg/jsonmessage: move JSONProgress to api/types/jsonstream
    • 0515e1c991 pkg/jsonmessage: move JSONError to api/types/jsonstream
  • api: remove deprecated NoBaseImageSpecifier (#50574)
    • 94ac102e4b api: remove deprecated NoBaseImageSpecifier
  • api/types/filters: remove deprecated ToParamWithVersion (#50561)
    • 6c7e2909c2 api/types/filters: remove deprecated ToParamWithVersion
  • Move logdriver interface (#50554)
  • api/types/container: move StateStatus, NewStateStatus internal again (#50495)
    • ec3e83a7b5 api/types/container: move StateStatus, NewStateStatus internal again
  • api/types/container.StatsResponseReader: move to client (#50521)
    • f67e6555bf api/types/container.StatsResponseReader: move to client
  • cli/ is not in moby repo (anymore) (#50537)
  • api/types: move backend types to daemon/server (#50534)
    • 83510a26b3 api/types: move backend types to daemon/server
  • api: move "DiskUsage" related types to the right location (#50518)
    • 96a6884cb3 api/types: move DiskUsage types to api/types/system
    • 82c069c857 api/types/system: move DiskUsage, DiskUsageOptions to api/types/backend
  • api/types: move client.go contents into moby/moby/client (#50510)
    • 24aa86991c api/types: move PluginCreateOptions to client
    • b93ad81898 api/types: move plugin client options into client
    • 44ae4cd2b7 api/types: move HijackedResponse into client
  • api: move docs to api module (#50491)
  • api/types/container: remove deprecated Stats type (#50492)
    • f1a97bda3d api/types/container: remove deprecated Stats type
  • api/types/container: add missing type for exec-inspect response. (#50482)
    • 2a342079c6 api/types/container: add missing type for exec-inspect response.
  • Add support for multiple platforms in image export and load (#50166)
    • fcc8209e12 Add support for multiple platforms in image export and loading.
  • api: remove references to old module name (#50474)
    • cc9e6a13a2 api/types/swarm/runtime: remove module path for generating proto
    • 76c1afeb97 api/types/plugins/logdriver: remove module path for generating proto
    • 85ecf8c0f4 api: update references to old module name
    • a17a2e8f3d api/stdcopy: touch-up godoc
    • 5b8ef1aff2 api: remove redundant //go:build lines
  • Add HealthStatus attribute on the docker ps command (#50281)
    • 6e7a2c830d Add Health attribute on the docker ps command
  • deprecate pkg/stdcopy, move to api/stdcopy (#50462)
    • 20d594fb79 deprecate pkg/stdcopy, move to api/stdcopy
  • Create github.com/moby/moby/api and github.com/moby/moby/client module (#50280)
    • afd6487b2e Create github.com/moby/moby/api module
  • api/types: remove deprecated aliases (#50452)
    • 18e463a082 api/types: remove deprecated RequestPrivilegeFunc type
    • a3920ae6a0 api/types: remove deprecated IDResponse type
    • 3e5a06179e api/types: remove deprecated container-inspect types
    • 8347b05435 api/types: remove deprecated Container type
    • f050df0329 api/types: remove deprecated ContainerState type
    • 7abeb4d5a4 api/types: remove deprecated container-networksettings types
    • c5a2194b5d api/types: remove deprecated container Health types
    • 76bf0e2929 api/types: remove deprecated MountPoint
    • 207db8792e api/types: remove deprecated Port
    • fa8177ba7a api/types: remove deprecated GraphDriverData
    • 836ec65d5f api/types: remove deprecated ImageInspect, RootFS
    • 7d3459e7fb api/types: remove deprecated SecretCreateResponse, SecretListOptions
    • 68744c8b05 api/types: remove deprecated ConfigCreateResponse, ConfigListOptions
    • 33f07ff3f4 api/types: remove deprecated NodeListOptions, NodeRemoveOptions
    • f13796d2af api/types: remove deprecated TaskListOptions
    • 72b1e11264 api/types: remove deprecated ServiceCreateOptions
    • 3faead6fc1 api/types: remove deprecated ServiceUpdateOptions
    • 55ad118eaf api/types: remove deprecated ServiceListOptions, ServiceInspectOptions
    • 91558ae3f3 api/types: remove deprecated SwarmUnlockKeyResponse
    • 74fe646ac2 api/types: remove deprecated build-cache types
    • 3eac6e7888 api/types: remove deprecated BuildResult
    • 088cb2ffa6 api/types: remove deprecated build-related types
  • api: deprecate NoBaseImageSpecifier (#50437)
  • api/types/registry: EncodeAuthConfig: use empty string for zero value (#50426)
    • 3a447bc079 api/types/registry: EncodeAuthConfig: use empty string for zero value
  • api/types/registry: DecodeAuthConfig: add early returns and improve errors (#50425)
    • 472e09ac47 api/types/registry: DecodeAuthConfig: add early returns and improve errors
    • 6865032baa api/types/registry: add BenchmarkDecodeAuthConfig
  • api: bump to 1.52 (#50418)
  • api/types/registry: add some tests for encoding/decoding authconfig (#50392)
    • d30e61bff4 api/types/registry: add some tests for encoding/decoding authconfig
  • api/types/container: remove deprecated ContainerUpdateOKBody, ContainerTopOKBody (#50400)
    • 4a8d77c958 api/types/container: remove deprecated ContainerTopOKBody alias
    • 3d8d9c2bb3 api/types/container: remove deprecated ContainerUpdateOKBody alias
  • api/types/registry: remove deprecated fields for non-distributable artifacts (#50375)
    • 11a18d3b00 api/types/registry: remove deprecated fields for non-distributable artifacts
  • daemon/server: remove compatibility with API v1.4 auth-config on push (#50371)
    • ea29dffaa5 daemon/server: remove compatibility with API v1.4 auth-config on push
  • api: swagger: Tweak type of GwPriority to integer (#50333)
    • 51d6687754 api: swagger: Tweak type of GwPriority to integer
  • Add progress aux emitter to build backend (#50278)
    • a824db247f Add progress aux emitter to build backend
  • Move api server packages to daemon (#50004)
    • 87238882e0 Move api/server to daemon/server
    • 3a6e3f85c6 Move api/server/backend/build to daemon/build
    • 79f802d46a Move api/server/httputils to daemon/server/httputils
    • c7a87f0dee Move api/server/httpstatus to daemon/server/httpstatus
    • d64bd2cceb Move api/server/middleware to daemon/server/middleware
    • 72a020fcd8 Move api/server/router to daemon/server/router
    • f293628f55 Move api/server/router/volume to daemon/server/router/volume
    • 15c8007064 Move api/server/router/system to daemon/server/router/system
    • 45172bbf23 Move api/server/router/swarm to daemon/server/router/swarm
    • f6ba5a5241 Move api/server/router/session to daemon/server/router/session
    • 3eb5fe0277 Move api/server/router/plugin to daemon/server/router/plugin
    • baa58ddc6a Move api/server/router/network to daemon/server/router/network
    • 0cbb4ac8e6 Move api/server/router/image to daemon/server/router/image
    • a063389af7 Move api/server/router/grpc to daemon/server/router/grpc
    • 9ff489863c Move api/server/router/distribution to daemon/server/router/distribution
    • ced7798ed8 Move api/server/router/debug to daemon/server/router/debug
    • 3a9db5fbd6 Move api/server/router/container to daemon/server/router/container
    • d6136b660f Move api/server/router/checkpoint to daemon/server/router/checkpoint
    • 31b6886eb1 Move api/server/router/build to daemon/server/router/build
  • Replace multierror function in network api types (#50273)
    • 374fa24a53 Add multierror function to api network
  • fix: easiest revive rules (#50262)
  • api/types/container: deprecate ExecOptions.Detach (#50218)
    • 0c182d4d57 api/types/container: deprecate ExecOptions.Detach
  • api/image/list: Return Containers count (#50146)
    • cfcbfabb0f api/image/list: Return Containers count
  • fix errorlint linter (#50158)
  • api: bump to 1.51 (#50145)
  • api: image inspect: add back fields that did not omitempty (#50135)
    • f85394dd5d api: image inspect: add back fields that did not omitempty
  • fix go-critic linter (#50082)
  • api/swagger: quote maxUint64 example value (#50127)
    • affe1d6335 api/swagger: quote maxUint64 example value
  • all: remove // import comments (#50110)

Dependency Changes

  • github.com/docker/go-connections v0.5.0 -> v0.6.0
  • pgregory.net/rapid v1.2.0 new

Previous release can be found at v28.2.2

@dmcgowan
Add mailmap entry for Austin
4e30076 
Signed-off-by: Derek McGowan <derek@mcg.dev>
@dmcgowan
Prepare api/1.52.0-beta releases
d904f3b 
Signed-off-by: Derek McGowan <derek@mcg.dev>
@thaJeztah
Copy link
Member

thaJeztah commented Sep 5, 2025

A couple were merged, or are about to merge that probably need to be included;

@austinvazquez austinvazquez merged commit 75fd07c into moby:master Sep 5, 2025
178 checks passed
@dmcgowan dmcgowan mentioned this pull request Sep 24, 2025
Closed
@thaJeztah thaJeztah added this to the 29.0.0 milestone Oct 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@AkihiroSuda AkihiroSuda AkihiroSuda approved these changes

@austinvazquez austinvazquez austinvazquez approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

29.0.0

Development

Successfully merging this pull request may close these issues.

4 participants

@dmcgowan @thaJeztah @AkihiroSuda @austinvazquez