[2/2] mesos git commit: Documented provisioner auto backend semantic.

[ji...@apache.org]

Documented provisioner auto backend semantic.

Review: https://reviews.apache.org/r/56904/


Project: http://git-wip-us.apache.org/repos/asf/mesos/repo
Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/cffa3b56
Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/cffa3b56
Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/cffa3b56

Branch: refs/heads/1.2.x
Commit: cffa3b5670888a0cc9e96524528dab82575b92ad
Parents: b411da4
Author: Gilbert Song <so...@gmail.com>
Authored: Thu Feb 23 17:31:42 2017 -0800
Committer: Jie Yu <yu...@gmail.com>
Committed: Thu Feb 23 17:41:17 2017 -0800

----------------------------------------------------------------------
 docs/container-image.md | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mesos/blob/cffa3b56/docs/container-image.md
----------------------------------------------------------------------
diff --git a/docs/container-image.md b/docs/container-image.md
index 6740ce1..11e8a62 100644
--- a/docs/container-image.md
+++ b/docs/container-image.md
@@ -285,8 +285,29 @@ is `/tmp/mesos/store/appc`.
 ## Provisioner Backends
 
 A provisioner backend takes a set of filesystem layers and stacks them
-into a root filesystem. The following backends are supported
-currently.
+into a root filesystem. Currently, we support the following backends:
+copy`, `bind`, `overlay` and `aufs`. Mesos will validate if the
+selected backend works with the underlying filesystem (the filesystem
+used by the image store `--docker_store_dir` or `--appc_store_dir`)
+using the following logic table:
+
+    +---------+--------------+------------------------------------------+
+    | Backend | Suggested on | Disabled on                              |
+    +---------+--------------+------------------------------------------+
+    | aufs    | ext4 xfs     | btrfs aufs eCryptfs                      |
+    | overlay | ext4 xfs     | btrfs aufs overlay overlay2 zfs eCryptfs |
+    | bind    |              | N/A(`--sandbox_directory' must exist)    |
+    | copy    |              | N/A                                      |
+    +---------+--------------+------------------------------------------+
+
+The provisioner backend can be specified through the agent flag
+`--provisioner_image_backend`. If not set, Mesos will select the best
+backend automatically for the users/operators. The selection logic is
+as following:
+
+    1. Use `overlay` backend if the overlayfs is available.
+    2. Use `aufs` backend if the aufs is available and overlayfs is not supported.
+    3. Use `copy` backend if none of above is selected.
 
 ### Copy