Guest24897
/
DockerCLI
mirror of https://github.com/docker/cli.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Sync docker/docker refs with files mistakenly edited in docker.github.io repo 

Signed-off-by: Misty Stanley-Jones <misty@docker.com>
This commit is contained in:
Misty Stanley-Jones 2016-10-19 10:25:45 -07:00 committed by Tibor Vass
parent 9012efce15
commit 7f36c3a1a0
105 changed files with 1074 additions and 112 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/README.md
View File

@ -1,5 +1,14 @@
# The non-reference docs have been moved! # The non-reference docs have been moved!
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
The documentation for Docker Engine has been merged into The documentation for Docker Engine has been merged into
[the general documentation repo](https://github.com/docker/docker.github.io). [the general documentation repo](https://github.com/docker/docker.github.io).

9
docs/deprecated.md
View File

@ -5,6 +5,15 @@ description: "Deprecated Features."
keywords: ["docker, documentation, about, technology, deprecate"] keywords: ["docker, documentation, about, technology, deprecate"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Deprecated Engine Features # Deprecated Engine Features
The following list of features are deprecated in Engine. The following list of features are deprecated in Engine.

9
docs/extend/index.md
View File

@ -8,6 +8,15 @@ keywords: ["API, Usage, plugins, documentation, developer"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Docker Engine managed plugin system # Docker Engine managed plugin system
This document describes the plugin system available today in the **experimental This document describes the plugin system available today in the **experimental

9
docs/extend/legacy_plugins.md
View File

@ -5,6 +5,15 @@ description: "How to add additional functionality to Docker with plugins extensi
keywords: ["Examples, Usage, plugins, docker, documentation, user guide"] keywords: ["Examples, Usage, plugins, docker, documentation, user guide"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Use Docker Engine plugins # Use Docker Engine plugins
This document describes the Docker Engine plugins generally available in Docker This document describes the Docker Engine plugins generally available in Docker

9
docs/extend/manifest.md
View File

@ -8,6 +8,15 @@ keywords: ["API, Usage, plugins, documentation, developer"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Plugin Manifest Version 0 of Plugin V2 # Plugin Manifest Version 0 of Plugin V2
This document outlines the format of the V0 plugin manifest. The plugin This document outlines the format of the V0 plugin manifest. The plugin

8
docs/extend/menu.md
View File

@ -6,5 +6,13 @@ type: "menu"
identifier: "engine_extend" identifier: "engine_extend"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
<!--menu page not rendered--> <!--menu page not rendered-->

9
docs/extend/plugin_api.md
View File

@ -4,6 +4,15 @@ description: "How to write Docker plugins extensions "
keywords: ["API, Usage, plugins, documentation, developer"] keywords: ["API, Usage, plugins, documentation, developer"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Docker Plugin API # Docker Plugin API
Docker plugins are out-of-process extensions which add capabilities to the Docker plugins are out-of-process extensions which add capabilities to the

8
docs/extend/plugins_authorization.md
View File

@ -5,6 +5,14 @@ keywords: ["security, authorization, authentication, docker, documentation, plug
aliases: ["/engine/extend/authorization/"] aliases: ["/engine/extend/authorization/"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Create an authorization plugin # Create an authorization plugin

9
docs/extend/plugins_network.md
View File

@ -4,6 +4,15 @@ description: "Network driver plugins."
keywords: ["Examples, Usage, plugins, docker, documentation, user guide"] keywords: ["Examples, Usage, plugins, docker, documentation, user guide"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Engine network driver plugins # Engine network driver plugins
This document describes Docker Engine network driver plugins generally This document describes Docker Engine network driver plugins generally

9
docs/extend/plugins_volume.md
View File

@ -4,6 +4,15 @@ description: "How to manage data with external volume plugins"
keywords: ["Examples, Usage, volume, docker, data, volumes, plugin, api"] keywords: ["Examples, Usage, volume, docker, data, volumes, plugin, api"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Write a volume plugin # Write a volume plugin
Docker Engine volume plugins enable Engine deployments to be integrated with Docker Engine volume plugins enable Engine deployments to be integrated with

24
docs/reference/builder.md
View File

@ -4,6 +4,15 @@ description: "Dockerfiles use a simple DSL which allows you to automate the step
keywords: ["builder, docker, Dockerfile, automation, image creation"] keywords: ["builder, docker, Dockerfile, automation, image creation"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Dockerfile reference # Dockerfile reference
Docker can build images automatically by reading the instructions from a Docker can build images automatically by reading the instructions from a
@ -129,7 +138,7 @@ instruction must be \`FROM\`** in order to specify the [*Base
Image*](glossary.md#base-image) from which you are building. Image*](glossary.md#base-image) from which you are building.
Docker treats lines that *begin* with `#` as a comment, unless the line is Docker treats lines that *begin* with `#` as a comment, unless the line is
a valid [parser directive](builder.md#parser-directives). A `#` marker anywhere a valid [parser directive](#parser-directives). A `#` marker anywhere
else in a line is treated as an argument. This allows statements like: else in a line is treated as an argument. This allows statements like:
```Dockerfile ```Dockerfile
@ -1265,9 +1274,9 @@ The output of the final `pwd` command in this `Dockerfile` would be
ARG <name>[=<default value>] ARG <name>[=<default value>]
The `ARG` instruction defines a variable that users can pass at build-time to The `ARG` instruction defines a variable that users can pass at build-time to
the builder with the `docker build` command using the `--build-arg the builder with the `docker build` command using the
<varname>=<value>` flag. If a user specifies a build argument that was not `--build-arg <varname>=<value>` flag. If a user specifies a build argument
defined in the Dockerfile, the build outputs an error. that was not defined in the Dockerfile, the build outputs an error.
``` ```
One or more build-args were not consumed, failing build. One or more build-args were not consumed, failing build.
@ -1380,8 +1389,11 @@ corresponding `ARG` instruction in the Dockerfile.
* `NO_PROXY` * `NO_PROXY`
* `no_proxy` * `no_proxy`
To use these, simply pass them on the command line using the `--build-arg To use these, simply pass them on the command line using the flag:
<varname>=<value>` flag.
```
--build-arg <varname>=<value>
```
### Impact on build caching ### Impact on build caching

23
docs/reference/commandline/attach.md
View File

@ -4,6 +4,15 @@ description: "The attach command description and usage"
keywords: ["attach, running, container"] keywords: ["attach, running, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# attach # attach
```markdown ```markdown
@ -38,13 +47,13 @@ the container. You can detach from a container and leave it running using the
It is forbidden to redirect the standard input of a `docker attach` command It is forbidden to redirect the standard input of a `docker attach` command
while attaching to a tty-enabled container (i.e.: launched with `-t`). while attaching to a tty-enabled container (i.e.: launched with `-t`).
While a client is connected to container's stdio using `docker attach`, Docker While a client is connected to container's stdio using `docker attach`, Docker
uses a ~1MB memory buffer to maximize the throughput of the application. If uses a ~1MB memory buffer to maximize the throughput of the application. If
this buffer is filled, the speed of the API connection will start to have an this buffer is filled, the speed of the API connection will start to have an
effect on the process output writing speed. This is similar to other effect on the process output writing speed. This is similar to other
applications like SSH. Because of this, it is not recommended to run applications like SSH. Because of this, it is not recommended to run
performance critical applications that generate a lot of output in the performance critical applications that generate a lot of output in the
foreground over a slow client connection. Instead, users should use the foreground over a slow client connection. Instead, users should use the
`docker logs` command to get access to the logs. `docker logs` command to get access to the logs.

13
docs/reference/commandline/build.md
View File

@ -4,6 +4,15 @@ description: "The build command description and usage"
keywords: ["build, docker, image"] keywords: ["build, docker, image"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# build # build
```markdown ```markdown
@ -397,9 +406,9 @@ For detailed information on using `ARG` and `ENV` instructions, see the
### Optional security options (--security-opt) ### Optional security options (--security-opt)
This flag is only supported on a daemon running on Windows, and only supports This flag is only supported on a daemon running on Windows, and only supports
the `credentialspec` option. The `credentialspec` must be in the format the `credentialspec` option. The `credentialspec` must be in the format
`file://spec.txt` or `registry://keyname`. `file://spec.txt` or `registry://keyname`.
### Specify isolation technology for container (--isolation) ### Specify isolation technology for container (--isolation)

11
docs/reference/commandline/cli.md
View File

@ -4,6 +4,15 @@ description: "Docker's CLI command description and usage"
keywords: ["Docker, Docker documentation, CLI, command line"] keywords: ["Docker, Docker documentation, CLI, command line"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# Use the Docker command line # Use the Docker command line
To list available commands, either run `docker` with no parameters To list available commands, either run `docker` with no parameters
@ -147,6 +156,7 @@ list of supported formatting directives, see the
Following is a sample `config.json` file: Following is a sample `config.json` file:
{% raw %}
{ {
"HttpHeaders": { "HttpHeaders": {
"MyHeader": "MyValue" "MyHeader": "MyValue"
@ -156,6 +166,7 @@ Following is a sample `config.json` file:
"serviceInspectFormat": "pretty", "serviceInspectFormat": "pretty",
"detachKeys": "ctrl-e,e" "detachKeys": "ctrl-e,e"
} }
{% endraw %}
### Notary ### Notary

15
docs/reference/commandline/commit.md
View File

@ -4,6 +4,15 @@ description: "The commit command description and usage"
keywords: ["commit, file, changes"] keywords: ["commit, file, changes"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# commit # commit
```markdown ```markdown
@ -51,6 +60,7 @@ created. Supported `Dockerfile` instructions:
## Commit a container with new configurations ## Commit a container with new configurations
{% raw %}
$ docker ps $ docker ps
ID IMAGE COMMAND CREATED STATUS PORTS ID IMAGE COMMAND CREATED STATUS PORTS
c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours c3f279d17e0a ubuntu:12.04 /bin/bash 7 days ago Up 25 hours
@ -61,8 +71,9 @@ created. Supported `Dockerfile` instructions:
f5283438590d f5283438590d
$ docker inspect -f "{{ .Config.Env }}" f5283438590d $ docker inspect -f "{{ .Config.Env }}" f5283438590d
[HOME=/ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin DEBUG=true] [HOME=/ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin DEBUG=true]
{% endraw %}
## Commit a container with new `CMD` and `EXPOSE` instructions ## Commit a container with new `CMD` and `EXPOSE` instructions
$ docker ps $ docker ps
ID IMAGE COMMAND CREATED STATUS PORTS ID IMAGE COMMAND CREATED STATUS PORTS
@ -71,7 +82,7 @@ created. Supported `Dockerfile` instructions:
$ docker commit --change='CMD ["apachectl", "-DFOREGROUND"]' -c "EXPOSE 80" c3f279d17e0a svendowideit/testimage:version4 $ docker commit --change='CMD ["apachectl", "-DFOREGROUND"]' -c "EXPOSE 80" c3f279d17e0a svendowideit/testimage:version4
f5283438590d f5283438590d
$ docker run -d svendowideit/testimage:version4 $ docker run -d svendowideit/testimage:version4
89373736e2e7f00bc149bd783073ac43d0507da250e999f3f1036e0db60817c0 89373736e2e7f00bc149bd783073ac43d0507da250e999f3f1036e0db60817c0

9
docs/reference/commandline/container_prune.md
View File

@ -4,6 +4,15 @@ description: "Remove all stopped containers"
keywords: [container, prune, delete, remove] keywords: [container, prune, delete, remove]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# container prune # container prune
```markdown ```markdown

13
docs/reference/commandline/cp.md
View File

@ -4,6 +4,15 @@ description: "The cp command description and usage"
keywords: ["copy, container, files, folders"] keywords: ["copy, container, files, folders"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# cp # cp
```markdown ```markdown
@ -29,7 +38,7 @@ either the `SRC_PATH` or `DEST_PATH`, you can also stream a tar archive from
`STDIN` or to `STDOUT`. The `CONTAINER` can be a running or stopped container. `STDIN` or to `STDOUT`. The `CONTAINER` can be a running or stopped container.
The `SRC_PATH` or `DEST_PATH` can be a file or directory. The `SRC_PATH` or `DEST_PATH` can be a file or directory.
The `docker cp` command assumes container paths are relative to the container's The `docker cp` command assumes container paths are relative to the container's
`/` (root) directory. This means supplying the initial forward slash is optional; `/` (root) directory. This means supplying the initial forward slash is optional;
The command sees `compassionate_darwin:/tmp/foo/myfile.txt` and The command sees `compassionate_darwin:/tmp/foo/myfile.txt` and
`compassionate_darwin:tmp/foo/myfile.txt` as identical. Local machine paths can `compassionate_darwin:tmp/foo/myfile.txt` as identical. Local machine paths can
@ -74,7 +83,7 @@ argument of `DEST_PATH`, the behavior is as follows:
The command requires `SRC_PATH` and `DEST_PATH` to exist according to the above The command requires `SRC_PATH` and `DEST_PATH` to exist according to the above
rules. If `SRC_PATH` is local and is a symbolic link, the symbolic link, not rules. If `SRC_PATH` is local and is a symbolic link, the symbolic link, not
the target, is copied by default. To copy the link target and not the link, specify the target, is copied by default. To copy the link target and not the link, specify
the `-L` option. the `-L` option.
A colon (`:`) is used as a delimiter between `CONTAINER` and its path. You can A colon (`:`) is used as a delimiter between `CONTAINER` and its path. You can

11
docs/reference/commandline/create.md
View File

@ -4,6 +4,15 @@ description: "The create command description and usage"
keywords: ["docker, create, container"] keywords: ["docker, create, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# create # create
Creates a new container. Creates a new container.
@ -167,7 +176,7 @@ Set storage driver options per container.
$ docker create -it --storage-opt size=120G fedora /bin/bash $ docker create -it --storage-opt size=120G fedora /bin/bash
This (size) will allow to set the container rootfs size to 120G at creation time. This (size) will allow to set the container rootfs size to 120G at creation time.
This option is only available for the `devicemapper`, `btrfs`, `overlay2`, This option is only available for the `devicemapper`, `btrfs`, `overlay2`,
`windowsfilter` and `zfs` graph drivers. `windowsfilter` and `zfs` graph drivers.
For the `devicemapper`, `btrfs`, `windowsfilter` and `zfs` graph drivers, For the `devicemapper`, `btrfs`, `windowsfilter` and `zfs` graph drivers,

9
docs/reference/commandline/deploy.md
View File

@ -5,6 +5,15 @@ keywords: ["stack, deploy"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stack deploy (experimental) # stack deploy (experimental)
```markdown ```markdown

9
docs/reference/commandline/diff.md
View File

@ -4,6 +4,15 @@ description: "The diff command description and usage"
keywords: ["list, changed, files, container"] keywords: ["list, changed, files, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# diff # diff
```markdown ```markdown

83
docs/reference/commandline/dockerd.md
View File

@ -5,6 +5,15 @@ description: "The daemon command description and usage"
keywords: ["container, daemon, runtime"] keywords: ["container, daemon, runtime"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# daemon # daemon
```markdown ```markdown
@ -279,7 +288,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
#### Devicemapper options #### Devicemapper options
* `dm.thinpooldev` * `dm.thinpooldev`
Specifies a custom block storage device to use for the thin pool. Specifies a custom block storage device to use for the thin pool.
@ -306,7 +315,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.thinpooldev=/dev/mapper/thin-pool $ sudo dockerd --storage-opt dm.thinpooldev=/dev/mapper/thin-pool
``` ```
* `dm.basesize` * `dm.basesize`
Specifies the size to use when creating the base device, which limits the Specifies the size to use when creating the base device, which limits the
size of images and containers. The default value is 10G. Note, thin devices size of images and containers. The default value is 10G. Note, thin devices
@ -324,7 +333,6 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.basesize=50G $ sudo dockerd --storage-opt dm.basesize=50G
``` ```
This will increase the base device size to 50G. The Docker daemon will throw an This will increase the base device size to 50G. The Docker daemon will throw an
error if existing base device size is larger than 50G. A user can use error if existing base device size is larger than 50G. A user can use
this option to expand the base device size however shrinking is not permitted. this option to expand the base device size however shrinking is not permitted.
@ -345,7 +353,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.basesize=20G $ sudo dockerd --storage-opt dm.basesize=20G
``` ```
* `dm.loopdatasize` * `dm.loopdatasize`
> **Note**: > **Note**:
> This option configures devicemapper loopback, which should not > This option configures devicemapper loopback, which should not
@ -362,7 +370,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.loopdatasize=200G $ sudo dockerd --storage-opt dm.loopdatasize=200G
``` ```
* `dm.loopmetadatasize` * `dm.loopmetadatasize`
> **Note**: > **Note**:
> This option configures devicemapper loopback, which should not > This option configures devicemapper loopback, which should not
@ -379,7 +387,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.loopmetadatasize=4G $ sudo dockerd --storage-opt dm.loopmetadatasize=4G
``` ```
* `dm.fs` * `dm.fs`
Specifies the filesystem type to use for the base device. The supported Specifies the filesystem type to use for the base device. The supported
options are "ext4" and "xfs". The default is "xfs" options are "ext4" and "xfs". The default is "xfs"
@ -390,7 +398,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.fs=ext4 $ sudo dockerd --storage-opt dm.fs=ext4
``` ```
* `dm.mkfsarg` * `dm.mkfsarg`
Specifies extra mkfs arguments to be used when creating the base device. Specifies extra mkfs arguments to be used when creating the base device.
@ -400,7 +408,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt "dm.mkfsarg=-O ^has_journal" $ sudo dockerd --storage-opt "dm.mkfsarg=-O ^has_journal"
``` ```
* `dm.mountopt` * `dm.mountopt`
Specifies extra mount options used when mounting the thin devices. Specifies extra mount options used when mounting the thin devices.
@ -410,7 +418,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.mountopt=nodiscard $ sudo dockerd --storage-opt dm.mountopt=nodiscard
``` ```
* `dm.datadev` * `dm.datadev`
(Deprecated, use `dm.thinpooldev`) (Deprecated, use `dm.thinpooldev`)
@ -428,7 +436,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
--storage-opt dm.metadatadev=/dev/sdc1 --storage-opt dm.metadatadev=/dev/sdc1
``` ```
* `dm.metadatadev` * `dm.metadatadev`
(Deprecated, use `dm.thinpooldev`) (Deprecated, use `dm.thinpooldev`)
@ -452,7 +460,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
--storage-opt dm.metadatadev=/dev/sdc1 --storage-opt dm.metadatadev=/dev/sdc1
``` ```
* `dm.blocksize` * `dm.blocksize`
Specifies a custom blocksize to use for the thin pool. The default Specifies a custom blocksize to use for the thin pool. The default
blocksize is 64K. blocksize is 64K.
@ -463,7 +471,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.blocksize=512K $ sudo dockerd --storage-opt dm.blocksize=512K
``` ```
* `dm.blkdiscard` * `dm.blkdiscard`
Enables or disables the use of blkdiscard when removing devicemapper Enables or disables the use of blkdiscard when removing devicemapper
devices. This is enabled by default (only) if using loopback devices and is devices. This is enabled by default (only) if using loopback devices and is
@ -479,7 +487,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.blkdiscard=false $ sudo dockerd --storage-opt dm.blkdiscard=false
``` ```
* `dm.override_udev_sync_check` * `dm.override_udev_sync_check`
Overrides the `udev` synchronization checks between `devicemapper` and `udev`. Overrides the `udev` synchronization checks between `devicemapper` and `udev`.
`udev` is the device manager for the Linux kernel. `udev` is the device manager for the Linux kernel.
@ -519,7 +527,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
> Otherwise, set this flag for migrating existing Docker daemons to > Otherwise, set this flag for migrating existing Docker daemons to
> a daemon with a supported environment. > a daemon with a supported environment.
* `dm.use_deferred_removal` * `dm.use_deferred_removal`
Enables use of deferred device removal if `libdm` and the kernel driver Enables use of deferred device removal if `libdm` and the kernel driver
support the mechanism. support the mechanism.
@ -541,7 +549,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
$ sudo dockerd --storage-opt dm.use_deferred_removal=true $ sudo dockerd --storage-opt dm.use_deferred_removal=true
``` ```
* `dm.use_deferred_deletion` * `dm.use_deferred_deletion`
Enables use of deferred device deletion for thin pool devices. By default, Enables use of deferred device deletion for thin pool devices. By default,
thin pool device deletion is synchronous. Before a container is deleted, thin pool device deletion is synchronous. Before a container is deleted,
@ -567,7 +575,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
when unintentional leaking of mount point happens across multiple mount when unintentional leaking of mount point happens across multiple mount
namespaces. namespaces.
* `dm.min_free_space` * `dm.min_free_space`
Specifies the min free space percent in a thin pool require for new device Specifies the min free space percent in a thin pool require for new device
creation to succeed. This check applies to both free data space as well creation to succeed. This check applies to both free data space as well
@ -615,7 +623,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
#### ZFS options #### ZFS options
* `zfs.fsname` * `zfs.fsname`
Set zfs filesystem under which docker will create its own datasets. Set zfs filesystem under which docker will create its own datasets.
By default docker will pick up the zfs filesystem where docker graph By default docker will pick up the zfs filesystem where docker graph
@ -629,9 +637,9 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
#### Btrfs options #### Btrfs options
* `btrfs.min_space` * `btrfs.min_space`
Specifies the mininum size to use when creating the subvolume which is used Specifies the minimum size to use when creating the subvolume which is used
for containers. If user uses disk quota for btrfs when creating or running for containers. If user uses disk quota for btrfs when creating or running
a container with **--storage-opt size** option, docker should ensure the a container with **--storage-opt size** option, docker should ensure the
**size** cannot be smaller than **btrfs.min_space**. **size** cannot be smaller than **btrfs.min_space**.
@ -644,7 +652,7 @@ options for `zfs` start with `zfs` and options for `btrfs` start with `btrfs`.
#### Overlay2 options #### Overlay2 options
* `overlay2.override_kernel_check` * `overlay2.override_kernel_check`
Overrides the Linux kernel version check allowing overlay2. Support for Overrides the Linux kernel version check allowing overlay2. Support for
specifying multiple lower directories needed by overlay2 was added to the specifying multiple lower directories needed by overlay2 was added to the
@ -672,19 +680,20 @@ Runtimes can be registered with the daemon either via the
configuration file or using the `--add-runtime` command line argument. configuration file or using the `--add-runtime` command line argument.
The following is an example adding 2 runtimes via the configuration: The following is an example adding 2 runtimes via the configuration:
```json ```json
"default-runtime": "runc", "default-runtime": "runc",
"runtimes": { "runtimes": {
"runc": { "runc": {
"path": "runc" "path": "runc"
}, },
"custom": { "custom": {
"path": "/usr/local/bin/my-runc-replacement", "path": "/usr/local/bin/my-runc-replacement",
"runtimeArgs": [ "runtimeArgs": [
"--debug" "--debug"
] ]
}
} }
}
``` ```
This is the same example via the command line: This is the same example via the command line:
@ -844,35 +853,35 @@ $ sudo dockerd \
The currently supported cluster store options are: The currently supported cluster store options are:
* `discovery.heartbeat` * `discovery.heartbeat`
Specifies the heartbeat timer in seconds which is used by the daemon as a Specifies the heartbeat timer in seconds which is used by the daemon as a
keepalive mechanism to make sure discovery module treats the node as alive keepalive mechanism to make sure discovery module treats the node as alive
in the cluster. If not configured, the default value is 20 seconds. in the cluster. If not configured, the default value is 20 seconds.
* `discovery.ttl` * `discovery.ttl`
Specifies the ttl (time-to-live) in seconds which is used by the discovery Specifies the ttl (time-to-live) in seconds which is used by the discovery
module to timeout a node if a valid heartbeat is not received within the module to timeout a node if a valid heartbeat is not received within the
configured ttl value. If not configured, the default value is 60 seconds. configured ttl value. If not configured, the default value is 60 seconds.
* `kv.cacertfile` * `kv.cacertfile`
Specifies the path to a local file with PEM encoded CA certificates to trust Specifies the path to a local file with PEM encoded CA certificates to trust
* `kv.certfile` * `kv.certfile`
Specifies the path to a local file with a PEM encoded certificate. This Specifies the path to a local file with a PEM encoded certificate. This
certificate is used as the client cert for communication with the certificate is used as the client cert for communication with the
Key/Value store. Key/Value store.
* `kv.keyfile` * `kv.keyfile`
Specifies the path to a local file with a PEM encoded private key. This Specifies the path to a local file with a PEM encoded private key. This
private key is used as the client key for communication with the private key is used as the client key for communication with the
Key/Value store. Key/Value store.
* `kv.path` * `kv.path`
Specifies the path in the Key/Value store. If not configured, the default value is 'docker/nodes'. Specifies the path in the Key/Value store. If not configured, the default value is 'docker/nodes'.

9
docs/reference/commandline/events.md
View File

@ -4,6 +4,15 @@ description: "The events command description and usage"
keywords: ["events, container, report"] keywords: ["events, container, report"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# events # events
```markdown ```markdown

9
docs/reference/commandline/exec.md
View File

@ -4,6 +4,15 @@ description: "The exec command description and usage"
keywords: ["command, container, run, execute"] keywords: ["command, container, run, execute"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# exec # exec
```markdown ```markdown

9
docs/reference/commandline/export.md
View File

@ -4,6 +4,15 @@ description: "The export command description and usage"
keywords: ["export, file, system, container"] keywords: ["export, file, system, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# export # export
```markdown ```markdown

9
docs/reference/commandline/history.md
View File

@ -4,6 +4,15 @@ description: "The history command description and usage"
keywords: ["docker, image, history"] keywords: ["docker, image, history"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# history # history
```markdown ```markdown

9
docs/reference/commandline/image_prune.md
View File

@ -4,6 +4,15 @@ description: "Remove all stopped images"
keywords: [image, prune, delete, remove] keywords: [image, prune, delete, remove]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# image prune # image prune
```markdown ```markdown

13
docs/reference/commandline/images.md
View File

@ -4,6 +4,15 @@ description: "The images command description and usage"
keywords: ["list, docker, images"] keywords: ["list, docker, images"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# images # images
```markdown ```markdown
@ -245,6 +254,7 @@ output the data exactly as the template declares or, when using the
The following example uses a template without headers and outputs the The following example uses a template without headers and outputs the
`ID` and `Repository` entries separated by a colon for all images: `ID` and `Repository` entries separated by a colon for all images:
{% raw %}
$ docker images --format "{{.ID}}: {{.Repository}}" $ docker images --format "{{.ID}}: {{.Repository}}"
77af4d6b9913: <none> 77af4d6b9913: <none>
b6fa739cedf5: committ b6fa739cedf5: committ
@ -255,10 +265,12 @@ The following example uses a template without headers and outputs the
746b819f315e: postgres 746b819f315e: postgres
746b819f315e: postgres 746b819f315e: postgres
746b819f315e: postgres 746b819f315e: postgres
{% endraw %}
To list all images with their repository and tag in a table format you To list all images with their repository and tag in a table format you
can use: can use:
{% raw %}
$ docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}" $ docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
IMAGE ID REPOSITORY TAG IMAGE ID REPOSITORY TAG
77af4d6b9913 <none> <none> 77af4d6b9913 <none> <none>
@ -270,3 +282,4 @@ can use:
746b819f315e postgres 9.3 746b819f315e postgres 9.3
746b819f315e postgres 9.3.5 746b819f315e postgres 9.3.5
746b819f315e postgres latest 746b819f315e postgres latest
{% endraw %}

9
docs/reference/commandline/import.md
View File

@ -4,6 +4,15 @@ description: "The import command description and usage"
keywords: ["import, file, system, container"] keywords: ["import, file, system, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# import # import
```markdown ```markdown

9
docs/reference/commandline/index.md
View File

@ -5,7 +5,14 @@ keywords: ["Docker, Docker documentation, CLI, command line"]
identifier: "smn_cli_guide" identifier: "smn_cli_guide"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# The Docker commands # The Docker commands

13
docs/reference/commandline/info.md
View File

@ -4,6 +4,15 @@ description: "The info command description and usage"
keywords: ["display, docker, information"] keywords: ["display, docker, information"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# info # info
```markdown ```markdown
@ -55,7 +64,7 @@ storage driver and a node that is part of a 2-node swarm:
Plugins: Plugins:
Volume: local Volume: local
Network: bridge null host overlay Network: bridge null host overlay
Swarm: Swarm:
NodeID: 0gac67oclbxq7 NodeID: 0gac67oclbxq7
Is Manager: true Is Manager: true
Managers: 2 Managers: 2
@ -182,4 +191,4 @@ Here is a sample output for a daemon running on Windows Server 2016:
Registry: https://index.docker.io/v1/ Registry: https://index.docker.io/v1/
Insecure Registries: Insecure Registries:
127.0.0.0/8 127.0.0.0/8
Live Restore Enabled: false Live Restore Enabled: false

23
docs/reference/commandline/inspect.md
View File

@ -4,6 +4,15 @@ description: "The inspect command description and usage"
keywords: ["inspect, container, json"] keywords: ["inspect, container, json"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# inspect # inspect
```markdown ```markdown
@ -34,29 +43,39 @@ describes all the details of the format.
For the most part, you can pick out any field from the JSON in a fairly For the most part, you can pick out any field from the JSON in a fairly
straightforward manner. straightforward manner.
{% raw %}
$ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $INSTANCE_ID $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $INSTANCE_ID
{% endraw %}
**Get an instance's MAC address:** **Get an instance's MAC address:**
For the most part, you can pick out any field from the JSON in a fairly For the most part, you can pick out any field from the JSON in a fairly
straightforward manner. straightforward manner.
{% raw %}
$ docker inspect --format='{{range .NetworkSettings.Networks}}{{.MacAddress}}{{end}}' $INSTANCE_ID $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.MacAddress}}{{end}}' $INSTANCE_ID
{% endraw %}
**Get an instance's log path:** **Get an instance's log path:**
{% raw %}
$ docker inspect --format='{{.LogPath}}' $INSTANCE_ID $ docker inspect --format='{{.LogPath}}' $INSTANCE_ID
{% endraw %}
**Get a Task's image name:** **Get a Task's image name:**
{% raw %}
$ docker inspect --format='{{.Container.Spec.Image}}' $INSTANCE_ID $ docker inspect --format='{{.Container.Spec.Image}}' $INSTANCE_ID
{% endraw %}
**List all port bindings:** **List all port bindings:**
One can loop over arrays and maps in the results to produce simple text One can loop over arrays and maps in the results to produce simple text
output: output:
{% raw %}
$ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_ID $ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_ID
{% endraw %}
**Find a specific port mapping:** **Find a specific port mapping:**
@ -68,7 +87,9 @@ numeric public port, you use `index` to find the specific port map, and
then `index` 0 contains the first object inside of that. Then we ask for then `index` 0 contains the first object inside of that. Then we ask for
the `HostPort` field to get the public address. the `HostPort` field to get the public address.
{% raw %}
$ docker inspect --format='{{(index (index .NetworkSettings.Ports "8787/tcp") 0).HostPort}}' $INSTANCE_ID $ docker inspect --format='{{(index (index .NetworkSettings.Ports "8787/tcp") 0).HostPort}}' $INSTANCE_ID
{% endraw %}
**Get a subsection in JSON format:** **Get a subsection in JSON format:**
@ -77,4 +98,6 @@ fields, by default you get a Go-style dump of the inner values.
Docker adds a template function, `json`, which can be applied to get Docker adds a template function, `json`, which can be applied to get
results in JSON format. results in JSON format.
{% raw %}
$ docker inspect --format='{{json .Config}}' $INSTANCE_ID $ docker inspect --format='{{json .Config}}' $INSTANCE_ID
{% endraw %}

9
docs/reference/commandline/kill.md
View File

@ -4,6 +4,15 @@ description: "The kill command description and usage"
keywords: ["container, kill, signal"] keywords: ["container, kill, signal"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# kill # kill
```markdown ```markdown

9
docs/reference/commandline/load.md
View File

@ -4,6 +4,15 @@ description: "The load command description and usage"
keywords: ["stdin, tarred, repository"] keywords: ["stdin, tarred, repository"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# load # load
```markdown ```markdown

13
docs/reference/commandline/login.md
View File

@ -4,6 +4,15 @@ description: "The login command description and usage"
keywords: ["registry, login, image"] keywords: ["registry, login, image"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# login # login
```markdown ```markdown
@ -48,12 +57,12 @@ This is the list of currently available credentials helpers and where
you can download them from: you can download them from:
- D-Bus Secret Service: https://github.com/docker/docker-credential-helpers/releases - D-Bus Secret Service: https://github.com/docker/docker-credential-helpers/releases
- Apple OS X keychain: https://github.com/docker/docker-credential-helpers/releases - Apple macOS keychain: https://github.com/docker/docker-credential-helpers/releases
- Microsoft Windows Credential Manager: https://github.com/docker/docker-credential-helpers/releases - Microsoft Windows Credential Manager: https://github.com/docker/docker-credential-helpers/releases
### Usage ### Usage
You need to speficy the credentials store in `$HOME/.docker/config.json` You need to specify the credentials store in `$HOME/.docker/config.json`
to tell the docker engine to use it: to tell the docker engine to use it:
```json ```json

9
docs/reference/commandline/logout.md
View File

@ -4,6 +4,15 @@ description: "The logout command description and usage"
keywords: ["logout, docker, registry"] keywords: ["logout, docker, registry"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# logout # logout
```markdown ```markdown

9
docs/reference/commandline/logs.md
View File

@ -4,6 +4,15 @@ description: "The logs command description and usage"
keywords: ["logs, retrieve, docker"] keywords: ["logs, retrieve, docker"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# logs # logs
```markdown ```markdown

9
docs/reference/commandline/menu.md
View File

@ -5,7 +5,14 @@ keywords: ["Docker, Docker documentation, CLI, command line"]
identifier: "smn_cli" identifier: "smn_cli"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# The Docker commands # The Docker commands

9
docs/reference/commandline/network_connect.md
View File

@ -4,6 +4,15 @@ description: "The network connect command description and usage"
keywords: ["network, connect, user-defined"] keywords: ["network, connect, user-defined"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# network connect # network connect
```markdown ```markdown

11
docs/reference/commandline/network_create.md
View File

@ -4,6 +4,15 @@ description: "The network create command description and usage"
keywords: ["network, create"] keywords: ["network, create"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# network create # network create
```markdown ```markdown
@ -129,7 +138,7 @@ support it you can create multiple subnetworks.
$ docker network create -d overlay \ $ docker network create -d overlay \
--subnet=192.168.0.0/16 \ --subnet=192.168.0.0/16 \
--subnet=192.170.0.0/16 \ --subnet=192.170.0.0/16 \
--gateway=192.168.0.100 \ --gateway=192.168.0.100 \
--gateway=192.170.0.100 \ --gateway=192.170.0.100 \
--ip-range=192.168.1.0/24 \ --ip-range=192.168.1.0/24 \
--aux-address="my-router=192.168.1.5" --aux-address="my-switch=192.168.1.6" \ --aux-address="my-router=192.168.1.5" --aux-address="my-switch=192.168.1.6" \

9
docs/reference/commandline/network_disconnect.md
View File

@ -4,6 +4,15 @@ description: "The network disconnect command description and usage"
keywords: ["network, disconnect, user-defined"] keywords: ["network, disconnect, user-defined"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# network disconnect # network disconnect
```markdown ```markdown

9
docs/reference/commandline/network_inspect.md
View File

@ -4,6 +4,15 @@ description: "The network inspect command description and usage"
keywords: ["network, inspect, user-defined"] keywords: ["network, inspect, user-defined"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# network inspect # network inspect
```markdown ```markdown

11
docs/reference/commandline/network_ls.md
View File

@ -4,6 +4,15 @@ description: "The network ls command description and usage"
keywords: ["network, list, user-defined"] keywords: ["network, list, user-defined"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# docker network ls # docker network ls
```markdown ```markdown
@ -175,7 +184,7 @@ Valid placeholders for the Go template are listed below:
Placeholder | Description Placeholder | Description
------------|------------------------------------------------------------------------------------------ ------------|------------------------------------------------------------------------------------------
`.ID` | Network ID `.ID` | Network ID
`.Name` | Network name `.Name` | Network name
`.Driver` | Network driver `.Driver` | Network driver
`.Scope` | Network scope (local, global) `.Scope` | Network scope (local, global)

9
docs/reference/commandline/network_rm.md
View File

@ -4,6 +4,15 @@ description: "the network rm command description and usage"
keywords: ["network, rm, user-defined"] keywords: ["network, rm, user-defined"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# network rm # network rm
```markdown ```markdown

9
docs/reference/commandline/node_demote.md
View File

@ -4,6 +4,15 @@ description: "The node demote command description and usage"
keywords: ["node, demote"] keywords: ["node, demote"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# node demote # node demote
```markdown ```markdown

11
docs/reference/commandline/node_inspect.md
View File

@ -4,6 +4,15 @@ description: "The node inspect command description and usage"
keywords: ["node, inspect"] keywords: ["node, inspect"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# node inspect # node inspect
```markdown ```markdown
@ -89,8 +98,10 @@ Example output:
} }
] ]
{% raw %}
$ docker node inspect --format '{{ .ManagerStatus.Leader }}' self $ docker node inspect --format '{{ .ManagerStatus.Leader }}' self
false false
{% endraw %}
$ docker node inspect --pretty self $ docker node inspect --pretty self
ID: e216jshn25ckzbvmwlnh5jr3g ID: e216jshn25ckzbvmwlnh5jr3g

9
docs/reference/commandline/node_ls.md
View File

@ -4,6 +4,15 @@ description: "The node ls command description and usage"
keywords: ["node, list"] keywords: ["node, list"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# node ls # node ls
```markdown ```markdown

9
docs/reference/commandline/node_promote.md
View File

@ -4,6 +4,15 @@ description: "The node promote command description and usage"
keywords: ["node, promote"] keywords: ["node, promote"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# node promote # node promote
```markdown ```markdown

9
docs/reference/commandline/node_ps.md
View File

@ -5,6 +5,15 @@ keywords: ["node, tasks", "ps"]
aliases: ["/engine/reference/commandline/node_tasks/"] aliases: ["/engine/reference/commandline/node_tasks/"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# node ps # node ps
```markdown ```markdown

9
docs/reference/commandline/node_rm.md
View File

@ -4,6 +4,15 @@ description: "The node rm command description and usage"
keywords: ["node, remove"] keywords: ["node, remove"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# node rm # node rm
```markdown ```markdown

9
docs/reference/commandline/node_update.md
View File

@ -4,6 +4,15 @@ description: "The node update command description and usage"
keywords: ["resources, update, dynamically"] keywords: ["resources, update, dynamically"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
## update ## update
```markdown ```markdown

9
docs/reference/commandline/pause.md
View File

@ -4,6 +4,15 @@ description: "The pause command description and usage"
keywords: ["cgroups, container, suspend, SIGSTOP"] keywords: ["cgroups, container, suspend, SIGSTOP"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# pause # pause
```markdown ```markdown

9
docs/reference/commandline/plugin_disable.md
View File

@ -5,6 +5,15 @@ keywords: ["plugin, disable"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# plugin disable (experimental) # plugin disable (experimental)
```markdown ```markdown

9
docs/reference/commandline/plugin_enable.md
View File

@ -5,6 +5,15 @@ keywords: ["plugin, enable"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# plugin enable (experimental) # plugin enable (experimental)
```markdown ```markdown

9
docs/reference/commandline/plugin_inspect.md
View File

@ -5,6 +5,15 @@ keywords: ["plugin, inspect"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# plugin inspect (experimental) # plugin inspect (experimental)
```markdown ```markdown

9
docs/reference/commandline/plugin_install.md
View File

@ -5,6 +5,15 @@ keywords: ["plugin, install"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# plugin install (experimental) # plugin install (experimental)
```markdown ```markdown

9
docs/reference/commandline/plugin_ls.md
View File

@ -5,6 +5,15 @@ keywords: ["plugin, list"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# plugin ls (experimental) # plugin ls (experimental)
```markdown ```markdown

9
docs/reference/commandline/plugin_rm.md
View File

@ -5,6 +5,15 @@ keywords: ["plugin, rm"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# plugin rm (experimental) # plugin rm (experimental)
```markdown ```markdown

9
docs/reference/commandline/port.md
View File

@ -4,6 +4,15 @@ description: "The port command description and usage"
keywords: ["port, mapping, container"] keywords: ["port, mapping, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# port # port
```markdown ```markdown

22
docs/reference/commandline/ps.md
View File

@ -4,6 +4,15 @@ description: "The ps command description and usage"
keywords: ["container, running, list"] keywords: ["container, running, list"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# ps # ps
```markdown ```markdown
@ -145,6 +154,7 @@ $ docker ps -a --filter 'exited=137'
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
b3e1c0ed5bfe ubuntu:latest "sleep 1000" 12 seconds ago Exited (137) 5 seconds ago grave_kowalevski b3e1c0ed5bfe ubuntu:latest "sleep 1000" 12 seconds ago Exited (137) 5 seconds ago grave_kowalevski
a2eb5558d669 redis:latest "/entrypoint.sh redi 2 hours ago Exited (137) 2 hours ago sharp_lalande a2eb5558d669 redis:latest "/entrypoint.sh redi 2 hours ago Exited (137) 2 hours ago sharp_lalande
```
Any of these events result in a `137` status: Any of these events result in a `137` status:
@ -271,7 +281,7 @@ CONTAINER ID IMAGE COMMAND CREATED STATUS
The `volume` filter shows only containers that mount a specific volume or have The `volume` filter shows only containers that mount a specific volume or have
a volume mounted in a specific path: a volume mounted in a specific path:
```bash ```bash{% raw %}
$ docker ps --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}" $ docker ps --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID MOUNTS CONTAINER ID MOUNTS
9c3527ed70ce remote-volume 9c3527ed70ce remote-volume
@ -279,7 +289,7 @@ CONTAINER ID MOUNTS
$ docker ps --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}" $ docker ps --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID MOUNTS CONTAINER ID MOUNTS
9c3527ed70ce remote-volume 9c3527ed70ce remote-volume
``` {% endraw %}```
#### Network #### Network
@ -304,7 +314,9 @@ example shows all containers that are attached to the `net1` network, using
the network id as a filter; the network id as a filter;
```bash ```bash
{% raw %}
$ docker network inspect --format "{{.ID}}" net1 $ docker network inspect --format "{{.ID}}" net1
{% endraw %}
8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5 8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5
@ -333,7 +345,7 @@ Placeholder | Description
`.Size` | Container disk size. `.Size` | Container disk size.
`.Names` | Container names. `.Names` | Container names.
`.Labels` | All labels assigned to the container. `.Labels` | All labels assigned to the container.
`.Label` | Value of a specific label for this container. For example `'{{.Label "com.docker.swarm.cpu"}}'` `.Label` | Value of a specific label for this container. For example `'{% raw %}{{.Label "com.docker.swarm.cpu"}}{% endraw %}'`
`.Mounts` | Names of the volumes mounted in this container. `.Mounts` | Names of the volumes mounted in this container.
When using the `--format` option, the `ps` command will either output the data When using the `--format` option, the `ps` command will either output the data
@ -344,7 +356,9 @@ The following example uses a template without headers and outputs the `ID` and
`Command` entries separated by a colon for all running containers: `Command` entries separated by a colon for all running containers:
```bash ```bash
{% raw %}
$ docker ps --format "{{.ID}}: {{.Command}}" $ docker ps --format "{{.ID}}: {{.Command}}"
{% endraw %}
a87ecb4f327c: /bin/sh -c #(nop) MA a87ecb4f327c: /bin/sh -c #(nop) MA
01946d9d34d8: /bin/sh -c #(nop) MA 01946d9d34d8: /bin/sh -c #(nop) MA
@ -355,7 +369,9 @@ c1d3b0166030: /bin/sh -c yum -y up
To list all running containers with their labels in a table format you can use: To list all running containers with their labels in a table format you can use:
```bash ```bash
{% raw %}
$ docker ps --format "table {{.ID}}\t{{.Labels}}" $ docker ps --format "table {{.ID}}\t{{.Labels}}"
{% endraw %}
CONTAINER ID LABELS CONTAINER ID LABELS
a87ecb4f327c com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd a87ecb4f327c com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd

13
docs/reference/commandline/pull.md
View File

@ -4,6 +4,15 @@ description: "The pull command description and usage"
keywords: ["pull, image, hub, docker"] keywords: ["pull, image, hub, docker"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# pull # pull
```markdown ```markdown
@ -131,7 +140,7 @@ above, the digest of the image is:
Docker also prints the digest of an image when *pushing* to a registry. This Docker also prints the digest of an image when *pushing* to a registry. This
may be useful if you want to pin to a version of the image you just pushed. may be useful if you want to pin to a version of the image you just pushed.
A digest takes the place of the tag when pulling an image, for example, to A digest takes the place of the tag when pulling an image, for example, to
pull the above image by digest, run the following command: pull the above image by digest, run the following command:
```bash ```bash
@ -154,7 +163,7 @@ MAINTAINER some maintainer <maintainer@example.com>
``` ```
> **Note**: Using this feature "pins" an image to a specific version in time. > **Note**: Using this feature "pins" an image to a specific version in time.
> Docker will therefore not pull updated versions of an image, which may include > Docker will therefore not pull updated versions of an image, which may include
> security updates. If you want to pull an updated image, you need to change the > security updates. If you want to pull an updated image, you need to change the
> digest accordingly. > digest accordingly.

9
docs/reference/commandline/push.md
View File

@ -4,6 +4,15 @@ description: "The push command description and usage"
keywords: ["share, push, image"] keywords: ["share, push, image"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# push # push
```markdown ```markdown

9
docs/reference/commandline/rename.md
View File

@ -4,6 +4,15 @@ description: "The rename command description and usage"
keywords: ["rename, docker, container"] keywords: ["rename, docker, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# rename # rename
```markdown ```markdown

9
docs/reference/commandline/restart.md
View File

@ -4,6 +4,15 @@ description: "The restart command description and usage"
keywords: ["restart, container, Docker"] keywords: ["restart, container, Docker"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# restart # restart
```markdown ```markdown

9
docs/reference/commandline/rm.md
View File

@ -4,6 +4,15 @@ description: "The rm command description and usage"
keywords: ["remove, Docker, container"] keywords: ["remove, Docker, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# rm # rm
```markdown ```markdown

9
docs/reference/commandline/rmi.md
View File

@ -4,6 +4,15 @@ description: "The rmi command description and usage"
keywords: ["remove, image, Docker"] keywords: ["remove, image, Docker"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# rmi # rmi
```markdown ```markdown

15
docs/reference/commandline/run.md
View File

@ -4,6 +4,15 @@ description: "The run command description and usage"
keywords: ["run, command, container"] keywords: ["run, command, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# run # run
```markdown ```markdown
@ -618,8 +627,8 @@ or a signal name in the format SIGNAME, for instance SIGKILL.
### Optional security options (--security-opt) ### Optional security options (--security-opt)
On Windows, this flag can be used to specify the `credentialspec` option. On Windows, this flag can be used to specify the `credentialspec` option.
The `credentialspec` must be in the format `file://spec.txt` or `registry://keyname`. The `credentialspec` must be in the format `file://spec.txt` or `registry://keyname`.
### Stop container with timeout (--stop-timeout) ### Stop container with timeout (--stop-timeout)
@ -673,7 +682,7 @@ network namespace, run this command:
> **Note**: Not all sysctls are namespaced. Docker does not support changing sysctls > **Note**: Not all sysctls are namespaced. Docker does not support changing sysctls
> inside of a container that also modify the host system. As the kernel > inside of a container that also modify the host system. As the kernel
> evolves we expect to see more sysctls become namespaced. > evolves we expect to see more sysctls become namespaced.
#### Currently supported sysctls #### Currently supported sysctls

9
docs/reference/commandline/save.md
View File

@ -4,6 +4,15 @@ description: "The save command description and usage"
keywords: ["tarred, repository, backup"] keywords: ["tarred, repository, backup"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# save # save
```markdown ```markdown

11
docs/reference/commandline/search.md
View File

@ -4,6 +4,15 @@ description: "The search command description and usage"
keywords: ["search, hub, images"] keywords: ["search, hub, images"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# search # search
```markdown ```markdown
@ -76,7 +85,7 @@ at least 3 stars and the description isn't truncated in the output:
## Limit search results (--limit) ## Limit search results (--limit)
The flag `--limit` is the maximium number of results returned by a search. This value could The flag `--limit` is the maximum number of results returned by a search. This value could
be in the range between 1 and 100. The default value of `--limit` is 25. be in the range between 1 and 100. The default value of `--limit` is 25.

9
docs/reference/commandline/service_create.md
View File

@ -4,6 +4,15 @@ description: "The service create command description and usage"
keywords: ["service, create"] keywords: ["service, create"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# service create # service create
```Markdown ```Markdown

13
docs/reference/commandline/service_inspect.md
View File

@ -4,6 +4,15 @@ description: "The service inspect command description and usage"
keywords: ["service, inspect"] keywords: ["service, inspect"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# service inspect # service inspect
```Markdown ```Markdown
@ -136,10 +145,10 @@ The `--format` option can be used to obtain specific information about a
service. For example, the following command outputs the number of replicas service. For example, the following command outputs the number of replicas
of the "redis" service. of the "redis" service.
```bash ```bash{% raw %}
$ docker service inspect --format='{{.Spec.Mode.Replicated.Replicas}}' redis $ docker service inspect --format='{{.Spec.Mode.Replicated.Replicas}}' redis
10 10
``` {% endraw %}```
## Related information ## Related information

9
docs/reference/commandline/service_ls.md
View File

@ -4,6 +4,15 @@ description: "The service ls command description and usage"
keywords: ["service, ls"] keywords: ["service, ls"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# service ls # service ls
```Markdown ```Markdown

9
docs/reference/commandline/service_ps.md
View File

@ -5,6 +5,15 @@ keywords: ["service, tasks", "ps"]
aliases: ["/engine/reference/commandline/service_tasks/"] aliases: ["/engine/reference/commandline/service_tasks/"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# service ps # service ps
```Markdown ```Markdown

9
docs/reference/commandline/service_rm.md
View File

@ -4,6 +4,15 @@ description: "The service rm command description and usage"
keywords: ["service, rm"] keywords: ["service, rm"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# service rm # service rm
```Markdown ```Markdown

19
docs/reference/commandline/service_scale.md
View File

@ -4,6 +4,15 @@ description: "The service scale command description and usage"
keywords: ["service, scale"] keywords: ["service, scale"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# service scale # service scale
```markdown ```markdown
@ -19,8 +28,10 @@ Options:
### Scale a service ### Scale a service
If you scale a service, you set the *desired* number of replicas. Even though The scale command enables you to scale one or more services either up or down to
the command returns directly, actual scaling of the service may take some time. the desired number of replicas. The command will return immediately, but the
actual scaling of the service may take some time. To stop all replicas of a
service while keeping the service active in the swarm you can set the scale to 0.
For example, the following command scales the "frontend" service to 50 tasks. For example, the following command scales the "frontend" service to 50 tasks.
@ -30,7 +41,7 @@ frontend scaled to 50
``` ```
Directly afterwards, run `docker service ls`, to see the actual number of Directly afterwards, run `docker service ls`, to see the actual number of
replicas replicas.
```bash ```bash
$ docker service ls --filter name=frontend $ docker service ls --filter name=frontend
@ -40,7 +51,7 @@ ID NAME REPLICAS IMAGE COMMAND
``` ```
You can also scale a service using the [`docker service update`](service_update.md) You can also scale a service using the [`docker service update`](service_update.md)
command. The following commands are therefore equivalent: command. The following commands are equivalent:
```bash ```bash
$ docker service scale frontend=50 $ docker service scale frontend=50

9
docs/reference/commandline/service_update.md
View File

@ -4,6 +4,15 @@ description: "The service update command description and usage"
keywords: ["service, update"] keywords: ["service, update"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# service update # service update
```Markdown ```Markdown

9
docs/reference/commandline/stack_config.md
View File

@ -5,6 +5,15 @@ keywords: ["stack, config"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stack config (experimental) # stack config (experimental)
```markdown ```markdown

9
docs/reference/commandline/stack_deploy.md
View File

@ -5,6 +5,15 @@ keywords: ["stack, deploy, up"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stack deploy (experimental) # stack deploy (experimental)
```markdown ```markdown

9
docs/reference/commandline/stack_ls.md
View File

@ -5,6 +5,15 @@ keywords: ["stack, ls"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stack ls (experimental) # stack ls (experimental)
```markdown ```markdown

9
docs/reference/commandline/stack_ps.md
View File

@ -5,6 +5,15 @@ keywords: ["stack, ps"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stack ps (experimental) # stack ps (experimental)
```markdown ```markdown

11
docs/reference/commandline/stack_rm.md
View File

@ -3,10 +3,17 @@ title: "stack rm"
description: "The stack rm command description and usage" description: "The stack rm command description and usage"
keywords: ["stack, rm, remove, down"] keywords: ["stack, rm, remove, down"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stack rm (experimental) # stack rm (experimental)
```markdown ```markdown

9
docs/reference/commandline/stack_services.md
View File

@ -5,6 +5,15 @@ keywords: ["stack, services"]
advisory: "experimental" advisory: "experimental"
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stack services (experimental) # stack services (experimental)
```markdown ```markdown

9
docs/reference/commandline/start.md
View File

@ -4,6 +4,15 @@ description: "The start command description and usage"
keywords: ["Start, container, stopped"] keywords: ["Start, container, stopped"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# start # start
```markdown ```markdown

9
docs/reference/commandline/stats.md
View File

@ -4,6 +4,15 @@ description: "The stats command description and usage"
keywords: ["container, resource, statistics"] keywords: ["container, resource, statistics"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stats # stats
```markdown ```markdown

9
docs/reference/commandline/stop.md
View File

@ -4,6 +4,15 @@ description: "The stop command description and usage"
keywords: ["stop, SIGKILL, SIGTERM"] keywords: ["stop, SIGKILL, SIGTERM"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# stop # stop
```markdown ```markdown

9
docs/reference/commandline/swarm_init.md
View File

@ -4,6 +4,15 @@ description: "The swarm init command description and usage"
keywords: ["swarm, init"] keywords: ["swarm, init"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# swarm init # swarm init
```markdown ```markdown

9
docs/reference/commandline/swarm_join.md
View File

@ -4,6 +4,15 @@ description: "The swarm join command description and usage"
keywords: ["swarm, join"] keywords: ["swarm, join"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# swarm join # swarm join
```markdown ```markdown

9
docs/reference/commandline/swarm_join_token.md
View File

@ -4,6 +4,15 @@ description: "The swarm join-token command description and usage"
keywords: ["swarm, join-token"] keywords: ["swarm, join-token"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# swarm join-token # swarm join-token
```markdown ```markdown

9
docs/reference/commandline/swarm_leave.md
View File

@ -4,6 +4,15 @@ description: "The swarm leave command description and usage"
keywords: ["swarm, leave"] keywords: ["swarm, leave"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# swarm leave # swarm leave
```markdown ```markdown

9
docs/reference/commandline/swarm_update.md
View File

@ -4,6 +4,15 @@ description: "The swarm update command description and usage"
keywords: ["swarm, update"] keywords: ["swarm, update"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# swarm update # swarm update
```markdown ```markdown

9
docs/reference/commandline/system_df.md
View File

@ -4,6 +4,15 @@ description: "The system df command description and usage"
keywords: [system, data, usage, disk] keywords: [system, data, usage, disk]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# system df # system df
```markdown ```markdown

9
docs/reference/commandline/system_prune.md
View File

@ -4,6 +4,15 @@ description: "Remove unused data"
keywords: [system, prune, delete, remove] keywords: [system, prune, delete, remove]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# system prune # system prune
```markdown ```markdown

9
docs/reference/commandline/tag.md
View File

@ -4,6 +4,15 @@ description: "The tag command description and usage"
keywords: ["tag, name, image"] keywords: ["tag, name, image"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# tag # tag
```markdown ```markdown

9
docs/reference/commandline/top.md
View File

@ -4,6 +4,15 @@ description: "The top command description and usage"
keywords: ["container, running, processes"] keywords: ["container, running, processes"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# top # top
```markdown ```markdown

9
docs/reference/commandline/unpause.md
View File

@ -4,6 +4,15 @@ description: "The unpause command description and usage"
keywords: ["cgroups, suspend, container"] keywords: ["cgroups, suspend, container"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# unpause # unpause
```markdown ```markdown

9
docs/reference/commandline/update.md
View File

@ -4,6 +4,15 @@ description: "The update command description and usage"
keywords: ["resources, update, dynamically"] keywords: ["resources, update, dynamically"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
## update ## update
```markdown ```markdown

13
docs/reference/commandline/version.md
View File

@ -4,6 +4,15 @@ description: "The version command description and usage"
keywords: ["version, architecture, api"] keywords: ["version, architecture, api"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# version # version
```markdown ```markdown
@ -45,10 +54,14 @@ describes all the details of the format.
**Get server version:** **Get server version:**
{% raw %}
$ docker version --format '{{.Server.Version}}' $ docker version --format '{{.Server.Version}}'
1.8.0 1.8.0
{% endraw %}
**Dump raw data:** **Dump raw data:**
{% raw %}
$ docker version --format '{{json .}}' $ docker version --format '{{json .}}'
{"Client":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"},"ServerOK":true,"Server":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","KernelVersion":"3.13.2-gentoo","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"}} {"Client":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"},"ServerOK":true,"Server":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","KernelVersion":"3.13.2-gentoo","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"}}
{% endraw %}

9
docs/reference/commandline/volume_create.md
View File

@ -4,6 +4,15 @@ description: "The volume create command description and usage"
keywords: ["volume, create"] keywords: ["volume, create"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# volume create # volume create
```markdown ```markdown

11
docs/reference/commandline/volume_inspect.md
View File

@ -4,6 +4,15 @@ description: "The volume inspect command description and usage"
keywords: ["volume, inspect"] keywords: ["volume, inspect"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# volume inspect # volume inspect
```markdown ```markdown
@ -36,8 +45,10 @@ Example output:
} }
] ]
{% raw %}
$ docker volume inspect --format '{{ .Mountpoint }}' 85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d $ docker volume inspect --format '{{ .Mountpoint }}' 85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d
/var/lib/docker/volumes/85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d/_data /var/lib/docker/volumes/85bffb0677236974f93955d8ecc4df55ef5070117b0e53333cc1b443777be24d/_data
{% endraw %}
## Related information ## Related information

9
docs/reference/commandline/volume_ls.md
View File

@ -4,6 +4,15 @@ description: "The volume ls command description and usage"
keywords: ["volume, list"] keywords: ["volume, list"]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# volume ls # volume ls
```markdown ```markdown

9
docs/reference/commandline/volume_prune.md
View File

@ -4,6 +4,15 @@ description: "Remove unused volumes"
keywords: [volume, prune, delete] keywords: [volume, prune, delete]
--- ---
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
# volume prune # volume prune
```markdown ```markdown

Some files were not shown because too many files have changed in this diff Show More