Helm Charts

Defining your extensions as Helm charts is one of two methods you can use to run k0s with your preferred extensions (the other being through the use of Manifest Deployer).

k0s supports two methods for deploying applications using Helm charts:

  • Use Helm command in runtime to install applications. Refer to the Helm Quickstart Guide for more information.
  • Insert Helm charts directly into the k0s configuration file, k0s.yaml. This method does not require a separate install of helm tool and the charts automatically deploy at the k0s bootstrap phase.

Helm charts in k0s configuration

Adding Helm charts into the k0s configuration file gives you a declarative way in which to configure the cluster. k0s controller manages the setup of Helm charts that are defined as extensions in the k0s configuration file.

Wait for install

Each chart is proccesed the same way CLI tool does with following options:

  • --wait
  • --wait-for-jobs
  • --timeout 10m

It is possible to customize timeout by using .Timeout field.

Chart configuration

FieldDefault valueDescription
name-Release name
chartname-chartname in form “repository/chartname”
version-version to install
timeout10mtimeout to wait for release install
values-yaml as a string, custom chart values
namespace-namespace to install chart into

Example

In the example, Prometheus is configured from “stable” Helms chart repository. Add the following to k0s.yaml and restart k0s, after which Prometheus should start automatically with k0s.

  1. spec:
  2.   extensions:
  3.     helm:
  4.       repositories:
  5.       - name: stable
  6.         url: https://charts.helm.sh/stable
  7.       - name: prometheus-community
  8.         url: https://prometheus-community.github.io/helm-charts
  9.       charts:
  10.       - name: prometheus-stack
  11.         chartname: prometheus-community/prometheus
  12.         version: "14.6.1"
  13.         timeout: 20m
  14.         values: |
  15.           alertmanager:
  16.             persistentVolume:
  17.               enabled: false
  18.           server:
  19.             persistentVolume:
  20.               enabled: false
  21.         namespace: default
  22.       # We don't need to specify the repo in the repositories section for OCI charts
  23.       - name: oci-chart
  24.         chartname: oci://registry:8080/chart
  25.         version: "0.0.1"
  26.         values: ""
  27.         namespace: default

Example extensions that you can use with Helm charts include:

Helm debug logging

Running k0s controller with --debug=true enables helm debug logging.