mirror of https://github.com/docker/cli.git
62 lines
1.4 KiB
Markdown
62 lines
1.4 KiB
Markdown
|
---
|
||
|
|
title: "context show"
|
||
|
|
description: "The context show command description and usage"
|
||
|
|
keywords: "context, show"
|
||
|
|
---
|
||
|
|
|
||
|
|
# context show
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
Usage: docker context show
|
||
|
|
|
||
|
|
Print the name of the current context
|
||
|
|
```
|
||
|
|
|
||
|
|
## Description
|
||
|
|
|
||
|
|
Print the name of the current context, possibly set by `DOCKER_CONTEXT` environment
|
||
|
|
variable or `--context` global option.
|
||
|
|
|
||
|
|
## Examples
|
||
|
|
|
||
|
|
### Print the current context
|
||
|
|
|
||
|
|
The following example prints the currently used [`docker context`](context.md):
|
||
|
|
|
||
|
|
```console
|
||
|
|
$ docker context show'
|
||
|
|
default
|
||
|
|
```
|
||
|
|
|
||
|
|
As an example, this output can be used to dynamically change your shell prompt
|
||
|
|
to indicate your active context. The example below illustrates how this output
|
||
|
|
could be used when using Bash as your shell.
|
||
|
|
|
||
|
|
Declare a function to obtain the current context in your `~/.bashrc`, and set
|
||
|
|
this command as your `PROMPT_COMMAND`
|
||
|
|
|
||
|
|
```console
|
||
|
|
function docker_context_prompt() {
|
||
|
|
PS1="context: $(docker context show)> "
|
||
|
|
}
|
||
|
|
|
||
|
|
PROMPT_COMMAND=docker_context_prompt
|
||
|
|
```
|
||
|
|
|
||
|
|
After reloading the `~/.bashrc`, the prompt now shows the currently selected
|
||
|
|
`docker context`:
|
||
|
|
|
||
|
|
```console
|
||
|
|
$ source ~/.bashrc
|
||
|
|
context: default> docker context create --docker host=unix:///var/run/docker.sock my-context
|
||
|
|
my-context
|
||
|
|
Successfully created context "my-context"
|
||
|
|
context: default> docker context use my-context
|
||
|
|
my-context
|
||
|
|
Current context is now "my-context"
|
||
|
|
context: my-context> docker context use default
|
||
|
|
default
|
||
|
|
Current context is now "default"
|
||
|
|
context: default>
|
||
|
|
```
|