You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by gi...@apache.org on 2017/10/13 01:42:03 UTC

mesos-site git commit: Updated the website built from mesos SHA: 81704bd.

Repository: mesos-site
Updated Branches:
  refs/heads/asf-site de6b76737 -> 6f0157a14


Updated the website built from mesos SHA: 81704bd.


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

Branch: refs/heads/asf-site
Commit: 6f0157a14c0c4e1bf3f6cdd4e8e54e135e2fc592
Parents: de6b767
Author: jenkins <bu...@apache.org>
Authored: Fri Oct 13 01:42:01 2017 +0000
Committer: jenkins <bu...@apache.org>
Committed: Fri Oct 13 01:42:01 2017 +0000

----------------------------------------------------------------------
 .../containerizer-internals/index.html          |  60 +++-
 .../latest/containerizer-internals/index.html   |  60 +++-
 .../latest/isolators/cgroups-blkio/index.html   | 333 +++++++++++++++++++
 .../latest/mesos-containerizer/index.html       |   2 +-
 .../mesos-containerizer/index.html              |   2 +-
 content/sitemap.xml                             |   4 +
 6 files changed, 451 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6f0157a1/content/documentation/containerizer-internals/index.html
----------------------------------------------------------------------
diff --git a/content/documentation/containerizer-internals/index.html b/content/documentation/containerizer-internals/index.html
index c64843d..b2ca93b 100644
--- a/content/documentation/containerizer-internals/index.html
+++ b/content/documentation/containerizer-internals/index.html
@@ -248,15 +248,67 @@ character to the write end of the pipe in the parent process.</li>
 </ul>
 
 
+<p>Starting from Mesos 1.1.0, <a href="/documentation/latest/./nested-container-and-task-group/">nested container</a>
+is supported. The Linux Launcher is responsible to fork the subprocess
+for the nested container with appropriate Linux namespaces being
+cloned. The following is the table for Linux namespaces that
+are supported for top level and nested containers.</p>
+
+<h6>Linux Namespaces</h6>
+
+<table class="table table-striped">
+  <tr>
+    <th>Linux Namespaces</th>
+    <th>Top Level Container</th>
+    <th>Nested Container</th>
+  </tr>
+  <tr>
+    <td>Mount</td>
+    <td>Not shared</td>
+    <td>Not shared</td>
+  </tr>
+  <tr>
+    <td>PID</td>
+    <td>Configurable</td>
+    <td>Configurable</td>
+  </tr>
+  <tr>
+    <td>Network & UTS</td>
+    <td>Configurable</td>
+    <td>Shared w/ parent</td>
+  </tr>
+  <tr>
+    <td>IPC</td>
+    <td>Not shared -> configurable (TBD)</td>
+    <td>Not shared -> configurable (TBD)</td>
+  </tr>
+  <tr>
+    <td>Cgroup</td>
+    <td>Shared w/ agent -> Not shared (TBD)</td>
+    <td>Shared w/ parent -> Not shared (TBD)</td>
+  </tr>
+  <tr>
+    <td>User (not supported)</td>
+    <td>Shared w/ agent</td>
+    <td>Shared w/ parent</td>
+  </tr>
+</table>
+
+
+<p>*Note: For the top level container, <code>shared</code> means that the container
+shares the namespace from the agent. For the nested container, <code>shared</code>
+means that the nested container shares the namespace from its parent
+container.</p>
+
 <h6>Posix launcher (TBD)</h6>
 
 <p><a name="Isolators"></a></p>
 
-<h5>Isolators</h5>
+<h5><a href="/documentation/latest/./mesos-containerizer/#isolators">Isolators</a></h5>
 
-<p>Isolators are responsible for creating an environment for the
-containers where resources like cpu, network, storage and memory can
-be isolated from other containers.</p>
+<p><a href="/documentation/latest/./mesos-containerizer/#isolators">Isolators</a> are responsible for creating
+an environment for the containers where resources like cpu, network,
+storage and memory can be isolated from other containers.</p>
 
 <h3>Containerizer states</h3>
 

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6f0157a1/content/documentation/latest/containerizer-internals/index.html
----------------------------------------------------------------------
diff --git a/content/documentation/latest/containerizer-internals/index.html b/content/documentation/latest/containerizer-internals/index.html
index 84cb1a6..192e551 100644
--- a/content/documentation/latest/containerizer-internals/index.html
+++ b/content/documentation/latest/containerizer-internals/index.html
@@ -248,15 +248,67 @@ character to the write end of the pipe in the parent process.</li>
 </ul>
 
 
