mirror of
https://github.com/docker/docs.git
synced 2026-04-12 06:19:22 +07:00
chore: move cli data files to data subdir
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
108
data/cli/engine/docker_context_create.yaml
Normal file
108
data/cli/engine/docker_context_create.yaml
Normal file
@@ -0,0 +1,108 @@
|
||||
command: docker context create
|
||||
short: Create a context
|
||||
long: |-
|
||||
Creates a new `context`. This lets you switch the daemon your `docker` CLI
|
||||
connects to.
|
||||
usage: docker context create [OPTIONS] CONTEXT
|
||||
pname: docker context
|
||||
plink: docker_context.yaml
|
||||
options:
|
||||
- option: description
|
||||
value_type: string
|
||||
description: Description of the context
|
||||
deprecated: false
|
||||
hidden: false
|
||||
experimental: false
|
||||
experimentalcli: false
|
||||
kubernetes: false
|
||||
swarm: false
|
||||
- option: docker
|
||||
value_type: stringToString
|
||||
default_value: '[]'
|
||||
description: set the docker endpoint
|
||||
details_url: '#docker'
|
||||
deprecated: false
|
||||
hidden: false
|
||||
experimental: false
|
||||
experimentalcli: false
|
||||
kubernetes: false
|
||||
swarm: false
|
||||
- option: from
|
||||
value_type: string
|
||||
description: create context from a named context
|
||||
details_url: '#from'
|
||||
deprecated: false
|
||||
hidden: false
|
||||
experimental: false
|
||||
experimentalcli: false
|
||||
kubernetes: false
|
||||
swarm: false
|
||||
inherited_options:
|
||||
- option: help
|
||||
value_type: bool
|
||||
default_value: "false"
|
||||
description: Print usage
|
||||
deprecated: false
|
||||
hidden: true
|
||||
experimental: false
|
||||
experimentalcli: false
|
||||
kubernetes: false
|
||||
swarm: false
|
||||
examples: |-
|
||||
### Create a context with a Docker endpoint (--docker) {#docker}
|
||||
|
||||
Use the `--docker` flag to create a context with a custom endpoint. The
|
||||
following example creates a context named `my-context` with a docker endpoint
|
||||
of `/var/run/docker.sock`:
|
||||
|
||||
```console
|
||||
$ docker context create \
|
||||
--docker host=unix:///var/run/docker.sock \
|
||||
my-context
|
||||
```
|
||||
|
||||
### Create a context based on an existing context (--from) {#from}
|
||||
|
||||
Use the `--from=<context-name>` option to create a new context from
|
||||
an existing context. The example below creates a new context named `my-context`
|
||||
from the existing context `existing-context`:
|
||||
|
||||
```console
|
||||
$ docker context create --from existing-context my-context
|
||||
```
|
||||
|
||||
If the `--from` option isn't set, the `context` is created from the current context:
|
||||
|
||||
```console
|
||||
$ docker context create my-context
|
||||
```
|
||||
|
||||
This can be used to create a context out of an existing `DOCKER_HOST` based script:
|
||||
|
||||
```console
|
||||
$ source my-setup-script.sh
|
||||
$ docker context create my-context
|
||||
```
|
||||
|
||||
To source the `docker` endpoint configuration from an existing context
|
||||
use the `--docker from=<context-name>` option. The example below creates a
|
||||
new context named `my-context` using the docker endpoint configuration from
|
||||
the existing context `existing-context`:
|
||||
|
||||
```console
|
||||
$ docker context create \
|
||||
--docker from=existing-context \
|
||||
my-context
|
||||
```
|
||||
|
||||
Docker endpoints configurations, as well as the description can be modified with
|
||||
`docker context update`.
|
||||
|
||||
Refer to the [`docker context update` reference](/reference/cli/docker/context/update/) for details.
|
||||
deprecated: false
|
||||
hidden: false
|
||||
experimental: false
|
||||
experimentalcli: false
|
||||
kubernetes: false
|
||||
swarm: false
|
||||
|
||||
Reference in New Issue
Block a user