Repository: mesos Updated Branches: refs/heads/master 2b427c788 -> bf3c96743
Renamed containerizer.md. 'containerizers.md' makes it more clear it's an overview doc. Project: http://git-wip-us.apache.org/repos/asf/mesos/repo Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/bf3c9674 Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/bf3c9674 Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/bf3c9674 Branch: refs/heads/master Commit: bf3c967430e06251f66eebb86e8413f85f4560fd Parents: 2b427c7 Author: Jiang Yan Xu <[email protected]> Authored: Sun Apr 30 22:46:34 2017 -0700 Committer: Jiang Yan Xu <[email protected]> Committed: Mon May 1 13:59:20 2017 -0700 ---------------------------------------------------------------------- docs/containerizer.md | 94 --------------------------------------------- docs/containerizers.md | 94 +++++++++++++++++++++++++++++++++++++++++++++ docs/home.md | 2 +- 3 files changed, 95 insertions(+), 95 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/mesos/blob/bf3c9674/docs/containerizer.md ---------------------------------------------------------------------- diff --git a/docs/containerizer.md b/docs/containerizer.md deleted file mode 100644 index b6cf55b..0000000 --- a/docs/containerizer.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: Apache Mesos - Containerizer -layout: documentation ---- - -# Containerizer - -## Motivation - -Containerizers are used to run tasks in 'containers', which in turn are -used to: - -* Isolate a task from other running tasks. -* 'Contain' tasks to run in limited resource runtime environment. -* Control a task's resource usage (e.g., CPU, memory) programatically. -* Run software in a pre-packaged file system image, allowing it to run in - different environments. - - -## Types of containerizers - -Mesos plays well with existing container technologies (e.g., docker) and also -provides its own container technology. It also supports composing different -container technologies (e.g., docker and mesos). - -Mesos implements the following containerizers: - -* [Composing](#Composing) -* [Docker](#Docker) -* [Mesos (default)](#Mesos) - -User can specify the types of containerizers to use via the agent flag -`--containerizers`. - - -<a name="Composing"></a> -### Composing containerizer - -This feature allows multiple container technologies to play together. It is -enabled when you configure the `--containerizers` agent flag with multiple comma -seperated containerizer names (e.g., `--containerizers=mesos,docker`). The order -of the comma separated list is important as the first containerizer that -supports the task's container configuration will be used to launch the task. - -Use cases: - -* For testing tasks with different types of resource isolations. Since 'mesos' - containerizers have more isolation abilities, a framework can use composing - containerizer to test a task using 'mesos' containerizer's controlled - environment and at the same time test it to work with 'docker' containers by - just changing the container parameters for the task. - - -<a name="Docker"></a> -### Docker containerizer - -Docker containerizer allows tasks to be run inside docker container. This -containerizer is enabled when you configure the agent flag as -`--containerizers=docker`. - -Use cases: - -* If a task needs to be run with the tooling that comes with the docker package. -* If Mesos agent is running inside a docker container. - -For more details, see -[Docker Containerizer](docker-containerizer.md). - -<a name="Mesos"></a> -### Mesos containerizer - -This containerizer allows tasks to be run with an array of pluggable isolators -provided by Mesos. This is the native Mesos containerizer solution and is -enabled when you configure the agent flag as `--containerizers=mesos`. - -Use cases: - -* Allow Mesos to control the task's runtime environment without depending on - other container technologies (e.g., docker). -* Want fine grained operating system controls (e.g., cgroups/namespaces provided - by Linux). -* Want Mesos's latest container technology features. -* Need additional resource controls like disk usage limits, which - might not be provided by other container technologies. -* Want to add custom isolation for tasks. - -For more details, see -[Mesos Containerizer](mesos-containerizer.md). - - -## References - -* [Containerizer Internals](containerizer-internals.md) for - implementation details of containerizers. http://git-wip-us.apache.org/repos/asf/mesos/blob/bf3c9674/docs/containerizers.md ---------------------------------------------------------------------- diff --git a/docs/containerizers.md b/docs/containerizers.md new file mode 100644 index 0000000..ea1ef8a --- /dev/null +++ b/docs/containerizers.md @@ -0,0 +1,94 @@ +--- +title: Apache Mesos - Containerizers +layout: documentation +--- + +# Containerizers + +## Motivation + +Containerizers are used to run tasks in 'containers', which in turn are +used to: + +* Isolate a task from other running tasks. +* 'Contain' tasks to run in limited resource runtime environment. +* Control a task's resource usage (e.g., CPU, memory) programatically. +* Run software in a pre-packaged file system image, allowing it to run in + different environments. + + +## Types of containerizers + +Mesos plays well with existing container technologies (e.g., docker) and also +provides its own container technology. It also supports composing different +container technologies (e.g., docker and mesos). + +Mesos implements the following containerizers: + +* [Composing](#Composing) +* [Docker](#Docker) +* [Mesos (default)](#Mesos) + +User can specify the types of containerizers to use via the agent flag +`--containerizers`. + + +<a name="Composing"></a> +### Composing containerizer + +This feature allows multiple container technologies to play together. It is +enabled when you configure the `--containerizers` agent flag with multiple comma +seperated containerizer names (e.g., `--containerizers=mesos,docker`). The order +of the comma separated list is important as the first containerizer that +supports the task's container configuration will be used to launch the task. + +Use cases: + +* For testing tasks with different types of resource isolations. Since 'mesos' + containerizers have more isolation abilities, a framework can use composing + containerizer to test a task using 'mesos' containerizer's controlled + environment and at the same time test it to work with 'docker' containers by + just changing the container parameters for the task. + + +<a name="Docker"></a> +### Docker containerizer + +Docker containerizer allows tasks to be run inside docker container. This +containerizer is enabled when you configure the agent flag as +`--containerizers=docker`. + +Use cases: + +* If a task needs to be run with the tooling that comes with the docker package. +* If Mesos agent is running inside a docker container. + +For more details, see +[Docker Containerizer](docker-containerizer.md). + +<a name="Mesos"></a> +### Mesos containerizer + +This containerizer allows tasks to be run with an array of pluggable isolators +provided by Mesos. This is the native Mesos containerizer solution and is +enabled when you configure the agent flag as `--containerizers=mesos`. + +Use cases: + +* Allow Mesos to control the task's runtime environment without depending on + other container technologies (e.g., docker). +* Want fine grained operating system controls (e.g., cgroups/namespaces provided + by Linux). +* Want Mesos's latest container technology features. +* Need additional resource controls like disk usage limits, which + might not be provided by other container technologies. +* Want to add custom isolation for tasks. + +For more details, see +[Mesos Containerizer](mesos-containerizer.md). + + +## References + +* [Containerizer Internals](containerizer-internals.md) for + implementation details of containerizers. http://git-wip-us.apache.org/repos/asf/mesos/blob/bf3c9674/docs/home.md ---------------------------------------------------------------------- diff --git a/docs/home.md b/docs/home.md index 40061ea..7368031 100644 --- a/docs/home.md +++ b/docs/home.md @@ -20,7 +20,7 @@ layout: documentation * [Authorization](authorization.md) * [Configuration](configuration.md) and [CMake configuration](configuration-cmake.md) for command-line arguments. * [Container Image](container-image.md) for supporting container images in Mesos containerizer. -* [Containerizer](containerizer.md) for containerizer overview and use cases. +* [Containerizers](containerizers.md) for containerizer overview and use cases. * [Containerizer Internals](containerizer-internals.md) for implementation details of containerizers. * [Docker Containerizer](docker-containerizer.md) for launching a Docker image as a Task, or as an Executor. * [Mesos Containerizer](mesos-containerizer.md) default containerizer, supports both Linux and POSIX systems.
