Skip to content

Commit

Permalink
Update documentation for v0.4
Browse files Browse the repository at this point in the history
Auto-generated from v0.4.0-8-gf547a1a by 'update-gh-pages.sh'
  • Loading branch information
Github committed Mar 28, 2024
1 parent 7f76da0 commit 611434b
Show file tree
Hide file tree
Showing 38 changed files with 129 additions and 124 deletions.
2 changes: 1 addition & 1 deletion v0.4/.buildinfo
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 7a1c61c2d2d053d40e6f83717460e242
config: 5070c7ae5c7ea3cfb7f0f95eca10023b
tags: 645f666f9bcd5a90fca523b33c5a78b7
22 changes: 22 additions & 0 deletions v0.4/_sources/docs/deployment/helm/index.md.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Helm

## Stable Helm Charts

All the available charts can be found in [artifacthub.io](https://artifacthub.io/packages/search?ts_query_web=nri&verified_publisher=true&official=true&sort=relevance&page=1).

**NOTE:** NRI-plugins Helm installation has been successfully verified in both local clusters and major Cloud Providers' managed clusters, including:
Expand All @@ -19,6 +21,26 @@ All the available charts can be found in [artifacthub.io](https://artifacthub.io

While Ubuntu 20.04/22.04 was used across all three CSP environments, it's worth noting that node images are not limited to Ubuntu 20.04/22.04 only. The majority of widely recognized Linux distributions should be suitable for use.

## Unstable Helm Charts

Helm charts are also published from the main/development branch after each merge.
These charts reference the latest development images tagged as `unstable` and are
are stored alongside plugin images in the OCI image registry.

### Discovering Unstable Helm Charts

Unstable charts can be discovered using [skopeo](https://github.com/containers/skopeo).
For instance, one can list the available charts for the balloons plugin using this
skopeo command:
`skopeo list-tags docker://ghcr.io/containers/nri-plugins/helm-charts/nri-resource-policy-balloons`

### Using Unstable Helm Charts

Once discovered, unstable Helm charts can be used like any other. For instance, to use
the `v$X.$Y-unstable` version of the chart to install the development version of the
balloons plugin one can use this command:
`helm install --devel -n kube-system test oci://ghcr.io/containers/nri-plugins/helm-charts/nri-resource-policy-balloons --version v$X.$Y-unstable --set image.tag=unstable --set image.pullPolicy=Always`

```{toctree}
---
maxdepth: 2
Expand Down
2 changes: 1 addition & 1 deletion v0.4/_static/documentation_options.js
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
var DOCUMENTATION_OPTIONS = {
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
VERSION: 'v0.4.0-1-g659d042',
VERSION: 'v0.4.0-8-gf547a1a',
LANGUAGE: 'en',
COLLAPSE_INDEX: false,
BUILDER: 'html',
Expand Down
2 changes: 1 addition & 1 deletion v0.4/deployment/operator/README.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>NRI-Plugins-Operator &mdash; NRI Plugins v0.4.0-1-g659d042 documentation</title>
<title>NRI-Plugins-Operator &mdash; NRI Plugins v0.4.0-8-gf547a1a documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
Expand Down
2 changes: 1 addition & 1 deletion v0.4/docs/contributing.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Contributing &mdash; NRI Plugins v0.4.0-1-g659d042 documentation</title>
<title>Contributing &mdash; NRI Plugins v0.4.0-8-gf547a1a documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
Expand Down
18 changes: 6 additions & 12 deletions v0.4/docs/deployment/helm/balloons.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Balloons Policy Plugin &mdash; NRI Plugins v0.4.0-1-g659d042 documentation</title>
<title>Balloons Policy Plugin &mdash; NRI Plugins v0.4.0-8-gf547a1a documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
Expand Down Expand Up @@ -53,18 +53,12 @@
<li class="toctree-l1"><a class="reference internal" href="../../memory/index.html">Memory plugins</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Deployment</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="index.html">Helm</a><ul class="current">
<li class="toctree-l3 current"><a class="current reference internal" href="#">Balloons Policy Plugin</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#prerequisites">Prerequisites</a></li>
<li class="toctree-l4"><a class="reference internal" href="#installing-the-chart">Installing the Chart</a></li>
<li class="toctree-l4"><a class="reference internal" href="#uninstalling-the-chart">Uninstalling the Chart</a></li>
<li class="toctree-l4"><a class="reference internal" href="#configuration-options">Configuration options</a></li>
<li class="toctree-l3"><a class="reference internal" href="index.html#stable-helm-charts">Stable Helm Charts</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="index.html#unstable-helm-charts">Unstable Helm Charts</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="index.html#discovering-unstable-helm-charts">Discovering Unstable Helm Charts</a></li>
<li class="toctree-l4 current"><a class="reference internal" href="index.html#using-unstable-helm-charts">Using Unstable Helm Charts</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="topology-aware.html">Topology-Aware Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="template.html">Template Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="memory-qos.html">Memory-QoS Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="memtierd.html">Memtierd Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="sgx-epc.html">SGX EPC Limit Plugin</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../operator/index.html">Operator</a></li>
Expand Down Expand Up @@ -224,7 +218,7 @@ <h2>Configuration options<a class="headerlink" href="#configuration-options" tit
<td><p>metrics port to expose on the host</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">config</span></code></p></td>
<td><p>see <a class="reference external" href="https://github.com/marquiz/nri-plugins/tree/659d0428e42800a5014bb1e9822794a0daa356fd/deployment/helm/balloons/values.yaml">helm chart values</a> for the default configuration</p></td>
<td><p>see <a class="reference external" href="https://github.com/marquiz/nri-plugins/tree/f547a1a3167ea01b74eee04f9bff7b59d4b71043/deployment/helm/balloons/values.yaml">helm chart values</a> for the default configuration</p></td>
<td><p>plugin configuration data</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">configGroupLabel</span></code></p></td>
Expand Down
37 changes: 30 additions & 7 deletions v0.4/docs/deployment/helm/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Helm &mdash; NRI Plugins v0.4.0-1-g659d042 documentation</title>
<title>Helm &mdash; NRI Plugins v0.4.0-8-gf547a1a documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
Expand Down Expand Up @@ -53,12 +53,12 @@
<li class="toctree-l1"><a class="reference internal" href="../../memory/index.html">Memory plugins</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Deployment</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">Helm</a><ul>
<li class="toctree-l3"><a class="reference internal" href="balloons.html">Balloons Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="topology-aware.html">Topology-Aware Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="template.html">Template Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="memory-qos.html">Memory-QoS Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="memtierd.html">Memtierd Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="sgx-epc.html">SGX EPC Limit Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="#stable-helm-charts">Stable Helm Charts</a></li>
<li class="toctree-l3"><a class="reference internal" href="#unstable-helm-charts">Unstable Helm Charts</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#discovering-unstable-helm-charts">Discovering Unstable Helm Charts</a></li>
<li class="toctree-l4"><a class="reference internal" href="#using-unstable-helm-charts">Using Unstable Helm Charts</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../operator/index.html">Operator</a></li>
Expand Down Expand Up @@ -95,6 +95,8 @@

<section id="helm">
<h1>Helm<a class="headerlink" href="#helm" title="Permalink to this heading"></a></h1>
<section id="stable-helm-charts">
<h2>Stable Helm Charts<a class="headerlink" href="#stable-helm-charts" title="Permalink to this heading"></a></h2>
<p>All the available charts can be found in <a class="reference external" href="https://artifacthub.io/packages/search?ts_query_web=nri&amp;amp;verified_publisher=true&amp;amp;official=true&amp;amp;sort=relevance&amp;amp;page=1">artifacthub.io</a>.</p>
<p><strong>NOTE:</strong> NRI-plugins Helm installation has been successfully verified in both local clusters and major Cloud Providers’ managed clusters, including:</p>
<ul class="simple">
Expand All @@ -121,6 +123,25 @@ <h1>Helm<a class="headerlink" href="#helm" title="Permalink to this heading">
</li>
</ul>
<p>While Ubuntu 20.04/22.04 was used across all three CSP environments, it’s worth noting that node images are not limited to Ubuntu 20.04/22.04 only. The majority of widely recognized Linux distributions should be suitable for use.</p>
</section>
<section id="unstable-helm-charts">
<h2>Unstable Helm Charts<a class="headerlink" href="#unstable-helm-charts" title="Permalink to this heading"></a></h2>
<p>Helm charts are also published from the main/development branch after each merge.
These charts reference the latest development images tagged as <code class="docutils literal notranslate"><span class="pre">unstable</span></code> and are
are stored alongside plugin images in the OCI image registry.</p>
<section id="discovering-unstable-helm-charts">
<h3>Discovering Unstable Helm Charts<a class="headerlink" href="#discovering-unstable-helm-charts" title="Permalink to this heading"></a></h3>
<p>Unstable charts can be discovered using <a class="reference external" href="https://github.com/containers/skopeo">skopeo</a>.
For instance, one can list the available charts for the balloons plugin using this
skopeo command:
<code class="docutils literal notranslate"><span class="pre">skopeo</span> <span class="pre">list-tags</span> <span class="pre">docker://ghcr.io/containers/nri-plugins/helm-charts/nri-resource-policy-balloons</span></code></p>
</section>
<section id="using-unstable-helm-charts">
<h3>Using Unstable Helm Charts<a class="headerlink" href="#using-unstable-helm-charts" title="Permalink to this heading"></a></h3>
<p>Once discovered, unstable Helm charts can be used like any other. For instance, to use
the <code class="docutils literal notranslate"><span class="pre">v$X.$Y-unstable</span></code> version of the chart to install the development version of the
balloons plugin one can use this command:
<code class="docutils literal notranslate"><span class="pre">helm</span> <span class="pre">install</span> <span class="pre">--devel</span> <span class="pre">-n</span> <span class="pre">kube-system</span> <span class="pre">test</span> <span class="pre">oci://ghcr.io/containers/nri-plugins/helm-charts/nri-resource-policy-balloons</span> <span class="pre">--version</span> <span class="pre">v$X.$Y-unstable</span> <span class="pre">--set</span> <span class="pre">image.tag=unstable</span> <span class="pre">--set</span> <span class="pre">image.pullPolicy=Always</span></code></p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Contents</span></p>
<ul>
Expand Down Expand Up @@ -168,6 +189,8 @@ <h1>Helm<a class="headerlink" href="#helm" title="Permalink to this heading">
</li>
</ul>
</div>
</section>
</section>
</section>


Expand Down
16 changes: 5 additions & 11 deletions v0.4/docs/deployment/helm/memory-qos.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Memory-QoS Plugin &mdash; NRI Plugins v0.4.0-1-g659d042 documentation</title>
<title>Memory-QoS Plugin &mdash; NRI Plugins v0.4.0-8-gf547a1a documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
Expand Down Expand Up @@ -53,18 +53,12 @@
<li class="toctree-l1"><a class="reference internal" href="../../memory/index.html">Memory plugins</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Deployment</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="index.html">Helm</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="balloons.html">Balloons Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="topology-aware.html">Topology-Aware Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="template.html">Template Policy Plugin</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">Memory-QoS Plugin</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#prerequisites">Prerequisites</a></li>
<li class="toctree-l4"><a class="reference internal" href="#installing-the-chart">Installing the Chart</a></li>
<li class="toctree-l4"><a class="reference internal" href="#uninstalling-the-chart">Uninstalling the Chart</a></li>
<li class="toctree-l4"><a class="reference internal" href="#configuration-options">Configuration options</a></li>
<li class="toctree-l3"><a class="reference internal" href="index.html#stable-helm-charts">Stable Helm Charts</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="index.html#unstable-helm-charts">Unstable Helm Charts</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="index.html#discovering-unstable-helm-charts">Discovering Unstable Helm Charts</a></li>
<li class="toctree-l4 current"><a class="reference internal" href="index.html#using-unstable-helm-charts">Using Unstable Helm Charts</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="memtierd.html">Memtierd Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="sgx-epc.html">SGX EPC Limit Plugin</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../operator/index.html">Operator</a></li>
Expand Down
16 changes: 5 additions & 11 deletions v0.4/docs/deployment/helm/memtierd.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Memtierd Plugin &mdash; NRI Plugins v0.4.0-1-g659d042 documentation</title>
<title>Memtierd Plugin &mdash; NRI Plugins v0.4.0-8-gf547a1a documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
Expand Down Expand Up @@ -53,18 +53,12 @@
<li class="toctree-l1"><a class="reference internal" href="../../memory/index.html">Memory plugins</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Deployment</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="index.html">Helm</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="balloons.html">Balloons Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="topology-aware.html">Topology-Aware Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="template.html">Template Policy Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="memory-qos.html">Memory-QoS Plugin</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">Memtierd Plugin</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#prerequisites">Prerequisites</a></li>
<li class="toctree-l4"><a class="reference internal" href="#installing-the-chart">Installing the Chart</a></li>
<li class="toctree-l4"><a class="reference internal" href="#uninstalling-the-chart">Uninstalling the Chart</a></li>
<li class="toctree-l4"><a class="reference internal" href="#configuration-options">Configuration options</a></li>
<li class="toctree-l3"><a class="reference internal" href="index.html#stable-helm-charts">Stable Helm Charts</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="index.html#unstable-helm-charts">Unstable Helm Charts</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="index.html#discovering-unstable-helm-charts">Discovering Unstable Helm Charts</a></li>
<li class="toctree-l4 current"><a class="reference internal" href="index.html#using-unstable-helm-charts">Using Unstable Helm Charts</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="sgx-epc.html">SGX EPC Limit Plugin</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../operator/index.html">Operator</a></li>
Expand Down
Loading

0 comments on commit 611434b

Please sign in to comment.