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:07:11 UTC
[2/2] mesos-site git commit: Updated the website built from mesos
SHA: 8186f03.
Updated the website built from mesos SHA: 8186f03.
Project: http://git-wip-us.apache.org/repos/asf/mesos-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/mesos-site/commit/de6b7673
Tree: http://git-wip-us.apache.org/repos/asf/mesos-site/tree/de6b7673
Diff: http://git-wip-us.apache.org/repos/asf/mesos-site/diff/de6b7673
Branch: refs/heads/asf-site
Commit: de6b76737ff3034cb7de6fe5711ef0a733586c10
Parents: 81c9b30
Author: jenkins <bu...@apache.org>
Authored: Fri Oct 13 01:07:08 2017 +0000
Committer: jenkins <bu...@apache.org>
Committed: Fri Oct 13 01:07:08 2017 +0000
----------------------------------------------------------------------
.../latest/isolators/cgroups-cpu/index.html | 261 +
.../latest/mesos-containerizer/index.html | 2 +-
.../mesos-containerizer/index.html | 2 +-
content/sitemap.xml | 8598 +++++++++---------
4 files changed, 4564 insertions(+), 4299 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/de6b7673/content/documentation/latest/isolators/cgroups-cpu/index.html
----------------------------------------------------------------------
diff --git a/content/documentation/latest/isolators/cgroups-cpu/index.html b/content/documentation/latest/isolators/cgroups-cpu/index.html
new file mode 100644
index 0000000..27f89d7
--- /dev/null
+++ b/content/documentation/latest/isolators/cgroups-cpu/index.html
@@ -0,0 +1,261 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title>Apache Mesos - Cgroups 'cpu' 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 ‘cpu’ and ‘cpuacct’ Subsystems Support in Mesos Containerizer</h1>
+
+<p>The <code>cgroups/cpu</code> isolator allows operators to provide CPU isolation
+and CPU usage accounting for containers within a Mesos cluster. To
+enable the <code>cgroups/cpu</code> isolator, append <code>cgroups/cpu</code> to the
+<code>--isolation</code> flag when starting the Mesos agent.</p>
+
+<h2>Subsystems</h2>
+
+<p>The isolator enables <code>cpu</code> and <code>cpuacct</code> subsystems for Linux cgroups
+and assigns <code>cpu</code> and <code>cpuacct</code> cgroups to each container launched by
+Mesos Containerizer.</p>
+
+<p>Cgroups <code>cpu</code> subsystem provides 2 mechanisms of limiting the amount
+of CPU time used by cgroups: <a href="https://github.com/torvalds/linux/blob/master/Documentation/scheduler/sched-design-CFS.txt">CFS shares</a>
+and <a href="https://github.com/torvalds/linux/blob/master/Documentation/scheduler/sched-bwc.txt">CFS bandwidth</a>
+control. The first one can guarantee some minimum number of CPU
+“shares” to a cgroup when the system is under heavy load. It, however,
+does not limit the amount of CPU time available to a cgroup when the
+system is not busy. This mechanism is always enabled when you turn on
+this isolator.</p>
+
+<p>The second mechanism introduces a way to define the upper limit of CPU
+time used by a cgroup within every scheduling period. Additionally it
+exports bandwidth statistics in <code>cpu.stat</code> file. CFS bandwidth
+mechanism can be enabled with <code>--cgroups_enable_cfs</code> agent flag.</p>
+
+<p>Cgroups <code>cpuacct</code> subsystem provides accounting for CPU usage by
+cgroup’s tasks. Currently it only provides statistics in
+<code>cpuacct.stat</code> that show time spent by tasks of the cgroup in user
+mode and kernel mode respectively</p>
+
+<p>Additionally the isolator provides accounting for the number of
+processes and threads inside a container based on the information from
+<code>cgroups.procs</code> and <code>tasks</code> files.</p>
+
+<h2>Effects on application when using CFS Bandwidth Limiting</h2>
+
+<p>CPU usage is monitored during a scheduling period, which is currently
+set to 100ms. A task can use its requested CPU time before that period
+ends. For example, if a task is allocated 1 CPUs, it can use 2 CPU
+cores for 50ms thus consuming 100ms of CPU time, and be throttled for
+the remaining 50ms. Applications that are latency sensitive may suffer
+from effectively being stalled for 50ms.</p>
+
+<h2>Statistics</h2>
+
+<p>This isolator exports several valuable per-container CPU usage metrics
+that are available from agent’s <code>monitor/statistics</code>
+<a href="/documentation/latest/isolators/../endpoints/slave/monitor/statistics/">endpoint</a>.</p>
+
+<ul>
+<li><code>processes</code> - number of processes in the cgroup;</li>
+<li><code>threads</code> - number of threads in the cgroup;</li>
+<li><code>cpus_user_time_secs</code> - time spent by tasks of the cgroup in user
+mode;</li>
+<li><code>cpus_system_time_secs</code> - time spent by tasks of the cgroup in
+kernel mode;</li>
+<li><code>cpus_nr_periods</code> - number of enforcement intervals that have
+elapsed;</li>
+<li><code>cpus_nr_throttled</code> - number of times the cgroup has been
+throttled;</li>
+<li><code>cpus_throttled_time</code> - total time for which tasks in the cgroup
+have been throttled.</li>
+</ul>
+
+
+<h2>Configuration</h2>
+
+<table class="table table-striped">
+ <thead>
+ <tr>
+ <th>Flag</th>
+ <th>Explanation</th>
+ </tr>
+ </thead>
+ <tr>
+ <td>
+ --[no]-cgroups_cpu_enable_pids_and_tids_count
+ </td>
+ <td>
+Cgroups feature flag to enable counting of processes and threads
+inside a container. (default: false)
+ </td>
+ </tr>
+ <tr>
+ <td>
+ --[no]-cgroups_enable_cfs
+ </td>
+ <td>
+Cgroups feature flag to enable hard limits on CPU resources via the
+CFS bandwidth limiting subfeature. (default: false)
+ </td>
+ </tr>
+ <tr>
+ <td>
+ --[no-]revocable_cpu_low_priority
+ </td>
+ <td>
+Run containers with revocable CPU at a lower priority than normal
+containers (non-revocable CPU). (default: true)
+ </td>
+ </tr>
+</table>
+
+
+ </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>© 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/de6b7673/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 51e274c..ae0645a 100644
--- a/content/documentation/latest/mesos-containerizer/index.html
+++ b/content/documentation/latest/mesos-containerizer/index.html
@@ -140,7 +140,7 @@ can write modules that implement custom isolators.</p>
<li><a href="/documentation/latest/./secrets/#environment-based-secrets">environment_secret</a></li>
<li>appc/runtime</li>
<li>cgroups/blkio</li>
-<li>cgroups/cpu</li>
+<li><a href="/documentation/latest/./isolators/cgroups-cpu/">cgroups/cpu</a></li>
<li>cgroups/cpuset</li>
<li>cgroups/devices</li>
<li>cgroups/hugetlb</li>
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/de6b7673/content/documentation/mesos-containerizer/index.html
----------------------------------------------------------------------
diff --git a/content/documentation/mesos-containerizer/index.html b/content/documentation/mesos-containerizer/index.html
index d8923a0..3ff503a 100644
--- a/content/documentation/mesos-containerizer/index.html
+++ b/content/documentation/mesos-containerizer/index.html
@@ -140,7 +140,7 @@ can write modules that implement custom isolators.</p>
<li><a href="/documentation/latest/./secrets/#environment-based-secrets">environment_secret</a></li>
<li>appc/runtime</li>
<li>cgroups/blkio</li>
-<li>cgroups/cpu</li>
+<li><a href="/documentation/latest/./isolators/cgroups-cpu/">cgroups/cpu</a></li>
<li>cgroups/cpuset</li>
<li>cgroups/devices</li>
<li>cgroups/hugetlb</li>