Repository: mesos-site Updated Branches: refs/heads/asf-site 6d1294b3a -> 6b59316c6
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6b59316c/content/documentation/latest/isolators/windows/index.html ---------------------------------------------------------------------- diff --git a/content/documentation/latest/isolators/windows/index.html b/content/documentation/latest/isolators/windows/index.html new file mode 100644 index 0000000..d684fab --- /dev/null +++ b/content/documentation/latest/isolators/windows/index.html @@ -0,0 +1,232 @@ +<!DOCTYPE html> +<html> + <head> + <meta charset="utf-8"> + <title>Apache Mesos - Windows Job Object 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="/getting-started/">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="/getting-started/">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>Windows Job Object Support in Mesos Containerizer</h1> + +<p>The <code>windows/cpu</code> isolator allows operators to provide CPU limitations and CPU +usage accounting for containers within a Mesos cluster. To enable the +<code>windows/cpu</code> isolator, append <code>windows/cpu</code> to the <code>--isolation</code> flag when +starting the Mesos agent.</p> + +<p>The <code>windows/mem</code> isolator allows operators to provide memory limitations and +memory usage accounting for containers within a Mesos cluster. To enable the +<code>windows/mem</code> isolator, append <code>windows/mem</code> to the <code>--isolation</code> flag when +starting the Mesos agent.</p> + +<p>Both of these isolators apply to commands launched by the Mesos Containerizer, +which are grouped into a Windows <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/ms684161(v=vs.85">Job Object</a>.aspx). +They do not apply to Windows Containers or Docker Containers.</p> + +<h2>CPU limits</h2> + +<p>The <code>windows/cpu</code> isolator sets a hard cap on the CPU usage, enforced by the +operating system. This uses <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/hh448384(v=vs.85">Job Object CPU Rate Control</a>.aspx):</p> + +<blockquote><p>Sets the maximum portion of processor cycles that the threads in a job object +can use during each scheduling interval. After the job reaches this limit for +a scheduling interval, no threads associated with the job can run until the +next scheduling interval.</p></blockquote> + +<p>NOTE: This <em>does not</em> support bursting. Unlike the similarly named <code>cgroups/cpu</code> +isolator, this is a <strong>hard cap</strong>, not a soft cap.</p> + +<h3>Statistics</h3> + +<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 job object;</li> +<li><code>cpus_user_time_secs</code> - time spent by tasks of the job object in user mode;</li> +<li><code>cpus_system_time_secs</code> - time spent by tasks of the job object in kernel +mode.</li> +</ul> + + +<h2>Memory limits</h2> + +<p>The <code>windows/memory</code> isolator sets a hard cap on the virtual memory usage, enforced by the +operating system. This uses <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/ms684156(v=vs.85">Job Object Limit Job Memory</a>.aspx):</p> + +<blockquote><p>Sets the limit for the virtual memory that can be committed for the job. When +a process attempts to commit memory that would exceed the job-wide limit, it +fails.</p></blockquote> + +<h3>Statistics</h3> + +<p>This isolator exports valuable per-container memory 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>mem_total_bytes</code> - sum of the current working set size for all processes in +the job object. This does not include memory that is swapped out.</li> +</ul> + + + </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> + <script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/4.1.0/anchor.min.js" type="text/javascript"></script> + + <!-- Inject anchors for all headings on the page, see https://www.bryanbraun.com/anchorjs. --> + <script type="text/javascript"> + anchors.options = { + placement: 'right', + ariaLabel: 'Permalink', + }; + + // The default is to not add anchors to h1, but we have pages with multiple h1 headers, + // and we do want to put anchors on those. + anchors.add('h1, h2, h3, h4, h5, h6'); + </script> + </body> +</html> http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6b59316c/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 23323b4..a1f4b4d 100644 --- a/content/documentation/latest/mesos-containerizer/index.html +++ b/content/documentation/latest/mesos-containerizer/index.html @@ -171,6 +171,8 @@ can write modules that implement custom isolators.</p> <li>volume/image</li> <li><a href="/documentation/latest/./container-volume/#sandbox_path-volume-source">volume/sandbox_path</a></li> <li><a href="/documentation/latest/./secrets/#file-based-secrets">volume/secret</a></li> +<li><a href="/documentation/latest/./isolators/windows/#cpu-limits">windows/cpu</a></li> +<li><a href="/documentation/latest/./isolators/windows/#memory-limits">windows/mem</a></li> </ul> http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6b59316c/content/documentation/mesos-containerizer/index.html ---------------------------------------------------------------------- diff --git a/content/documentation/mesos-containerizer/index.html b/content/documentation/mesos-containerizer/index.html index 487aaf6..ff9b894 100644 --- a/content/documentation/mesos-containerizer/index.html +++ b/content/documentation/mesos-containerizer/index.html @@ -171,6 +171,8 @@ can write modules that implement custom isolators.</p> <li>volume/image</li> <li><a href="/documentation/latest/./container-volume/#sandbox_path-volume-source">volume/sandbox_path</a></li> <li><a href="/documentation/latest/./secrets/#file-based-secrets">volume/secret</a></li> +<li><a href="/documentation/latest/./isolators/windows/#cpu-limits">windows/cpu</a></li> +<li><a href="/documentation/latest/./isolators/windows/#memory-limits">windows/mem</a></li> </ul> http://git-wip-us.apache.org/repos/asf/mesos-site/blob/6b59316c/content/sitemap.xml ---------------------------------------------------------------------- diff --git a/content/sitemap.xml b/content/sitemap.xml index 6a5b1d4..7aed5b9 100644 --- a/content/sitemap.xml +++ b/content/sitemap.xml @@ -3113,10 +3113,6 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> - <loc>http://mesos.apache.org/api/latest/c++/cpu_8hpp.html</loc> - <lastmod>2017-12-01T00:00:00+00:00</lastmod> - </url> - <url> <loc>http://mesos.apache.org/api/latest/c++/structmesos_1_1internal_1_1master_1_1Master_1_1Subscribers_1_1Subscriber.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -5973,10 +5969,6 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> - <loc>http://mesos.apache.org/api/latest/c++/classmesos_1_1internal_1_1slave_1_1WindowsIsolatorProcess.html</loc> - <lastmod>2017-12-01T00:00:00+00:00</lastmod> - </url> - <url> <loc>http://mesos.apache.org/api/latest/c++/structrouting_1_1filter_1_1icmp_1_1Classifier-members.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -7065,10 +7057,6 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> - <loc>http://mesos.apache.org/api/latest/c++/src_2slave_2containerizer_2mesos_2isolators_2windows_8hpp.html</loc> - <lastmod>2017-12-01T00:00:00+00:00</lastmod> - </url> - <url> <loc>http://mesos.apache.org/api/latest/c++/classProcessWatcher.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -7281,6 +7269,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/api/latest/c++/cgroups_2subsystems_2cpu_8hpp.html</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/api/latest/c++/classmesos_1_1internal_1_1cram__md5_1_1CRAMMD5Authenticator-members.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -7481,10 +7473,6 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> - <loc>http://mesos.apache.org/api/latest/c++/classmesos_1_1internal_1_1slave_1_1WindowsIsolatorProcess-members.html</loc> - <lastmod>2017-12-01T00:00:00+00:00</lastmod> - </url> - <url> <loc>http://mesos.apache.org/api/latest/c++/classmesos_1_1internal_1_1slave_1_1FetcherProcess_1_1Cache_1_1Entry-members.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -8117,10 +8105,6 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> - <loc>http://mesos.apache.org/api/latest/c++/src_2slave_2containerizer_2mesos_2isolators_2windows_8hpp_source.html</loc> - <lastmod>2017-12-01T00:00:00+00:00</lastmod> - </url> - <url> <loc>http://mesos.apache.org/api/latest/c++/posix_2sendfile_8hpp_source.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -8573,6 +8557,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/api/latest/c++/mem_8hpp_source.html</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/api/latest/c++/classmesos_1_1internal_1_1slave_1_1docker_1_1RegistryPuller.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -9565,10 +9553,6 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> - <loc>http://mesos.apache.org/api/latest/c++/cpu_8hpp_source.html</loc> - <lastmod>2017-12-01T00:00:00+00:00</lastmod> - </url> - <url> <loc>http://mesos.apache.org/api/latest/c++/namespacemesos_1_1internal_1_1master_1_1validation_1_1master_1_1message.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -10333,6 +10317,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/api/latest/c++/windows_2cpu_8hpp_source.html</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/api/latest/c++/namespaceorg_1_1apache_1_1zookeeper.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -10829,6 +10817,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/api/latest/c++/cgroups_2subsystems_2cpu_8hpp_source.html</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/api/latest/c++/master_2validation_8hpp_source.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -12465,6 +12457,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/api/latest/c++/mem_8hpp.html</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/api/latest/c++/structprocess_1_1internal_1_1wrap.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -13357,6 +13353,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/api/latest/c++/dir_6e72cfcf2726dd9485f4536a00bbb945.html</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/api/latest/c++/classprocess_1_1DataEncoder-members.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -14189,6 +14189,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/api/latest/c++/windows_2cpu_8hpp.html</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/api/latest/c++/classmesos_1_1internal_1_1master_1_1allocator_1_1HierarchicalAllocatorProcess-members.html</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> @@ -16473,6 +16477,10 @@ <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url> <url> + <loc>http://mesos.apache.org/documentation/latest/isolators/windows/</loc> + <lastmod>2017-12-01T00:00:00+00:00</lastmod> + </url> + <url> <loc>http://mesos.apache.org/documentation/latest/isolators/network-ports/</loc> <lastmod>2017-12-01T00:00:00+00:00</lastmod> </url>
![http://mesos.apache.org/assets/img/mesos_logo_fb_preview.png"/](http://mesos.apache.org/assets/img/mesos_logo_fb_preview.png"/){kind=link}