This repository contains the Helm chart templates for the development of Kubecost, an enterprise-grade application to monitor and manage Kubernetes spend. Please see the website for more details on what Kubecost can do for you and the official documentation IBM Docs, or contact team-kubecost@wwpdl.vnet.ibm.com for assistance.

Kubecost strives to support as many versions of Kubernetes as possible. Below is the version support matrix which has been tested. Versions outside of the stated range may still work but are untested.

Note: Upcoming changes to the Kubecost Helm chart will require configuration changes

To install the current GA version (2.8) of Kubecost via Helm, run the following command:

helm upgrade --install kubecost -n kubecost --create-namespace \
  --repo https://kubecost.github.io/cost-analyzer/ cost-analyzer

Alternatively, add the Helm repository first and scan for updates:

helm repo add kubecost https://kubecost.github.io/cost-analyzer/
helm repo update
helm install kubecost kubecost/cost-analyzer -n kubecost --create-namespace

The default branch of this repository is the develop branch. This branch is not stable and is subject to change. Please use the following command to show values available for the chart you are using:

helm show values kubecost/cost-analyzer --version 2.8.2

Or switch to the tag of the version you are using:

https://github.com/kubecost/kubecost/tree/v2.8.2

To install the beta/release candidates pass the --devel flag:

helm helm repo add kubecost-30-testing https://kubecost.github.io/kubecost/
helm repo update

helm install kubecost kubecost-30-testing/kubecost \
  --namespace kubecost \
  --create-namespace \
  --devel

See the 3.0 examples for more information on changes required when upgrading to 3.0 beta.

The develop branch is the development branch for the chart. It is not stable and is subject to instability.

git clone https://github.com/kubecost/kubecost.git
cd kubecost
helm dependency update ./kubecost
helm install kubecost ./kubecost \
  --namespace kubecost \
  --create-namespace

Uninstall the chart:

helm uninstall kubecost-30-testing -n kubecost

Note that when uninstalling, the persistent volume for the Kubecost metrics are not deleted. You can delete them manually by deleting the namespace:

kubectl delete namespace kubecost