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 <[email protected]> Authored: Thu Feb 23 17:31:42 2017 -0800 Committer: Jie Yu <[email protected]> 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