+<p>Starting from Mesos 1.1.0, <a href="/documentation/latest/./nested-container-and-task-group/">nested container</a>
+is supported. The Linux Launcher is responsible to fork the subprocess
+for the nested container with appropriate Linux namespaces being
+cloned. The following is the table for Linux namespaces that
+are supported for top level and nested containers.</p>
+
+<h6>Linux Namespaces</h6>
+
+<table class="table table-striped">
+  <tr>
+    <th>Linux Namespaces</th>
+    <th>Top Level Container</th>
+    <th>Nested Container</th>
+  </tr>
+  <tr>
+    <td>Mount</td>
+    <td>Not shared</td>
+    <td>Not shared</td>
+  </tr>
+  <tr>
+    <td>PID</td>
+    <td>Configurable</td>
+    <td>Configurable</td>
+  </tr>
+  <tr>
+    <td>Network & UTS</td>
+    <td>Configurable</td>
+    <td>Shared w/ parent</td>
+  </tr>
+  <tr>
+    <td>IPC</td>
+    <td>Not shared -> configurable (TBD)</td>
+    <td>Not shared -> configurable (TBD)</td>
+  </tr>
+  <tr>
+    <td>Cgroup</td>
+    <td>Shared w/ agent -> Not shared (TBD)</td>
+    <td>Shared w/ parent -> Not shared (TBD)</td>
+  </tr>
+  <tr>
+    <td>User (not supported)</td>
+    <td>Shared w/ agent</td>
+    <td>Shared w/ parent</td>
+  </tr>
+</table>
+
+
+<p>*Note: For the top level container, <code>shared</code> means that the container
+shares the namespace from the agent. For the nested container, <code>shared</code>
+means that the nested container shares the namespace from its parent
+container.</p>
+
 <h6>Posix launcher (TBD)</h6>
 
 <p><a name="Isolators"></a></p>
 
-<h5>Isolators</h5>
+<h5><a href="/documentation/latest/./mesos-containerizer/#isolators">Isolators</a></h5>
 
