Skip to content

Commit

Permalink
docs: add basic README for each Helm chart on their own directory
Browse files Browse the repository at this point in the history
This commit adds basic documentation for each Helm chart so that
basic information is available to the user who are trying to install
any of those plugins via artifacthub.io registry.

Signed-off-by: Feruzjon Muyassarov <[email protected]>
  • Loading branch information
fmuyassarov committed Oct 19, 2023
1 parent a5bbd52 commit a628dcb
Show file tree
Hide file tree
Showing 5 changed files with 183 additions and 76 deletions.
43 changes: 43 additions & 0 deletions deployment/helm/balloons/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Introduction

This chart deploys balloons Node Resource Interface (NRI) plugin. The balloons NRI resource
policy plugin implements workload placement into “balloons” that are disjoint CPU pools.

# Installing the Chart

Path to the chart: `nri-resource-policy-balloons`

```
helm repo add nri-plugins https://containers.github.io/nri-plugins
helm install my-balloons nri-plugins/nri-resource-policy-balloons --namespace kube-system
```

The command above deploys balloons NRI plugin on the Kubernetes cluster within the
`kube-system` namespace with default configuration.

# Uninstalling the Chart

To uninstall the balloons plugin run the following command:

```
helm delete my-balloons --namespace kube-system
```

# Configuration options

The tables below present an overview of the parameters available for users to customize with their own values,
along with the default values.

| 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 |
| `image.tag` | unstable | container image tag |
| `image.pullPolicy` | Always | image pull policy |
| `resources.cpu` | 500m | cpu resources for the Pod |
| `resources.memory` | 512Mi | memory qouta for the Pod |
| `hostPort` | 8891 | metrics port to expose on the host |
| `config` | <pre><code>ReservedResources:</code><br><code> cpu: 750m</code></pre> | plugin configuration data |
| `nri.patchRuntimeConfig` | false | enable NRI in containerd or CRI-O |
| `initImage.name` | [ghcr.io/containers/nri-plugins/config-manager](ghcr.io/containers/nri-plugins/config-manager) | init container image name |
| `initImage.tag` | unstable | init container image tag |
| `initImage.pullPolicy` | Always | init container image pull policy |
43 changes: 43 additions & 0 deletions deployment/helm/memory-qos/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Introduction

This chart deploys memory-qos Node Resource Interface (NRI) plugin. The memory-qos NRI plugin
adds two methods for controlling cgroups v2 memory.* parameters: QoS class and direct memory
annotations.

# Installing the Chart

Path to the chart: `nri-memory-qos`.

```
helm repo add nri-plugins https://containers.github.io/nri-plugins
helm install my-memory-qos nri-plugins/nri-memory-qos --namespace kube-system
```

The command above deploys memtierd NRI plugin on the Kubernetes cluster within the
`kube-system` namespace with default configuration.

# Uninstalling the Chart

To uninstall the memory-qos plugin run the following command:

```
helm delete my-memory-qos --namespace kube-system
```

# Configuration options

The tables below present an overview of the parameters available for users to customize with their own values,
along with the default values.

| Name | Default | Description |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `image.name` | [ghcr.io/containers/nri-plugins/nri-memory-qos](ghcr.io/containers/nri-plugins/nri-memory-qos) | container image name |
| `image.tag` | unstable | container image tag |
| `image.pullPolicy` | Always | image pull policy |
| `resources.cpu` | 10m | cpu resources for the Pod |
| `resources.memory` | 100Mi | memory qouta for the |
| `nri.patchRuntimeConfig` | false | enable NRI in containerd or CRI-O |
| `initImage.name` | [ghcr.io/containers/nri-plugins/config-manager](ghcr.io/containers/nri-plugins/config-manager) | init container image name |
| `initImage.tag` | unstable | init container image tag |
| `initImage.pullPolicy` | Always | init container image pull policy |

43 changes: 43 additions & 0 deletions deployment/helm/memtierd/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Introduction

This chart deploys memtierd Node Resource Interface (NRI) plugin. The memtierd NRI plugin enables
managing workloads with Memtierd in Kubernetes.

# Installing the Chart

Path to the chart: `nri-memtierd`.

```
helm repo add nri-plugins https://containers.github.io/nri-plugins
helm install my-memtierd nri-plugins/nri-memtierd --namespace kube-system
```

The command above deploys memtierd NRI plugin on the Kubernetes cluster within the
`kube-system` namespace with default configuration.

# Uninstalling the Chart

To uninstall the memtierd plugin run the following command:

```
helm delete my-memtierd --namespace kube-system
```

# Configuration options

The tables below present an overview of the parameters available for users to customize with their own values,
along with the default values.

| Name | Default | Description |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `image.name` | [ghcr.io/containers/nri-plugins/nri-memtierd](ghcr.io/containers/nri-plugins/nri-memtierd) | container image name |
| `image.tag` | unstable | container image tag |
| `image.pullPolicy` | Always | image pull policy |
| `resources.cpu` | 250m | cpu resources for the Pod |
| `resources.memory` | 100Mi | memory qouta for the |
| `outputDir` | empty string | host directory for memtierd.output files |
| `nri.patchRuntimeConfig` | false | enable NRI in containerd or CRI-O |
| `initImage.name` | [ghcr.io/containers/nri-plugins/config-manager](ghcr.io/containers/nri-plugins/config-manager) | init container image name |
| `initImage.tag` | unstable | init container image tag |
| `initImage.pullPolicy` | Always | init container image pull policy |

44 changes: 44 additions & 0 deletions deployment/helm/topology-aware/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Introduction

This chart deploys topology-aware Node Resource Interface (NRI) plugin. Topology-aware NRI
resource policy plugin is a NRI plugin that will apply hardware-aware resource allocation
policies to the containers running in the system.

# Installing the Chart

Path to the chart: `nri-resource-policy-topology-aware`.

```
helm repo add nri-plugins https://containers.github.io/nri-plugins
helm install my-topology-aware nri-plugins/nri-resource-policy-topology-aware --namespace kube-system
```

The command above deploys topology-aware NRI plugin on the Kubernetes cluster within the
`kube-system` namespace with default configuration.

# Uninstalling the Chart

To uninstall the topology-aware plugin run the following command:

```
helm delete my-topology-aware --namespace kube-system
```

# Configuration options

The tables below present an overview of the parameters available for users to customize with their own values,
along with the default values.

| 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 |
| `image.tag` | unstable | container image tag |
| `image.pullPolicy` | Always | image pull policy |
| `resources.cpu` | 500m | cpu resources for the Pod |
| `resources.memory` | 512Mi | memory qouta for the Pod |
| `hostPort` | 8891 | metrics port to expose on the host |
| `config` | <pre><code>ReservedResources:</code><br><code> cpu: 750m</code></pre> | plugin configuration data |
| `nri.patchRuntimeConfig` | false | enable NRI in containerd or CRI-O |
| `initImage.name` | [ghcr.io/containers/nri-plugins/config-manager](ghcr.io/containers/nri-plugins/config-manager) | init container image name |
| `initImage.tag` | unstable | init container image tag |
| `initImage.pullPolicy` | Always | init container image pull policy |
Loading

0 comments on commit a628dcb

Please sign in to comment.