Skip to content

Conversation

@akerouanton
Copy link
Member

@akerouanton akerouanton commented Aug 14, 2025

- What I did

Mark legacy links environment variables (`DOCKER_KEEP_DEPRECATED_LEGACY_LINKS_ENV_VARS`) as deprecated in v28.4 and set for removal in v30.0.

@akerouanton akerouanton self-assigned this Aug 14, 2025
@akerouanton akerouanton requested review from a team and thaJeztah as code owners August 14, 2025 13:36
@codecov-commenter
Copy link

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Comment on lines 138 to 139
Starting in Docker v29.0, these environment variables are deprecated, and won't be
added auomtatically anymore. Users who still depend on them can start Docker Engine
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Starting in Docker v29.0, these environment variables are deprecated, and won't be
added auomtatically anymore. Users who still depend on them can start Docker Engine
Starting with Docker v29.0, these environment variables are deprecated and will no longer be added automatically. Users who still depend on them can start Docker Engine

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd be fine to disable it by default in v28.4, and remove the feature in v29 (or v30 depending on how much effort) - the legacy links were already deprecated since "forever", just never removed the functionality.

@thaJeztah
Copy link
Member

@thaJeztah
Copy link
Member

@akerouanton I did a quick rebase and pushed a temporary commit with some suggestions so that we can cherry-pick the deprecation to 28.4; i.e., the deprecation itself will be in v28.4 (but no changes yet) and v29.0 can disable the option by default (removing it in v30); let me know if it LGTY, then I can squash the commits.

@akerouanton akerouanton force-pushed the deprecate-legacy-links-env-vars branch from 1c6c38d to 3a31132 Compare August 19, 2025 12:44
Signed-off-by: Albin Kerouanton <[email protected]>
Co-authored-by: Sebastiaan van Stijn <[email protected]>
Signed-off-by: Sebastiaan van Stijn <[email protected]>
@akerouanton akerouanton force-pushed the deprecate-legacy-links-env-vars branch from 3a31132 to 5c76f7f Compare August 19, 2025 12:46
@akerouanton
Copy link
Member Author

LGTM — I squashed them.

Copy link
Member

@thaJeztah thaJeztah left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks!

@thaJeztah thaJeztah merged commit 2e3d021 into docker:master Aug 19, 2025
90 checks passed
@akerouanton akerouanton deleted the deprecate-legacy-links-env-vars branch August 19, 2025 13:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants