Skip to content

api/t/ctr: deprecate NetworkSettingsBase, DefaultNetworkSettings#50848

Merged
vvoland merged 4 commits intomoby:masterfrom
akerouanton:deprecate-ctr-network-fields
Aug 29, 2025
Merged

api/t/ctr: deprecate NetworkSettingsBase, DefaultNetworkSettings#50848
vvoland merged 4 commits intomoby:masterfrom
akerouanton:deprecate-ctr-network-fields

Conversation

@akerouanton
Copy link
Member

- What I did

api/t/ctr: deprecate NetworkSettingsBase.Bridge

This field provides little value as it's only set when the daemon is started with --bridge flag specified, and the inspected container is connected to the default bridge network.

Unfortunately, there's no equivalent field in NetworkSettings.Networks.

api/t/ctr: deprecate NetworkSettingsBase

Most fields in NetworkSettingsBase are deprecated, so deprecate the whole struct. The few fields which aren't deprecated will move to the NetworkSettings struct in v29.

api/t/ctr: deprecate DefaultNetworkSettings

This struct is only used to report the networking state for the default bridge network when the container is connected to it.

It was deprecated in v1.09 (API v1.21), and scheduled for removal in v1.11. Unfortunately, the deprecation warning was wrongly formatted in the Go code. However, deprecation warnings are already present in swagger.yaml, so don't touch it.

- Human readable description for the release notes

- Go-SDK: Deprecate field `NetworkSettingsBase.Bridge`, struct `NetworkSettingsBase`, all the fields of `DefaultNetworkSettings`, and struct `DefaultNetworkSettings`.

This field provides little value as it's only set when the daemon is
started with --bridge flag specified, and the inspected container is
connected to the default bridge network.

Unfortunately, there's no equivalent field in NetworkSettings.Networks.

Signed-off-by: Albin Kerouanton <[email protected]>
Most fields in NetworkSettingsBase are deprecated, so deprecate the
whole struct. The few fields which aren't deprecated will move to the
NetworkSettings struct in v29.

Signed-off-by: Albin Kerouanton <[email protected]>
This struct is only used to report the networking state for the default
bridge network when the container is connected to it.

It was deprecated in v1.09 (API v1.21), and scheduled for removal in
v1.11. Unfortunately, the deprecation warning was wrongly formatted in
the Go code. However, deprecation warnings are already present in
swagger.yaml, so don't touch it.

Signed-off-by: Albin Kerouanton <[email protected]>
@akerouanton akerouanton added this to the 29.0.0 milestone Aug 29, 2025
@akerouanton akerouanton self-assigned this Aug 29, 2025
@akerouanton akerouanton added area/api API status/2-code-review area/networking Networking impact/deprecation kind/refactor PR's that refactor, or clean-up code area/go-sdk impact/go-sdk Noteworthy (compatibility changes) in the Go SDK labels Aug 29, 2025
@akerouanton akerouanton changed the title deprecate NetworkSettingsBase, DefaultNetworkSettings api/t/ctr: deprecate NetworkSettingsBase, DefaultNetworkSettings Aug 29, 2025
@vvoland vvoland merged commit 2937ee5 into moby:master Aug 29, 2025
199 checks passed
@akerouanton akerouanton deleted the deprecate-ctr-network-fields branch August 29, 2025 15:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/api API area/go-sdk area/networking Networking impact/deprecation impact/go-sdk Noteworthy (compatibility changes) in the Go SDK kind/refactor PR's that refactor, or clean-up code status/2-code-review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants