From dcf8764c034af0d64c903cb6f7e17c49533ad2e4 Mon Sep 17 00:00:00 2001 From: Github Date: Thu, 12 Oct 2023 10:54:04 +0000 Subject: [PATCH] Update documentation for v0.2 Auto-generated from v0.2.0-4-g1da8f6c by 'update-gh-pages.sh' --- v0.2/.buildinfo | 2 +- .../docs/resource-policy/installation.md.txt | 48 ++++++++++++------- v0.2/_static/documentation_options.js | 2 +- v0.2/docs/contributing.html | 2 +- v0.2/docs/index.html | 2 +- v0.2/docs/introduction.html | 2 +- v0.2/docs/memory/index.html | 2 +- v0.2/docs/memory/memory-qos.html | 2 +- v0.2/docs/memory/memtierd.html | 2 +- v0.2/docs/resource-policy/configuration.html | 2 +- .../developers-guide/architecture.html | 24 +++++----- .../developers-guide/cpu-allocator.html | 2 +- .../developers-guide/e2e-test.html | 2 +- .../developers-guide/index.html | 2 +- .../developers-guide/testing.html | 2 +- .../developers-guide/unit-test.html | 2 +- v0.2/docs/resource-policy/index.html | 2 +- v0.2/docs/resource-policy/installation.html | 42 +++++++++------- v0.2/docs/resource-policy/introduction.html | 2 +- .../docs/resource-policy/policy/balloons.html | 2 +- v0.2/docs/resource-policy/policy/index.html | 2 +- .../policy/topology-aware.html | 2 +- v0.2/docs/resource-policy/setup.html | 2 +- v0.2/genindex.html | 2 +- v0.2/search.html | 2 +- v0.2/searchindex.js | 2 +- 26 files changed, 90 insertions(+), 70 deletions(-) diff --git a/v0.2/.buildinfo b/v0.2/.buildinfo index b6571972a..38d434c67 100644 --- a/v0.2/.buildinfo +++ b/v0.2/.buildinfo @@ -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: 15d9322d87e2a508dbafde4cac852d6b +config: 8fe6733bb25fb6c8a56a36b781987278 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/v0.2/_sources/docs/resource-policy/installation.md.txt b/v0.2/_sources/docs/resource-policy/installation.md.txt index fe4dd0394..fa2db3c17 100644 --- a/v0.2/_sources/docs/resource-policy/installation.md.txt +++ b/v0.2/_sources/docs/resource-policy/installation.md.txt @@ -26,7 +26,7 @@ following components: DaemonSet, ConfigMap, CustomResourceDefinition, and RBAC-r For instance, ```sh - helm install topology-aware --namespace kube-system --set nri.patchRuntimeConfig=true deployment/helm/topology-aware/ + helm install topology-aware nri-plugins/nri-resource-policy-topology-aware --namespace kube-system --set nri.patchRuntimeConfig=true ``` Enabling `nri.patchRuntimeConfig` creates an init container to turn on @@ -41,7 +41,7 @@ following components: DaemonSet, ConfigMap, CustomResourceDefinition, and RBAC-r For instance, ```sh - helm install topology-aware --namespace kube-system --set nri.patchRuntimeConfig=true deployment/helm/topology-aware/ + helm install topology-aware nri-plugins/nri-resource-policy-topology-aware --namespace kube-system --set nri.patchRuntimeConfig=true ``` - Kubernetes 1.24+ @@ -49,30 +49,36 @@ following components: DaemonSet, ConfigMap, CustomResourceDefinition, and RBAC-r ## Installing the Helm Chart -1. Clone the project to your local machine +1. Add the nri-plugins charts repository so that Helm install can find the actual charts. + ```sh - git clone https://github.com/containers/nri-plugins.git + helm repo add nri-plugins https://containers.github.io/nri-plugins ``` -1. Navigate to the project directory +1. List chart repositories to ensure that nri-plugins repo is added. + ```sh - cd nri-plugins + helm repo list ``` -1. Install the plugin using Helm. Replace release name with the desired name - for your Helm release. In this example, we named it as topology-aware. The - default values for topology-aware resource policy plugin are stored in - values.yaml file. If you wish to provide custom values to the Helm - chart, refer to the [table](#helm-parameters) below, which describes the - available parameters that can be modified before installation. It's important - to note that specifying the namespace (using `--namespace`) is crucial when - installing the Helm chart. If no namespace is specified, the manifests will - be installed in the default namespace. +1. Install the plugin. Replace release version with the desired version. If you wish to + provide custom values to the Helm chart, refer to the [table](#helm-parameters) below, + which describes the available parameters that can be modified before installation. + It's important to note that specifying the namespace (using `--namespace` or `-n`) is + crucial when installing the Helm chart. If no namespace is specified, the manifests + will be installed in the default namespace. ```sh - helm install topology-aware --namespace kube-system deployment/helm/topology-aware/ + helm install topology-aware nri-plugins/nri-resource-policy-topology-aware --namespace kube-system ``` + The helm repository is named `nri-plugins`, and in step 1, you have the + flexibility to choose any name when adding it. However, it's important to + note that `nri-resource-policy-topology-aware`, which serves as the path + to the chart, must accurately reflect the actual name of the chart. You + can find the path to each chart in the [helm parameters table](#helm-parameters). + + 1. Verify the status of the daemonset to ensure that the plugin is running successfully ```bash @@ -89,7 +95,7 @@ That's it! You have now installed the topology-aware NRI resource policy plugin To uninstall plugin chart just deleting it with the release name is enough: ```bash -helm delete topology-aware +helm uninstall topology-aware --namespace kube-system ``` Note: this removes DaemonSet, ConfigMap, CustomResourceDefinition, and RBAC-related objects associated with the chart. @@ -101,6 +107,8 @@ along with the default values, for the Topology-aware and Balloons plugins Helm #### Topology-aware +Path to the chart: `nri-resource-policy-topology-aware` + | Name | Default | Description | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | `image.name` | [ghcr.io/containers/nri-plugins/nri-resource-policy-topology-aware](ghcr.io/containers/nri-plugins/nri-resource-policy-topology-aware) | container image name | @@ -117,6 +125,8 @@ along with the default values, for the Topology-aware and Balloons plugins Helm #### Balloons +Path to the chart: `nri-resource-policy-balloons` + | Name | Default | Description | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | `image.name` | [ghcr.io/containers/nri-plugins/nri-resource-policy-balloons](ghcr.io/containers/nri-plugins/nri-resource-policy-balloons) | container image name | @@ -133,6 +143,8 @@ along with the default values, for the Topology-aware and Balloons plugins Helm #### Memtierd +Path to the chart: `nri-memtierd` + | Name | Default | Description | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | `image.name` | [ghcr.io/containers/nri-plugins/nri-memtierd](ghcr.io/containers/nri-plugins/nri-memtierd) | container image name | @@ -149,6 +161,8 @@ along with the default values, for the Topology-aware and Balloons plugins Helm #### Memory-qos +Path to the chart: `nri-memory-qos` + | Name | Default | Description | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | `image.name` | [ghcr.io/containers/nri-plugins/nri-memory-qos](ghcr.io/containers/nri-plugins/nri-memory-qos) | container image name | diff --git a/v0.2/_static/documentation_options.js b/v0.2/_static/documentation_options.js index 649496eec..3ac04c3bb 100644 --- a/v0.2/_static/documentation_options.js +++ b/v0.2/_static/documentation_options.js @@ -1,6 +1,6 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '0.2.0-2-g7055ec6', + VERSION: '0.2.0-4-g1da8f6c', LANGUAGE: 'en', COLLAPSE_INDEX: false, BUILDER: 'html', diff --git a/v0.2/docs/contributing.html b/v0.2/docs/contributing.html index 566f535b1..d3d0a906d 100644 --- a/v0.2/docs/contributing.html +++ b/v0.2/docs/contributing.html @@ -4,7 +4,7 @@ - Contributing — NRI Plugins 0.2.0-2-g7055ec6 documentation + Contributing — NRI Plugins 0.2.0-4-g1da8f6c documentation