whentimeslows/website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add documentation about private mount propagation (#8106)

Browse Source 
* Trivial change to open release branch

* Undo trivial change

* Add documentation about private mount propagation
This commit is contained in:
Jan Šafránek
2018-04-26 21:23:26 +02:00
committed by k8s-ci-robot
parent c7ab858d7e
commit d623f631fd
1 changed files with 14 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/concepts/storage/volumes.md
+14 -6
View File
@@ -1076,16 +1076,24 @@ More details can be found [here](https://github.com/kubernetes/community/blob/ma
Mount propagation allows for sharing volumes mounted by a Container to Mount propagation allows for sharing volumes mounted by a Container to
other Containers in the same Pod, or even to other Pods on the same node. other Containers in the same Pod, or even to other Pods on the same node.
If the "`MountPropagation`" feature is disabled, volume mounts in pods are not propagated. If the "`MountPropagation`" feature is disabled or a Pod does not explicitly
That is, Containers run with `private` mount propagation as described in the specify specific mount propagation, volume mounts in the Pod's Containers are
[Linux kernel documentation](https://www.kernel.org/doc/Documentation/filesystems/sharedsubtree.txt). not propagated. That is, Containers run with `private` mount propagation as
described in the [Linux kernel documentation](https://www.kernel.org/doc/Documentation/filesystems/sharedsubtree.txt).
Mount propagation of a volume is controlled by `mountPropagation` field in Container.volumeMounts. Mount propagation of a volume is controlled by `mountPropagation` field in Container.volumeMounts.
Its values are: Its values are:
* `None` - This volume mount will not receive any subsequent mounts
that are mounted to this volume or any of its subdirectories by the host.
In similar fashion, no mounts created by the Container will be visible on
the host. This is the default mode.
This mode is equal to `private` mount propagation as described in the
[Linux kernel documentation](https://www.kernel.org/doc/Documentation/filesystems/sharedsubtree.txt)
* `HostToContainer` - This volume mount will receive all subsequent mounts * `HostToContainer` - This volume mount will receive all subsequent mounts
that are mounted to this volume or any of its subdirectories. This is that are mounted to this volume or any of its subdirectories.
the default mode.
In other words, if the host mounts anything inside the volume mount, the In other words, if the host mounts anything inside the volume mount, the
Container will see it mounted there. Container will see it mounted there.
@@ -1101,7 +1109,7 @@ Its values are:
In addition, all volume mounts created by the Container will be propagated In addition, all volume mounts created by the Container will be propagated
back to the host and to all Containers of all Pods that use the same volume. back to the host and to all Containers of all Pods that use the same volume.
A typical use case for this mode is a Pod with a `FlexVolume` driver or A typical use case for this mode is a Pod with a `FlexVolume` or `CSI` driver or
a Pod that needs to mount something on the host using a `hostPath` volume. a Pod that needs to mount something on the host using a `hostPath` volume.
This mode is equal to `rshared` mount propagation as described in the This mode is equal to `rshared` mount propagation as described in the