Skip to content

Conversation

@thaJeztah
Copy link
Member

@thaJeztah thaJeztah commented Aug 19, 2025


backports:

- Human readable description for the release notes

- Go-SDK: cli/command/builder: deprecate `NewBuilderCommand` and `NewBakeStubCommand`. These functions will be removed in the next release.
- Go-SDK: cli/command/checkpoint: deprecate `NewCheckpointCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/config: deprecate `NewConfigCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/container: deprecate `NewBuildCommand`, `NewPullCommand`, `NewPushCommand`, `NewImagesCommand`, `NewImageCommand`, `NewHistoryCommand`, `NewImportCommand`, `NewLoadCommand`, `NewRemoveCommand`, `NewSaveCommand`, `NewTagCommand`, `NewPruneCommand`. These functions will be removed in the next release.
- Go-SDK: cli/command/container: deprecate `NewRunCommand`, `NewExecCommand`, `NewPsCommand`, `NewContainerCommand`, `NewAttachCommand`, `NewCommitCommand`, `NewCopyCommand`, `NewCreateCommand`, `NewDiffCommand`, `NewExportCommand`, `NewKillCommand`, `NewLogsCommand`, `NewPauseCommand`, `NewPortCommand`, `NewRenameCommand`, `NewRestartCommand`, `NewRmCommand`, `NewStartCommand`, `NewStatsCommand`, `NewStopCommand`, `NewTopCommand`, `NewUnpauseCommand`, `NewUpdateCommand`, `NewWaitCommand`, `NewPruneCommand`. These functions will be removed in the next release.
- Go-SDK: cli/command/context: deprecate `NewContextCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/manifest: deprecate `NewManifestCommand`. This functions will be removed in the next release.
- Go-SDK: cli/command/network: deprecate `NewNetworkCommand`. These functions will be removed in the next release.
- Go-SDK: cli/command/node: deprecate `NewNodeCommand`. This functions will be removed in the next release.
- Go-SDK: cli/command/plugin: deprecate `NewPluginCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/registry: deprecate `NewLoginCommand`, `NewLogoutCommand`, `NewSearchCommand`. These functions will be removed in the next release.
- Go-SDK: cli/command/secret: deprecate `NewSecretCommand`. This functions will be removed in the next release.
- Go-SDK: cli/command/service: deprecate `NewServiceCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/stack: deprecate `NewStackCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/swarm: deprecate `NewSwarmCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/system: deprecate `NewVersionCommand`, `NewInfoCommand`, `NewSystemCommand`, `NewEventsCommand`, `NewInspectCommand`. These functions will be removed in the next release.
- Go-SDK: cli/command/trust: deprecate `NewTrustCommand`. This function will be removed in the next release.
- Go-SDK: cli/command/volume: deprecate `NewVolumeCommand`, `NewPruneCommand`. These functions will be removed in the next release.

- A picture of a cute animal (not mandatory but encouraged)

@thaJeztah thaJeztah added this to the 28.4.0 milestone Aug 19, 2025
@thaJeztah thaJeztah added impact/changelog status/2-code-review kind/refactor PR's that refactor, or clean-up code area/go-sdk Changes affecting the Go SDK impact/go-sdk Noteworthy (compatibility changes) in the Go SDK labels Aug 19, 2025
@codecov-commenter
Copy link

codecov-commenter commented Aug 19, 2025

This patch unexports the `builder` and `bake` stub command and it adds
deprecation notices on the exported functions.

It also registers the commands using the new `cli/internal/commands`
package when the init function executes.

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 1b9d076)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch unexports the `checkpoint` command.

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 3265cea)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch unexports the `config` command.

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit cce29da)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported container commands and moves the
implementation details to an unexported function.

Commands that are affected include:
- container.NewRunCommand
- container.NewExecCommand
- container.NewPsCommand
- container.NewContainerCommand
- container.NewAttachCommand
- container.NewCommitCommand
- container.NewCopyCommand
- container.NewCreateCommand
- container.NewDiffCommand
- container.NewExportCommand
- container.NewKillCommand
- container.NewLogsCommand
- container.NewPauseCommand
- container.NewPortCommand
- container.NewRenameCommand
- container.NewRestartCommand
- container.NewRmCommand
- container.NewStartCommand
- container.NewStatsCommand
- container.NewStopCommand
- container.NewTopCommand
- container.NewUnpauseCommand
- container.NewUpdateCommand
- container.NewWaitCommand
- container.NewPruneCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 38595fe)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported image commands and moves the
implementation details to an unexported function.

Commands that are affected include:

- image.NewBuildCommand
- image.NewPullCommand
- image.NewPushCommand
- image.NewImagesCommand
- image.NewImageCommand
- image.NewHistoryCommand
- image.NewImportCommand
- image.NewLoadCommand
- image.NewRemoveCommand
- image.NewSaveCommand
- image.NewTagCommand
- image.NewPruneCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit e66a145)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported system commands and moves the
implementation details to an unexported function.

Commands that are affected include:

- system.NewVersionCommand
- system.NewInfoCommand
- system.NewSystemCommand
- system.NewEventsCommand
- system.NewInspectCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit cfb8cb9)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
@thaJeztah thaJeztah force-pushed the 28.x_backport_deprecate_cobra_commands branch from b3a9764 to def5bfc Compare August 20, 2025 10:37
@thaJeztah thaJeztah marked this pull request as ready for review August 20, 2025 10:37
This patch deprecates exported network commands and moves the
implementation details to an unexported function.

Commands that are affected include:

- network.NewNetworkCommand
- network.NewPruneCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 78a8856)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported node commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- node.NewNodeCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit ab3fcf9)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported manifest commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- manifest.NewManifestCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 02fda07)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported secret commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- secrets.NewSecretCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit e00762e)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported service commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- service.NewServiceCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 88178ed)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported volume commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- volume.NewVolumeCommand
- volume.NewPruneCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 9961e39)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported context commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- context.NewContextCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 3b0edc7)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported stack commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- stack.NewStackCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit 630fe43)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
@thaJeztah thaJeztah requested review from a team and silvin-lubecki as code owners August 20, 2025 11:41
This patch deprecates exported registry commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- registry.NewLoginCommand
- registry.NewLogoutCommand
- registry.NewSearchCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit d4588c7)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported swarm commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- swarm.NewSwarmCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit bf39340)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported plugin commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- plugin.NewPluginCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit c6b7268)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
This patch deprecates exported trust commands and moves the implementation
details to an unexported function.

Commands that are affected include:

- trust.NewTrustCommand

Signed-off-by: Alano Terblanche <[email protected]>
(cherry picked from commit bd8e3e4)
Signed-off-by: Sebastiaan van Stijn <[email protected]>
@thaJeztah thaJeztah merged commit 85512e3 into docker:28.x Aug 20, 2025
103 of 104 checks passed
@thaJeztah thaJeztah deleted the 28.x_backport_deprecate_cobra_commands branch August 20, 2025 13:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/go-sdk Changes affecting the Go SDK impact/changelog 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.

4 participants