Skip to content

Commit b7d0f5c

Browse files
committed
docs: add more details to stack kubernetes deprecation
Explicitly mention flags and environment variables that were removed, to make the deprecation more discoverable. Signed-off-by: Sebastiaan van Stijn <[email protected]>
1 parent 6dcfbe6 commit b7d0f5c

1 file changed

Lines changed: 23 additions & 2 deletions

File tree

docs/deprecated.md

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -197,9 +197,30 @@ to decrypt the private key, and store it un-encrypted to continue using it.
197197
### Kubernetes stack and context support
198198

199199
**Deprecated in Release: v20.10**
200+
**Removed in Release: v21.xx**
201+
202+
Following the deprecation of [Compose on Kubernetes](https://github.com/docker/compose-on-kubernetes),
203+
support for Kubernetes in the `stack` and `context` commands has been removed from
204+
the cli, and options related to this functionality are now either ignored, or may
205+
produce an error.
206+
207+
The following command-line flags are removed from the `docker context` subcommands:
208+
209+
- `--default-stack-orchestrator` - swarm is now the only (and default) orchestrator for stacks.
210+
- `--kubernetes` - the kubernetes endpoint can no longer be stored in `docker context`.
211+
- `--kubeconfig` - exporting a context as a kubeconfig file is no longer supported.
212+
213+
The output produced by the `docker context inspect` subcommand no longer contains
214+
information about `StackOrchestrator` and `Kubernetes` endpoints for new contexts.
215+
216+
The following command-line flags are removed from the `docker stack` subcommands:
217+
218+
- `--kubeconfig` - using a kubeconfig file as context is no longer supported.
219+
- `--namespace` - configuring the kubernetes namespace for stacks is no longer supported.
220+
- `--orchestrator` - swarm is now the only (and default) orchestrator for stacks.
200221

201-
Following the deprecation of [Compose on Kubernetes](https://github.com/docker/compose-on-kubernetes), support for
202-
Kubernetes in the `stack` and `context` commands in the docker CLI is now marked as deprecated as well.
222+
The `DOCKER_STACK_ORCHESTRATOR`, `DOCKER_ORCHESTRATOR`, and `KUBECONFIG` environment
223+
variables are no longer used, and ignored.
203224

204225
### Pulling images from non-compliant image registries
205226

0 commit comments

Comments
 (0)