Skip to content

Conversation

@taole33
Copy link

@taole33 taole33 commented Dec 7, 2025

Motivation

Fixes #11232

In #11216, a default fallback to VERSION_1_44 was introduced in DockerClientProviderStrategy. However, this change broke compatibility for users running older Docker versions (e.g., Docker v24 supports up to API 1.43) because the client forces a newer API version than the server supports.

Since docker-java supports auto-negotiation when the version is null (UNKNOWN), strictly pinning it to 1.44 is unnecessary and causes regressions for legacy environments.

Changes

Removed the block that forces VERSION_1_44 when the API version is unknown.

This restores the behavior of relying on docker-java's auto-negotiation (or safe defaults).

Verification

I have verified this fix locally on the following environments:

Docker v29.1.2 (API 1.52, Min 1.44): Passed. (Auto-negotiated correctly)

Docker v24.0 (dind, API 1.43): Passed. (Auto-negotiated correctly)

@taole33 taole33 requested a review from a team as a code owner December 7, 2025 13:01
@jakub-pietrzak
Copy link

Would be great to also port this to 1.x afterwards.

@taole33
Copy link
Author

taole33 commented Dec 7, 2025

Would be great to also port this to 1.x afterwards.

I'd be happy to open a backport PR for the 1.x series after this is merged.
However, I couldn't find a specific branch for 1.x (e.g. release/1.x). Could you let me know which branch I should target?

@jakub-pietrzak
Copy link

I'm not a maintainer, looks like there will be no more 1.x releases.
spring-projects/spring-boot#48104 (comment)

@taole33
Copy link
Author

taole33 commented Dec 10, 2025

The PR failed in CI. I ran the full CI-test suite in my repository excluding DockerMcpGatewayContainerTest and it passed, so the cause is definitely DockerMcpGatewayContainerTest. I am investigating why it failed.

@eddumelendez
Copy link
Member

Thanks for your contribution. We have decided to add a fallback version, the one that was used before v1.32. See #11346

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Breaking change in 2.0.2 -> Docker 24.x

3 participants