From 88fa05ccb486dbfd053e51072fc9646a61012b5d Mon Sep 17 00:00:00 2001 From: Brian Goff Date: Tue, 26 Jan 2016 15:53:11 -0500 Subject: [PATCH] Add note about mount propagation on systemd Signed-off-by: Brian Goff --- docs/reference/run.md | 8 ++++++++ man/docker-create.1.md | 8 ++++++++ man/docker-run.1.md | 8 ++++++++ 3 files changed, 24 insertions(+) diff --git a/docs/reference/run.md b/docs/reference/run.md index 537e3aa085..4063d588cb 100644 --- a/docs/reference/run.md +++ b/docs/reference/run.md @@ -1385,6 +1385,14 @@ Similarly the operator can set the **hostname** with `-h`. > **Note**: > The auto-creation of the host path has been [*deprecated*](../misc/deprecated.md#auto-creating-missing-host-paths-for-bind-mounts). +> **Note**: +> When using systemd to manage the Docker daemon's start and stop, in the systemd +> unit file there is an option to control mount propagation for the Docker daemon +> itself, called `MountFlags`. The value of this setting may cause Docker to not +> see mount propagation changes made on the mount point. For example, if this value +> is `slave`, you may not be able to use the `shared` or `rshared` propagation on +> a volume. + The volumes commands are complex enough to have their own documentation in section [*Managing data in containers*](../userguide/dockervolumes.md). A developer can define diff --git a/man/docker-create.1.md b/man/docker-create.1.md index 08074ac431..e92e36c24b 100644 --- a/man/docker-create.1.md +++ b/man/docker-create.1.md @@ -411,6 +411,14 @@ will convert /foo into a `shared` mount point. Alternatively one can directly change propagation properties of source mount. Say `/` is source mount for `/foo`, then use `mount --make-shared /` to convert `/` into a `shared` mount. +> **Note**: +> When using systemd to manage the Docker daemon's start and stop, in the systemd +> unit file there is an option to control mount propagation for the Docker daemon +> itself, called `MountFlags`. The value of this setting may cause Docker to not +> see mount propagation changes made on the mount point. For example, if this value +> is `slave`, you may not be able to use the `shared` or `rshared` propagation on +> a volume. + **--volume-driver**="" Container's volume driver. This driver creates volumes specified either from a Dockerfile's `VOLUME` instruction or from the `docker run -v` flag. diff --git a/man/docker-run.1.md b/man/docker-run.1.md index ea9b0b8168..f1de10e273 100644 --- a/man/docker-run.1.md +++ b/man/docker-run.1.md @@ -582,6 +582,14 @@ will convert /foo into a `shared` mount point. Alternatively one can directly change propagation properties of source mount. Say `/` is source mount for `/foo`, then use `mount --make-shared /` to convert `/` into a `shared` mount. +> **Note**: +> When using systemd to manage the Docker daemon's start and stop, in the systemd +> unit file there is an option to control mount propagation for the Docker daemon +> itself, called `MountFlags`. The value of this setting may cause Docker to not +> see mount propagation changes made on the mount point. For example, if this value +> is `slave`, you may not be able to use the `shared` or `rshared` propagation on +> a volume. + **--volume-driver**="" Container's volume driver. This driver creates volumes specified either from a Dockerfile's `VOLUME` instruction or from the `docker run -v` flag.