DockerCLI/docs/reference/commandline/context_show.md

56 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

# context show
<!---MARKER_GEN_START-->
Print the name of the current context
<!---MARKER_GEN_END-->
## 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>
```