Helm Charts

We provide official Helm charts to deploy the ClusterCost stack on Kubernetes.

View on GitHub

Charts Overview

The repository contains two main charts:

1. Agent Chart (clustercost-agent-k8s)

Deploys a single cost agent per cluster.

• Resources: Creates a Deployment, ServiceAccount, RBAC roles, and Service.
• Configuration: Configured via env variables or a ConfigMap.
• Observability: Exposes metrics on port 8080. Supports ServiceMonitor for Prometheus operator.
• Defaults: Uses jesuspaz/clustercost-agent-k8s:latest.

2. Dashboard Chart (clustercost-dashboard)

Deploys the web UI for visualizing cost data.

• Resources: Creates a Deployment, Service, and optional Ingress.
• Configuration: Mounts a ConfigMap defining which agents to query.
• Updates: Checksum annotations trigger automatic rollouts on config changes.
• Defaults: Uses jesuspaz/clustercost-dashboard:latest, served on port 9090.

Installation

Prerequisites

• Kubernetes 1.19+
• Helm 3.0+

Installing a Chart

1. Inspect defaults:

   helm show values charts/clustercost-agent-k8s

2. Install:

   helm install my-agent charts/clustercost-agent-k8s \
     --namespace clustercost \
     --create-namespace

Configuration

Both charts support standard Helm configuration for:

• replicaCount
• image.repository / image.tag
• resources (CPU/Memory limits)
• nodeSelector, tolerations, and affinity
• serviceAccount.annotations (for IRSA)

For a full list of values, please refer to the values.yaml file in each chart directory.