Merge pull request #20781 from thaJeztah/docs-cherry-picks-2
Docs cherry picks 2
diff --git a/docs/extend/plugin_api.md b/docs/extend/plugin_api.md
index c6793a3..e0a9141 100644
--- a/docs/extend/plugin_api.md
+++ b/docs/extend/plugin_api.md
@@ -127,6 +127,12 @@
Responds with a list of Docker subsystems which this plugin implements.
After activation, the plugin will then be sent events from this subsystem.
+Possible values are:
+ - [`authz`](authorization.md)
+ - [`NetworkDriver`](plugins_network.md)
+ - [`VolumeDriver`](plugins_volume.md)
+
+
## Plugin retries
Attempts to call a method on a plugin are retried with an exponential backoff
diff --git a/docs/extend/plugins.md b/docs/extend/plugins.md
index ea02c9a..da46a16 100644
--- a/docs/extend/plugins.md
+++ b/docs/extend/plugins.md
@@ -93,6 +93,17 @@
secure and work in partially connected networks, and other adverse
environments - all configured with delightful simplicity.
+* The [Kuryr Network Plugin](https://github.com/openstack/kuryr) is
+ developed as part of the OpenStack Kuryr project and implements the
+ Docker networking (libnetwork) remote driver API by utilizing
+ Neutron, the OpenStack networking service. It includes an IPAM
+ driver as well.
+
+* The [Local Persist Plugin](https://github.com/CWSpear/local-persist)
+ extends the default `local` driver's functionality by allowing you specify
+ a mountpoint anywhere on the host, which enables the files to *always persist*,
+ even if the volume is removed via `docker volume rm`.
+
## Troubleshooting a plugin
If you are having problems with Docker after loading a plugin, ask the authors
diff --git a/docs/installation/linux/ubuntulinux.md b/docs/installation/linux/ubuntulinux.md
index 1e01366..0624943 100644
--- a/docs/installation/linux/ubuntulinux.md
+++ b/docs/installation/linux/ubuntulinux.md
@@ -109,10 +109,9 @@
### Prerequisites by Ubuntu Version
- Ubuntu Wily 15.10
-- Ubuntu Vivid 15.04
- Ubuntu Trusty 14.04 (LTS)
-For Ubuntu Trusty, Vivid, and Wily, it's recommended to install the
+For Ubuntu Trusty and Wily, it's recommended to install the
`linux-image-extra` kernel package. The `linux-image-extra` package
allows you use the `aufs` storage driver.
diff --git a/docs/installation/windows.md b/docs/installation/windows.md
index 099bd78..459914d 100644
--- a/docs/installation/windows.md
+++ b/docs/installation/windows.md
@@ -348,9 +348,9 @@
## Login with PUTTY instead of using the CMD
Docker Machine generates and uses the public/private key pair in your
-`%USERPROFILE%\.ssh` directory so to log in you need to use the private key from
-this same directory. The private key needs to be converted into the format PuTTY
-uses. You can do this with
+`%USERPROFILE%\.docker\machine\machines\<name_of_your_machine>` directory. To
+log in you need to use the private key from this same directory. The private key
+needs to be converted into the format PuTTY uses. You can do this with
[puttygen](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html):
1. Open `puttygen.exe` and load ("File"->"Load" menu) the private key from (you may need to change to the `All Files (*.*)` filter)
diff --git a/docs/reference/api/docker_remote_api_v1.14.md b/docs/reference/api/docker_remote_api_v1.14.md
index 3b8c903..a300807 100644
--- a/docs/reference/api/docker_remote_api_v1.14.md
+++ b/docs/reference/api/docker_remote_api_v1.14.md
@@ -180,7 +180,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -267,7 +267,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -331,7 +331,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get stdout and stderr logs from the container ``id``
@@ -364,7 +364,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -400,7 +400,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -423,13 +423,13 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
Content-Type: application/json
{
@@ -462,7 +462,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -487,7 +487,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -511,7 +511,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -536,7 +536,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -556,7 +556,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -576,7 +576,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -654,7 +654,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -689,7 +689,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -712,7 +712,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -740,7 +740,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
diff --git a/docs/reference/api/docker_remote_api_v1.15.md b/docs/reference/api/docker_remote_api_v1.15.md
index 1175268..d9da8e6 100644
--- a/docs/reference/api/docker_remote_api_v1.15.md
+++ b/docs/reference/api/docker_remote_api_v1.15.md
@@ -268,7 +268,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -355,7 +355,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -419,7 +419,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get stdout and stderr logs from the container ``id``
@@ -451,7 +451,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -487,7 +487,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -510,7 +510,7 @@
### Resize a container TTY
-`GET /containers/(id)/resize?h=<height>&w=<width>`
+`GET /containers/(id or name)/resize?h=<height>&w=<width>`
Resize the TTY of container `id`
@@ -532,13 +532,13 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
Content-Type: application/json
{
@@ -610,7 +610,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -635,7 +635,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -659,7 +659,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -684,7 +684,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -704,7 +704,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -724,7 +724,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -803,7 +803,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -838,7 +838,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -861,7 +861,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -889,7 +889,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
@@ -1623,7 +1623,7 @@
### Exec Create
-`POST /containers/(id)/exec`
+`POST /containers/(id or name)/exec`
Sets up an exec instance in a running container `id`
@@ -1701,7 +1701,7 @@
- **404** – no such exec instance
**Stream details**:
- Similar to the stream behavior of `POST /container/(id)/attach` API
+ Similar to the stream behavior of `POST /containers/(id or name)/attach` API
### Exec Resize
diff --git a/docs/reference/api/docker_remote_api_v1.16.md b/docs/reference/api/docker_remote_api_v1.16.md
index 191bc79..fdb3078 100644
--- a/docs/reference/api/docker_remote_api_v1.16.md
+++ b/docs/reference/api/docker_remote_api_v1.16.md
@@ -268,7 +268,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -355,7 +355,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -419,7 +419,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get stdout and stderr logs from the container ``id``
@@ -451,7 +451,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -487,7 +487,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -510,7 +510,7 @@
### Resize a container TTY
-`POST /containers/(id)/resize?h=<height>&w=<width>`
+`POST /containers/(id or name)/resize?h=<height>&w=<width>`
Resize the TTY for container with `id`. The container must be restarted for the resize to take effect.
@@ -532,7 +532,7 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
@@ -542,7 +542,7 @@
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
**Example response**:
@@ -557,7 +557,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -582,7 +582,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -606,7 +606,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -631,7 +631,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -651,7 +651,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -671,7 +671,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -751,7 +751,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -786,7 +786,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -809,7 +809,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -837,7 +837,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
@@ -1585,7 +1585,7 @@
### Exec Create
-`POST /containers/(id)/exec`
+`POST /containers/(id or name)/exec`
Sets up an exec instance in a running container `id`
@@ -1663,7 +1663,7 @@
- **404** – no such exec instance
**Stream details**:
- Similar to the stream behavior of `POST /container/(id)/attach` API
+ Similar to the stream behavior of `POST /containers/(id or name)/attach` API
### Exec Resize
diff --git a/docs/reference/api/docker_remote_api_v1.17.md b/docs/reference/api/docker_remote_api_v1.17.md
index 64d2925..aaa1c9b 100644
--- a/docs/reference/api/docker_remote_api_v1.17.md
+++ b/docs/reference/api/docker_remote_api_v1.17.md
@@ -272,7 +272,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -394,7 +394,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -458,7 +458,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get stdout and stderr logs from the container ``id``
@@ -493,7 +493,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -529,7 +529,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -552,7 +552,7 @@
### Get container stats based on resource usage
-`GET /containers/(id)/stats`
+`GET /containers/(id or name)/stats`
This endpoint returns a live stream of a container's resource usage statistics.
@@ -640,7 +640,7 @@
### Resize a container TTY
-`POST /containers/(id)/resize?h=<height>&w=<width>`
+`POST /containers/(id or name)/resize?h=<height>&w=<width>`
Resize the TTY for container with `id`. The container must be restarted for the resize to take effect.
@@ -662,7 +662,7 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
@@ -672,7 +672,7 @@
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
**Example response**:
@@ -687,7 +687,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -712,7 +712,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -736,7 +736,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -761,7 +761,7 @@
### Rename a container
-`POST /containers/(id)/rename`
+`POST /containers/(id or name)/rename`
Rename the container `id` to a `new_name`
@@ -786,7 +786,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -806,7 +806,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -826,7 +826,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -909,7 +909,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -944,7 +944,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -967,7 +967,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -995,7 +995,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
@@ -1748,7 +1748,7 @@
### Exec Create
-`POST /containers/(id)/exec`
+`POST /containers/(id or name)/exec`
Sets up an exec instance in a running container `id`
@@ -1826,7 +1826,7 @@
- **404** – no such exec instance
**Stream details**:
- Similar to the stream behavior of `POST /container/(id)/attach` API
+ Similar to the stream behavior of `POST /containers/(id or name)/attach` API
### Exec Resize
@@ -2005,4 +2005,4 @@
To set cross origin requests to the remote api, please add flag "--api-enable-cors"
when running docker in daemon mode.
- $ docker -d -H="192.168.1.9:2375" --api-enable-cors
+ $ docker -d -H="192.168.1.9:2375" --api-enable-cors
diff --git a/docs/reference/api/docker_remote_api_v1.18.md b/docs/reference/api/docker_remote_api_v1.18.md
index 5a3b217..65f56fc 100644
--- a/docs/reference/api/docker_remote_api_v1.18.md
+++ b/docs/reference/api/docker_remote_api_v1.18.md
@@ -299,7 +299,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -432,7 +432,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -496,7 +496,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get stdout and stderr logs from the container ``id``
@@ -534,7 +534,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -576,7 +576,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -599,7 +599,7 @@
### Get container stats based on resource usage
-`GET /containers/(id)/stats`
+`GET /containers/(id or name)/stats`
This endpoint returns a live stream of a container's resource usage statistics.
@@ -687,7 +687,7 @@
### Resize a container TTY
-`POST /containers/(id)/resize?h=<height>&w=<width>`
+`POST /containers/(id or name)/resize?h=<height>&w=<width>`
Resize the TTY for container with `id`. The container must be restarted for the resize to take effect.
@@ -709,7 +709,7 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
@@ -719,7 +719,7 @@
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
**Example response**:
@@ -734,7 +734,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -759,7 +759,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -783,7 +783,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -808,7 +808,7 @@
### Rename a container
-`POST /containers/(id)/rename`
+`POST /containers/(id or name)/rename`
Rename the container `id` to a `new_name`
@@ -833,7 +833,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -853,7 +853,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -873,7 +873,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -956,7 +956,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -991,7 +991,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -1014,7 +1014,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -1042,7 +1042,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
@@ -1194,12 +1194,12 @@
Query Parameters:
-- **dockerfile** - path within the build context to the Dockerfile. This is
+- **dockerfile** - path within the build context to the Dockerfile. This is
ignored if `remote` is specified and points to an individual filename.
- **t** – repository name (and optionally a tag) to be applied to
the resulting image in case of success
-- **remote** – A Git repository URI or HTTP/HTTPS URI build source. If the
- URI specifies a filename, the file's contents are placed into a file
+- **remote** – A Git repository URI or HTTP/HTTPS URI build source. If the
+ URI specifies a filename, the file's contents are placed into a file
called `Dockerfile`.
- **q** – suppress verbose build output
- **nocache** – do not use the cache when building the image
@@ -1599,7 +1599,7 @@
"SwapLimit": 0,
"SystemTime": "2015-03-10T11:11:23.730591467-07:00"
}
-
+
Status Codes:
- **200** – no error
@@ -1866,7 +1866,7 @@
### Exec Create
-`POST /containers/(id)/exec`
+`POST /containers/(id or name)/exec`
Sets up an exec instance in a running container `id`
@@ -1945,7 +1945,7 @@
- **404** – no such exec instance
**Stream details**:
- Similar to the stream behavior of `POST /container/(id)/attach` API
+ Similar to the stream behavior of `POST /containers/(id or name)/attach` API
### Exec Resize
@@ -2118,7 +2118,7 @@
## 3.3 CORS Requests
-To set cross origin requests to the remote api please give values to
+To set cross origin requests to the remote api please give values to
"--api-cors-header" when running docker in daemon mode. Set * will allow all,
default or blank means CORS disabled
diff --git a/docs/reference/api/docker_remote_api_v1.19.md b/docs/reference/api/docker_remote_api_v1.19.md
index 420cc55..dc32a96 100644
--- a/docs/reference/api/docker_remote_api_v1.19.md
+++ b/docs/reference/api/docker_remote_api_v1.19.md
@@ -220,7 +220,7 @@
(ie. the relative weight vs other containers).
- **CpuPeriod** - The length of a CPU period in microseconds.
- **CpuQuota** - Microseconds of CPU time that the container can get in a CPU period.
-- **Cpuset** - Deprecated please don't use. Use `CpusetCpus` instead.
+- **Cpuset** - Deprecated please don't use. Use `CpusetCpus` instead.
- **CpusetCpus** - String value containing the `cgroups CpusetCpus` to use.
- **CpusetMems** - Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems.
- **BlkioWeight** - Block IO weight (relative weight) accepts a weight value between 10 and 1000.
@@ -310,7 +310,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -447,7 +447,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -511,7 +511,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get `stdout` and `stderr` logs from the container ``id``
@@ -551,7 +551,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -593,7 +593,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -616,7 +616,7 @@
### Get container stats based on resource usage
-`GET /containers/(id)/stats`
+`GET /containers/(id or name)/stats`
This endpoint returns a live stream of a container's resource usage statistics.
@@ -708,7 +708,7 @@
### Resize a container TTY
-`POST /containers/(id)/resize?h=<height>&w=<width>`
+`POST /containers/(id or name)/resize?h=<height>&w=<width>`
Resize the TTY for container with `id`. You must restart the container for the resize to take effect.
@@ -730,7 +730,7 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
@@ -740,7 +740,7 @@
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
**Example response**:
@@ -755,7 +755,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -780,7 +780,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -804,7 +804,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -829,7 +829,7 @@
### Rename a container
-`POST /containers/(id)/rename`
+`POST /containers/(id or name)/rename`
Rename the container `id` to a `new_name`
@@ -854,7 +854,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -874,7 +874,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -894,7 +894,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -977,7 +977,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -1012,7 +1012,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -1035,7 +1035,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -1063,7 +1063,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
@@ -1365,37 +1365,37 @@
HTTP/1.1 200 OK
Content-Type: application/json
- [
- {
+ [
+ {
"Id": "3db9c44f45209632d6050b35958829c3a2aa256d81b9a7be45b362ff85c54710",
"Created": 1398108230,
"CreatedBy": "/bin/sh -c #(nop) ADD file:eb15dbd63394e063b805a3c32ca7bf0266ef64676d5a6fab4801f2e81e2a5148 in /",
"Tags": [
"ubuntu:lucid",
"ubuntu:10.04"
- ],
+ ],
"Size": 182964289,
"Comment": ""
- },
- {
+ },
+ {
"Id": "6cfa4d1f33fb861d4d114f43b25abd0ac737509268065cdfd69d544a59c85ab8",
"Created": 1398108222,
"CreatedBy": "/bin/sh -c #(nop) MAINTAINER Tianon Gravi <admwiggin@gmail.com> - mkimage-debootstrap.sh -i iproute,iputils-ping,ubuntu-minimal -t lucid.tar.xz lucid http://archive.ubuntu.com/ubuntu/",
"Tags": null,
"Size": 0,
"Comment": ""
- },
- {
+ },
+ {
"Id": "511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158",
"Created": 1371157430,
"CreatedBy": "",
"Tags": [
"scratch12:latest",
"scratch:latest"
- ],
+ ],
"Size": 0,
"Comment": "Imported from -"
- }
+ }
]
Status Codes:
@@ -1932,7 +1932,7 @@
### Exec Create
-`POST /containers/(id)/exec`
+`POST /containers/(id or name)/exec`
Sets up an exec instance in a running container `id`
@@ -2011,7 +2011,7 @@
- **404** – no such exec instance
**Stream details**:
- Similar to the stream behavior of `POST /container/(id)/attach` API
+ Similar to the stream behavior of `POST /containers/(id or name)/attach` API
### Exec Resize
@@ -2182,7 +2182,7 @@
## 3.3 CORS Requests
-To set cross origin requests to the remote api please give values to
+To set cross origin requests to the remote api please give values to
`--api-cors-header` when running Docker in daemon mode. Set * (asterisk) allows all,
default or blank means CORS disabled
diff --git a/docs/reference/api/docker_remote_api_v1.20.md b/docs/reference/api/docker_remote_api_v1.20.md
index 3ed92f4..1230091 100644
--- a/docs/reference/api/docker_remote_api_v1.20.md
+++ b/docs/reference/api/docker_remote_api_v1.20.md
@@ -318,7 +318,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -460,7 +460,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -524,7 +524,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get `stdout` and `stderr` logs from the container ``id``
@@ -564,7 +564,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -606,7 +606,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -629,7 +629,7 @@
### Get container stats based on resource usage
-`GET /containers/(id)/stats`
+`GET /containers/(id or name)/stats`
This endpoint returns a live stream of a container's resource usage statistics.
@@ -721,7 +721,7 @@
### Resize a container TTY
-`POST /containers/(id)/resize?h=<height>&w=<width>`
+`POST /containers/(id or name)/resize?h=<height>&w=<width>`
Resize the TTY for container with `id`. You must restart the container for the resize to take effect.
@@ -743,7 +743,7 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
@@ -753,7 +753,7 @@
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
**Example response**:
@@ -768,7 +768,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -793,7 +793,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -817,7 +817,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -842,7 +842,7 @@
### Rename a container
-`POST /containers/(id)/rename`
+`POST /containers/(id or name)/rename`
Rename the container `id` to a `new_name`
@@ -867,7 +867,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -887,7 +887,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -907,7 +907,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -990,7 +990,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -1025,7 +1025,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -1048,7 +1048,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -1076,7 +1076,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
@@ -1106,14 +1106,14 @@
### Retrieving information about files and folders in a container
-`HEAD /containers/(id)/archive`
+`HEAD /containers/(id or name)/archive`
See the description of the `X-Docker-Container-Path-Stat` header in the
following section.
### Get an archive of a filesystem resource in a container
-`GET /containers/(id)/archive`
+`GET /containers/(id or name)/archive`
Get an tar archive of a resource in the filesystem of container `id`.
@@ -1174,7 +1174,7 @@
### Extract an archive of files or folders to a directory in a container
-`PUT /containers/(id)/archive`
+`PUT /containers/(id or name)/archive`
Upload a tar archive to be extracted to a path in the filesystem of container
`id`.
@@ -2078,7 +2078,7 @@
### Exec Create
-`POST /containers/(id)/exec`
+`POST /containers/(id or name)/exec`
Sets up an exec instance in a running container `id`
@@ -2157,7 +2157,7 @@
- **404** – no such exec instance
**Stream details**:
- Similar to the stream behavior of `POST /container/(id)/attach` API
+ Similar to the stream behavior of `POST /containers/(id or name)/attach` API
### Exec Resize
diff --git a/docs/reference/api/docker_remote_api_v1.21.md b/docs/reference/api/docker_remote_api_v1.21.md
index bbb98c5..f7e46e8 100644
--- a/docs/reference/api/docker_remote_api_v1.21.md
+++ b/docs/reference/api/docker_remote_api_v1.21.md
@@ -336,7 +336,7 @@
### Inspect a container
-`GET /containers/(id)/json`
+`GET /containers/(id or name)/json`
Return low-level information on the container `id`
@@ -526,7 +526,7 @@
### List processes running inside a container
-`GET /containers/(id)/top`
+`GET /containers/(id or name)/top`
List processes running inside the container `id`. On Unix systems this
is done by running the `ps` command. This endpoint is not
@@ -590,7 +590,7 @@
### Get container logs
-`GET /containers/(id)/logs`
+`GET /containers/(id or name)/logs`
Get `stdout` and `stderr` logs from the container ``id``
@@ -630,7 +630,7 @@
### Inspect changes on a container's filesystem
-`GET /containers/(id)/changes`
+`GET /containers/(id or name)/changes`
Inspect changes on container `id`'s filesystem
@@ -672,7 +672,7 @@
### Export a container
-`GET /containers/(id)/export`
+`GET /containers/(id or name)/export`
Export the contents of container `id`
@@ -695,7 +695,7 @@
### Get container stats based on resource usage
-`GET /containers/(id)/stats`
+`GET /containers/(id or name)/stats`
This endpoint returns a live stream of a container's resource usage statistics.
@@ -799,7 +799,7 @@
### Resize a container TTY
-`POST /containers/(id)/resize`
+`POST /containers/(id or name)/resize`
Resize the TTY for container with `id`. The unit is number of characters. You must restart the container for the resize to take effect.
@@ -826,7 +826,7 @@
### Start a container
-`POST /containers/(id)/start`
+`POST /containers/(id or name)/start`
Start the container `id`
@@ -836,7 +836,7 @@
**Example request**:
- POST /containers/(id)/start HTTP/1.1
+ POST /containers/(id or name)/start HTTP/1.1
**Example response**:
@@ -851,7 +851,7 @@
### Stop a container
-`POST /containers/(id)/stop`
+`POST /containers/(id or name)/stop`
Stop the container `id`
@@ -876,7 +876,7 @@
### Restart a container
-`POST /containers/(id)/restart`
+`POST /containers/(id or name)/restart`
Restart the container `id`
@@ -900,7 +900,7 @@
### Kill a container
-`POST /containers/(id)/kill`
+`POST /containers/(id or name)/kill`
Kill the container `id`
@@ -925,7 +925,7 @@
### Rename a container
-`POST /containers/(id)/rename`
+`POST /containers/(id or name)/rename`
Rename the container `id` to a `new_name`
@@ -950,7 +950,7 @@
### Pause a container
-`POST /containers/(id)/pause`
+`POST /containers/(id or name)/pause`
Pause the container `id`
@@ -970,7 +970,7 @@
### Unpause a container
-`POST /containers/(id)/unpause`
+`POST /containers/(id or name)/unpause`
Unpause the container `id`
@@ -990,7 +990,7 @@
### Attach to a container
-`POST /containers/(id)/attach`
+`POST /containers/(id or name)/attach`
Attach to the container `id`
@@ -1073,7 +1073,7 @@
### Attach to a container (websocket)
-`GET /containers/(id)/attach/ws`
+`GET /containers/(id or name)/attach/ws`
Attach to the container `id` via websocket
@@ -1108,7 +1108,7 @@
### Wait a container
-`POST /containers/(id)/wait`
+`POST /containers/(id or name)/wait`
Block until container `id` stops, then returns the exit code
@@ -1131,7 +1131,7 @@
### Remove a container
-`DELETE /containers/(id)`
+`DELETE /containers/(id or name)`
Remove the container `id` from the filesystem
@@ -1159,7 +1159,7 @@
### Copy files or folders from a container
-`POST /containers/(id)/copy`
+`POST /containers/(id or name)/copy`
Copy files or folders of container `id`
@@ -1189,14 +1189,14 @@
### Retrieving information about files and folders in a container
-`HEAD /containers/(id)/archive`
+`HEAD /containers/(id or name)/archive`
See the description of the `X-Docker-Container-Path-Stat` header in the
following section.
### Get an archive of a filesystem resource in a container
-`GET /containers/(id)/archive`
+`GET /containers/(id or name)/archive`
Get an tar archive of a resource in the filesystem of container `id`.
@@ -1257,7 +1257,7 @@
### Extract an archive of files or folders to a directory in a container
-`PUT /containers/(id)/archive`
+`PUT /containers/(id or name)/archive`
Upload a tar archive to be extracted to a path in the filesystem of container
`id`.
@@ -2232,7 +2232,7 @@
### Exec Create
-`POST /containers/(id)/exec`
+`POST /containers/(id or name)/exec`
Sets up an exec instance in a running container `id`
@@ -2314,7 +2314,7 @@
- **409** - container is paused
**Stream details**:
- Similar to the stream behavior of `POST /container/(id)/attach` API
+ Similar to the stream behavior of `POST /containers/(id or name)/attach` API
### Exec Resize
diff --git a/docs/reference/api/docker_remote_api_v1.22.md b/docs/reference/api/docker_remote_api_v1.22.md
index 27b90f3..495f88f 100644
--- a/docs/reference/api/docker_remote_api_v1.22.md
+++ b/docs/reference/api/docker_remote_api_v1.22.md
@@ -3055,7 +3055,7 @@
{
"Container":"3613f73ba0e4",
"EndpointConfig": {
- "test_nw": {
+ "IPAMConfig": {
"IPv4Address":"172.24.56.89",
"IPv6Address":"2001:db8::5689"
}
diff --git a/docs/reference/builder.md b/docs/reference/builder.md
index 751c13e..dbe2e81 100644
--- a/docs/reference/builder.md
+++ b/docs/reference/builder.md
@@ -950,6 +950,29 @@
user 0m 0.04s
sys 0m 0.03s
+### Understand how CMD and ENTRYPOINT interact
+
+Both `CMD` and `ENTRYPOINT` instructions define what command gets executed when running a container.
+There are few rules that describe their co-operation.
+
+1. Dockerfile should specify at least one of `CMD` or `ENTRYPOINT` commands.
+
+2. `ENTRYPOINT` should be defined when using the container as an executable.
+
+3. `CMD` should be used as a way of defining default arguments for an `ENTRYPOINT` command
+or for executing an ad-hoc command in a container.
+
+4. `CMD` will be overridden when running the container with alternative arguments.
+
+The table below shows what command is executed for different `ENTRYPOINT` / `CMD` combinations:
+
+| | No ENTRYPOINT | ENTRYPOINT exec_entry p1_entry | ENTRYPOINT ["exec_entry", "p1_entry"] |
+|--------------------------------|----------------------------|-----------------------------------------------------------|------------------------------------------------|
+| **No CMD** | *error, not allowed* | /bin/sh -c exec_entry p1_entry | exec_entry p1_entry |
+| **CMD ["exec_cmd", "p1_cmd"]** | exec_cmd p1_cmd | /bin/sh -c exec_entry p1_entry exec_cmd p1_cmd | exec_entry p1_entry exec_cmd p1_cmd |
+| **CMD ["p1_cmd", "p2_cmd"]** | p1_cmd p2_cmd | /bin/sh -c exec_entry p1_entry p1_cmd p2_cmd | exec_entry p1_entry p1_cmd p2_cmd |
+| **CMD exec_cmd p1_cmd** | /bin/sh -c exec_cmd p1_cmd | /bin/sh -c exec_entry p1_entry /bin/sh -c exec_cmd p1_cmd | exec_entry p1_entry /bin/sh -c exec_cmd p1_cmd |
+
## VOLUME
VOLUME ["/data"]
diff --git a/docs/reference/commandline/daemon.md b/docs/reference/commandline/daemon.md
index df82399..4dbec52 100644
--- a/docs/reference/commandline/daemon.md
+++ b/docs/reference/commandline/daemon.md
@@ -695,11 +695,17 @@
provided does not exist as entries in `/etc/passwd` or `/etc/group`, daemon
startup will fail with an error message.
+> **Note:** On Fedora 22, you have to `touch` the `/etc/subuid` and `/etc/subgid`
+> files to have ranges assigned when users are created. This must be done
+> *before* the `--userns-remap` option is enabled. Once these files exist, the
+> daemon can be (re)started and range assignment on user creation works properly.
+
*Example: starting with default Docker user management:*
+```bash
+$ docker daemon --userns-remap=default
```
- $ docker daemon --userns-remap=default
-```
+
When `default` is provided, Docker will create - or find the existing - user and group
named `dockremap`. If the user is created, and the Linux distribution has
appropriate support, the `/etc/subuid` and `/etc/subgid` files will be populated
@@ -708,16 +714,11 @@
create the following range, based on an existing user named `user1` already owning
the first 65536 range:
+```bash
+$ cat /etc/subuid
+user1:100000:65536
+dockremap:165536:65536
```
- $ cat /etc/subuid
- user1:100000:65536
- dockremap:165536:65536
-```
-
-> **Note:** On a fresh Fedora install, we had to `touch` the
-> `/etc/subuid` and `/etc/subgid` files to have ranges assigned when users
-> were created. Once these files existed, range assignment on user creation
-> worked properly.
If you have a preferred/self-managed user with subordinate ID mappings already
configured, you can provide that username or uid to the `--userns-remap` flag.
diff --git a/docs/security/seccomp.md b/docs/security/seccomp.md
index dbaf4d1..c9346b5 100644
--- a/docs/security/seccomp.md
+++ b/docs/security/seccomp.md
@@ -28,38 +28,30 @@
## Passing a profile for a container
The default seccomp profile provides a sane default for running containers with
-seccomp. It is moderately protective while providing wide application
-compatibility. The default Docker profile has layout in the following form:
+seccomp and disables around 44 system calls out of 300+. It is moderately protective while providing wide application
+compatibility. The default Docker profile (found [here](https://github.com/docker/docker/blob/master/profiles/seccomp/default.json) has a JSON layout in the following form:
```
{
- "defaultAction": "SCMP_ACT_ALLOW",
- "syscalls": [
- {
- "name": "getcwd",
- "action": "SCMP_ACT_ERRNO"
- },
- {
- "name": "mount",
- "action": "SCMP_ACT_ERRNO"
- },
- {
- "name": "setns",
- "action": "SCMP_ACT_ERRNO"
- },
- {
- "name": "create_module",
- "action": "SCMP_ACT_ERRNO"
- },
- {
- "name": "chown",
- "action": "SCMP_ACT_ERRNO"
- },
- {
- "name": "chmod",
- "action": "SCMP_ACT_ERRNO"
- }
- ]
+ "defaultAction": "SCMP_ACT_ERRNO",
+ "architectures": [
+ "SCMP_ARCH_X86_64",
+ "SCMP_ARCH_X86",
+ "SCMP_ARCH_X32"
+ ],
+ "syscalls": [
+ {
+ "name": "accept",
+ "action": "SCMP_ACT_ALLOW",
+ "args": []
+ },
+ {
+ "name": "accept4",
+ "action": "SCMP_ACT_ALLOW",
+ "args": []
+ }
+ ...
+ ]
}
```
@@ -71,7 +63,7 @@
$ docker run --rm -it --security-opt seccomp:/path/to/seccomp/profile.json hello-world
```
-### Syscalls blocked by the default profile
+### Significant syscalls blocked by the default profile
Docker's default seccomp profile is a whitelist which specifies the calls that
are allowed. The table below lists the significant (but not all) syscalls that
diff --git a/docs/userguide/networking/configure-dns.md b/docs/userguide/networking/configure-dns.md
index f588ab0..d248f42 100644
--- a/docs/userguide/networking/configure-dns.md
+++ b/docs/userguide/networking/configure-dns.md
@@ -75,7 +75,7 @@
of the container identified by <code>CONTAINER_NAME</code>. When using <code>--link</code>
the embedded DNS will guarantee that localized lookup result only on that
container where the <code>--link</code> is used. This lets processes inside the new container
- connect to container without without having to know its name or IP.
+ connect to container without having to know its name or IP.
</p>
</td>
</tr>
diff --git a/docs/userguide/networking/get-started-overlay.md b/docs/userguide/networking/get-started-overlay.md
index 4854fe6..89d5b2c 100644
--- a/docs/userguide/networking/get-started-overlay.md
+++ b/docs/userguide/networking/get-started-overlay.md
@@ -55,21 +55,20 @@
instance using the [consul image from Docker
Hub](https://hub.docker.com/r/progrium/consul/). You'll do this in the next step.
-3. Start a `progrium/consul` container running on the `mh-keystore` machine.
+3. Set your local environment to the `mh-keystore` machine.
- $ docker $(docker-machine config mh-keystore) run -d \
+ $ eval "$(docker-machine env mh-keystore)"
+
+4. Start a `progrium/consul` container running on the `mh-keystore` machine.
+
+ $ docker run -d \
-p "8500:8500" \
-h "consul" \
progrium/consul -server -bootstrap
- A bash expansion `$(docker-machine config mh-keystore)` is used to pass the
- connection configuration to the `docker run` command. The client starts a
- `progrium/consul` image running in the `mh-keystore` machine. The server is
- called `consul` and is listening on port `8500`.
-
-4. Set your local environment to the `mh-keystore` machine.
-
- $ eval "$(docker-machine env mh-keystore)"
+ The client starts a `progrium/consul` image running in the
+ `mh-keystore` machine. The server is called `consul` and is
+ listening on port `8500`.
5. Run the `docker ps` command to see the `consul` container.
diff --git a/docs/userguide/storagedriver/aufs-driver.md b/docs/userguide/storagedriver/aufs-driver.md
index 76271cf..4651e66 100644
--- a/docs/userguide/storagedriver/aufs-driver.md
+++ b/docs/userguide/storagedriver/aufs-driver.md
@@ -148,7 +148,7 @@
it in the stack
The command below shows the contents of a metadata file in
-`/var/lib/docker/aufs/layers/` that lists the the three directories that are
+`/var/lib/docker/aufs/layers/` that lists the three directories that are
stacked below it in the union mount. Remember, these directory names do no map
to image layer IDs with Docker 1.10 and higher.
diff --git a/docs/userguide/storagedriver/zfs-driver.md b/docs/userguide/storagedriver/zfs-driver.md
index 3ecbb30..e55e739 100644
--- a/docs/userguide/storagedriver/zfs-driver.md
+++ b/docs/userguide/storagedriver/zfs-driver.md
@@ -133,11 +133,11 @@
1. If it is running, stop the Docker `daemon`.
-1. Install `the software-properties-common` package.
+1. Install the `software-properties-common` package.
This is required for the `add-apt-repository` command.
- $ sudo apt-get install software-properties-common
+ $ sudo apt-get install -y software-properties-common
Reading package lists... Done
Building dependency tree
<output truncated>