-<p>Isolators are responsible for creating an environment for the
-containers where resources like cpu, network, storage and memory can
-be isolated from other containers.</p>
+<p><a href="/documentation/latest/./mesos-containerizer/#isolators">Isolators</a> are responsible for creating
+an environment for the containers where resources like cpu, network,
+storage and memory can be isolated from other containers.</p>
 
 <h3>Containerizer states</h3>
 

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6f0157a1/content/documentation/latest/isolators/cgroups-blkio/index.html
----------------------------------------------------------------------
diff --git a/content/documentation/latest/isolators/cgroups-blkio/index.html b/content/documentation/latest/isolators/cgroups-blkio/index.html
new file mode 100644
index 0000000..a875f5e
--- /dev/null
+++ b/content/documentation/latest/isolators/cgroups-blkio/index.html
@@ -0,0 +1,333 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <title>Apache Mesos - Cgroups 'blkio' Subsystem Support in Mesos Containerizer</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+    <meta property="og:locale" content="en_US"/>
+    <meta property="og:type" content="website"/>
+    <meta property="og:title" content="Apache Mesos"/>
+    <meta property="og:site_name" content="Apache Mesos"/>
+    <meta property="og:url" content="http://mesos.apache.org/"/>
+    <meta property="og:image" content="http://mesos.apache.org/assets/img/mesos_logo_fb_preview.png"/>
+    <meta property="og:description"
+          content="Apache Mesos abstracts resources away from machines,
+                   enabling fault-tolerant and elastic distributed systems
+                   to easily be built and run effectively."/>
+
+    <meta name="twitter:card" content="summary"/>
+    <meta name="twitter:site" content="@ApacheMesos"/>
+    <meta name="twitter:title" content="Apache Mesos"/>
+    <meta name="twitter:image" content="http://mesos.apache.org/assets/img/mesos_logo_fb_preview.png"/>
+    <meta name="twitter:description"
+          content="Apache Mesos abstracts resources away from machines,
+                   enabling fault-tolerant and elastic distributed systems
+                   to easily be built and run effectively."/>
+
+    <link href="//netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css" rel="stylesheet">
+    <link rel="alternate" type="application/atom+xml" title="Apache Mesos Blog" href="/blog/feed.xml">
+    <link href="../../../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+    
+
+    <!-- Google Analytics Magic -->
+    <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-20226872-1']);
+    _gaq.push(['_setDomainName', 'apache.org']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+    </script>
+    
+  </head>
+  <body>
+    <!-- magical breadcrumbs -->
+    <div class="topnav">
+      <div class="container">
+        <ul class="breadcrumb">
+          <li>
+            <div class="dropdown">
+              <a data-toggle="dropdown" href="#">Apache Software Foundation <span class="caret"></span></a>
+              <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
+                <li><a href="http://www.apache.org">Apache Homepage</a></li>
+                <li><a href="http://www.apache.org/licenses/">License</a></li>
+                <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+                <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+                <li><a href="http://www.apache.org/security/">Security</a></li>
+              </ul>
+            </div>
+          </li>
+
+          <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+          
+          
+          <li><a href="/documentation
+/">Documentation
+</a></li>
+          
+          
+        </ul><!-- /.breadcrumb -->
+      </div><!-- /.container -->
+    </div><!-- /.topnav -->
+
+    <!-- navbar excitement -->
+<div class="navbar navbar-default navbar-static-top" role="navigation">
+  <div class="container">
+    <div class="navbar-header">
+      <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#mesos-menu" aria-expanded="false">
+      <span class="sr-only">Toggle navigation</span>
+      <span class="icon-bar"></span>
+      <span class="icon-bar"></span>
+      <span class="icon-bar"></span>
+      </button>
+      <a class="navbar-brand" href="/"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo"/></a>
+    </div><!-- /.navbar-header -->
+
+    <div class="navbar-collapse collapse" id="mesos-menu">
+      <ul class="nav navbar-nav navbar-right">
+        <li><a href="/gettingstarted/">Getting Started</a></li>
+        <li><a href="/blog/">Blog</a></li>
+        <li><a href="/documentation/latest/">Documentation</a></li>
+        <li><a href="/downloads/">Downloads</a></li>
+        <li><a href="/community/">Community</a></li>
+      </ul>
+    </div><!-- /#mesos-menu -->
+  </div><!-- /.container -->
+</div><!-- /.navbar -->
+
+<div class="content">
+  <div class="container">
+    <div class="row-fluid">
+  <div class="col-md-4">
+    <h4>If you're new to Mesos</h4>
+    <p>See the <a href="/gettingstarted/">getting started</a> page for more
+       information about downloading, building, and deploying Mesos.</p>
+
+    <h4>If you'd like to get involved or you're looking for support</h4>
+    <p>See our <a href="/community/">community</a> page for more details.</p>
+  </div>
+  <div class="col-md-8">
+    <h1>Cgroups &lsquo;blkio&rsquo; Subsystem Support in Mesos Containerizer</h1>
+
+<p>The <code>cgroups/blkio</code> isolator provides block I/O performance isolation for
+containers through <a href="https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt">the <em>blkio</em> Linux cgroup subsystem</a>.
+To enable the isolator, append <code>cgroups/blkio</code> to the <code>--isolation</code> flag before
+starting the agent.</p>
+
+<p>The blkio subsystem enables I/O statistics collection and allows operators to
+apply I/O control policies for block devices. The isolator places the processes
+of a Mesos container into a separate blkio cgroup hierarchy. At the moment,
+it only supports reporting containers' I/O statistics on block devices to
+the agent. A sample statistics would be something like:</p>
+
+<pre><code>[{
+    "executor_id": "executor",
+    "executor_name": "name",
+    "framework_id": "framework",
+    "source": "source",
+    "statistics": {
+        "blkio": {
+            "cfq": [
+                {
+                    "io_merged": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_queued": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_service_bytes": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_service_time": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_serviced": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_wait_time": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ]
+                }
+            ],
+            "cfq_recursive": [
+                {
+                    "io_merged": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_queued": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_service_bytes": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_service_time": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_serviced": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ],
+                    "io_wait_time": [
+                        {
+                            "op": "TOTAL",
+                            "value": 0
+                        }
+                    ]
+                }
+            ],
+            "throttling": [
+                {
+                    "device": {
+                        "major": 8,
+                        "minor": 0
+                    },
+                    "io_service_bytes": [
+                        {
+                            "op": "READ",
+                            "value": 0
+                        },
+                        {
+                            "op": "WRITE",
+                            "value": 4096
+                        },
+                        {
+                            "op": "SYNC",
+                            "value": 0
+                        },
+                        {
+                            "op": "ASYNC",
+                            "value": 4096
+                        },
+                        {
+                            "op": "TOTAL",
+                            "value": 4096
+                        }
+                    ],
+                    "io_serviced": [
+                        {
+                            "op": "READ",
+                            "value": 0
+                        },
+                        {
+                            "op": "WRITE",
+                            "value": 1
+                        },
+                        {
+                            "op": "SYNC",
+                            "value": 0
+                        },
+                        {
+                            "op": "ASYNC",
+                            "value": 1
+                        },
+                        {
+                            "op": "TOTAL",
+                            "value": 1
+                        }
+                    ]
+                },
+                {
+                    "io_service_bytes": [
+                        {
+                            "op": "TOTAL",
+                            "value": 4096
+                        }
+                    ],
+                    "io_serviced": [
+                        {
+                            "op": "TOTAL",
+                            "value": 1
+                        }
+                    ]
+                }
+            ]
+        },
+        "cpus_limit": 1.1,
+        "mem_limit_bytes": 167772160,
+        "timestamp": 1500335339.30187
+    }
+}]
+</code></pre>
+
+<p>For more details about the blkio subsystem, please refer to
+the <a href="https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt">Block I/O Controller</a>
+Linux kernel documentation.</p>
+
+  </div>
+</div>
+
+  </div><!-- /.container -->
+</div><!-- /.content -->
+
+<hr>
+
+
+
+    <!-- footer -->
+    <div class="footer">
+      <div class="container">
+        <div class="col-md-4 social-blk">
+          <span class="social">
+            <a href="https://twitter.com/ApacheMesos"
+              class="twitter-follow-button"
+              data-show-count="false" data-size="large">Follow @ApacheMesos</a>
+            <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
+            <a href="https://twitter.com/intent/tweet?button_hashtag=mesos"
+              class="twitter-hashtag-button"
+              data-size="large"
+              data-related="ApacheMesos">Tweet #mesos</a>
+            <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
+          </span>
+        </div>
+
+        <div class="col-md-8 trademark">
+          <p>&copy; 2012-2017 <a href="http://apache.org">The Apache Software Foundation</a>.
+            Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.
+          <p>
+        </div>
+      </div><!-- /.container -->
+    </div><!-- /.footer -->
+
+    <!-- JS -->
+    <script src="//code.jquery.com/jquery-1.11.0.min.js" type="text/javascript"></script>
+    <script src="//netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js" type="text/javascript"></script>
+  </body>
+</html>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6f0157a1/content/documentation/latest/mesos-containerizer/index.html
----------------------------------------------------------------------
diff --git a/content/documentation/latest/mesos-containerizer/index.html b/content/documentation/latest/mesos-containerizer/index.html
index ae0645a..6a51c9b 100644
--- a/content/documentation/latest/mesos-containerizer/index.html
+++ b/content/documentation/latest/mesos-containerizer/index.html
@@ -139,7 +139,7 @@ can write modules that implement custom isolators.</p>
 <ul>
 <li><a href="/documentation/latest/./secrets/#environment-based-secrets">environment_secret</a></li>
 <li>appc/runtime</li>
