Skip to content

Conversation

@thaJeztah
Copy link
Member

cli/command/context: deprecate exported types and functions

These functions and types are shallow wrappers around the context store and were intended for internal use as implementation for the CLI itself.

They were exported in 3126920 to be used by plugins and Docker Desktop. However, there's currently no public uses of this, and Docker Desktop does not use these functions.

This patch deprecates the exported functions as they were meant to be implementation specific for the CLI. If there's a need to provide utilities for manipulating the context-store other than through the CLI itself, we can consider creating an SDK for that purpose.

This deprecates:

  • RunCreate and CreateOptions
  • RunExport and ExportOptions
  • RunImport
  • RunRemove and RemoveOptions
  • RunUpdate and UpdateOptions
  • RunUse

- What I did

- How I did it

- How to verify it

- Human readable description for the release notes

Go SDK: cli/command/context: deprecate `RunCreate` and `CreateOptions`
Go SDK: cli/command/context: deprecate `RunExport` and `ExportOptions`
Go SDK: cli/command/context: deprecate `RunImport`
Go SDK: cli/command/context: deprecate `RunRemove` and `RemoveOptions`
Go SDK: cli/command/context: deprecate `RunUpdate` and `UpdateOptions`
Go SDK: cli/command/context: deprecate `RunUse`

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

@thaJeztah thaJeztah added this to the 29.0.0 milestone Aug 29, 2025
@thaJeztah thaJeztah added impact/changelog impact/deprecation status/2-code-review area/context 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 process/cherry-pick/28.x labels Aug 29, 2025
@codecov-commenter
Copy link

codecov-commenter commented Aug 29, 2025

These functions and types are shallow wrappers around the context
store and were intended for internal use as implementation for the
CLI itself.

They were exported in 3126920 to be
used by plugins and Docker Desktop. However, there's currently no public
uses of this, and Docker Desktop does not use these functions.

This patch deprecates the exported functions as they were meant to be
implementation specific for the CLI. If there's a need to provide
utilities for manipulating the context-store other than through the
CLI itself, we can consider creating an SDK for that purpose.

This deprecates:

- `RunCreate` and `CreateOptions`
- `RunExport` and `ExportOptions`
- `RunImport`
- `RunRemove` and `RemoveOptions`
- `RunUpdate` and `UpdateOptions`
- `RunUse`

Signed-off-by: Sebastiaan van Stijn <[email protected]>
@thaJeztah thaJeztah merged commit 321100e into docker:master Sep 1, 2025
96 checks passed
@thaJeztah thaJeztah deleted the deprecate_context_funcs branch September 1, 2025 07:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/context area/go-sdk Changes affecting the Go SDK impact/changelog impact/deprecation impact/go-sdk Noteworthy (compatibility changes) in the Go SDK kind/refactor PR's that refactor, or clean-up code process/cherry-picked status/2-code-review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants