You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by bm...@apache.org on 2016/04/25 23:15:19 UTC
[03/24] mesos git commit: Added document for overlayfs backend.
Added document for overlayfs backend.
Review: https://reviews.apache.org/r/44391/
Project: http://git-wip-us.apache.org/repos/asf/mesos/repo
Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/b709724f
Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/b709724f
Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/b709724f
Branch: refs/heads/0.28.x
Commit: b709724f248fdcae8f746eb2d644be63c20b2ec4
Parents: bf3cf92
Author: Guangya Liu <gy...@gmail.com>
Authored: Thu Mar 10 15:45:51 2016 -0800
Committer: Vinod Kone <vi...@gmail.com>
Committed: Fri Mar 11 13:44:40 2016 -0500
----------------------------------------------------------------------
docs/container-image.md | 23 ++++++++++++++++++++++-
1 file changed, 22 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/mesos/blob/b709724f/docs/container-image.md
----------------------------------------------------------------------
diff --git a/docs/container-image.md b/docs/container-image.md
index 0cab13a..db4b291 100644
--- a/docs/container-image.md
+++ b/docs/container-image.md
@@ -285,7 +285,28 @@ agent flag `--sandbox_directory` properly).
### Overlay
-TODO(jieyu): Add documentation for overlay here.
+The reson overlay backend was introduced is because the copy backend
+will waste IO and space while the bind backend can only deal with one
+layer. The overlay backend allows containizer to utilize the
+filesystem to merge multiple filesystems into one efficiently.
+
+As the overlay backend request multiple lower layers support, the
+version of linux kernel should be greater than 4.0, refer
+[here](https://github.com/manjaro/manjaro-tools-iso-profiles/issues/40)
+for more detail.
+
+For more information of overlayfs, please refer to
+[here](https://www.kernel.org/doc/Documentation/filesystems/overlayfs.txt).
+
+The overlay backend currently has these two limitations:
+
+1. The overlay backend only supports more than one single layer. One
+single layer images will fail to provision and the container will fail
+to launch! This limitation will be solved soon.
+
+2. Similar to the bind backend, the filesystem will be read-only.
+Please refer to the second limitation of the bind backend for more
+details. We will resolve this limitation soon.
## Executor Dependencies in a Container Image