-<li>cgroups/blkio</li>
+<li><a href="/documentation/latest/./isolators/cgroups-blkio/">cgroups/blkio</a></li>
 <li><a href="/documentation/latest/./isolators/cgroups-cpu/">cgroups/cpu</a></li>
 <li>cgroups/cpuset</li>
 <li>cgroups/devices</li>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6f0157a1/content/documentation/mesos-containerizer/index.html
----------------------------------------------------------------------
diff --git a/content/documentation/mesos-containerizer/index.html b/content/documentation/mesos-containerizer/index.html
index 3ff503a..d41c351 100644
--- a/content/documentation/mesos-containerizer/index.html
+++ b/content/documentation/mesos-containerizer/index.html
@@ -139,7 +139,7 @@ can write modules that implement custom isolators.</p>
 <ul>
 <li><a href="/documentation/latest/./secrets/#environment-based-secrets">environment_secret</a></li>
 <li>appc/runtime</li>
-<li>cgroups/blkio</li>
+<li><a href="/documentation/latest/./isolators/cgroups-blkio/">cgroups/blkio</a></li>
 <li><a href="/documentation/latest/./isolators/cgroups-cpu/">cgroups/cpu</a></li>
 <li>cgroups/cpuset</li>
 <li>cgroups/devices</li>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6f0157a1/content/sitemap.xml
----------------------------------------------------------------------
diff --git a/content/sitemap.xml b/content/sitemap.xml
index 6bf95f5..1717018 100644
--- a/content/sitemap.xml
+++ b/content/sitemap.xml
@@ -16129,6 +16129,10 @@
     <lastmod>2017-10-13T00:00:00+00:00</lastmod>
   </url>
   <url>
+    <loc>http://mesos.apache.org/documentation/latest/isolators/cgroups-blkio/</loc>
+    <lastmod>2017-10-13T00:00:00+00:00</lastmod>
+  </url>
+  <url>
     <loc>http://mesos.apache.org/documentation/latest/isolators/cgroups-cpu/</loc>
     <lastmod>2017-10-13T00:00:00+00:00</lastmod>
   </url>