Installing Cast AI components with Helm

This guide explains how to install Cast AI components using Helm charts. While our onboarding script automates most installations, you may prefer manual installation for greater control or customization.

Prerequisites

• Helm installed
• Access to your Kubernetes cluster
• Full Access Cast AI API key

Add the Cast AI Helm repository

Add the Cast AI Helm repository and update your local chart information:

helm repo add castai-helm https://castai.github.io/helm-charts
helm repo update

Install components

Read-only mode for EKS, GKE, and AKS

Install the core Cast AI agent in read-only mode:

helm upgrade -i castai-agent castai-helm/castai-agent -n castai-agent \
  --set apiKey="<your-api-key>" \
  --set provider="<eks|gke|aks>"

Replace <your-api-key> with your Cast AI API key and <eks|gke|aks> with your cloud provider.

In case of any problems with connecting to the Cast AI console, please check the relevant entry in our Troubleshooting guide.

Autoscaling components

Here is a list of commands for installing components required for autoscaling with Helm:

Cluster controller

To install the castai-cluster-controller, i.e., the component for executing different Kubernetes-related operations, run the following command:

helm upgrade -i cluster-controller castai-helm/castai-cluster-controller -n castai-agent \
  --set castai.apiKey="\<replace_with_your_api_key>" \
  --set castai.clusterID=\<replace_with_castai_cluster_id>

For AKS clusters, add --set aks.enabled=true:

helm upgrade -i cluster-controller castai-helm/castai-cluster-controller -n castai-agent \
  --set castai.apiKey="\<replace_with_your_api_key>" \
  --set castai.clusterID=\<replace_with_castai_cluster_id> \
  --set aks.enabled=true

Spot handler

Spot Handler is the component responsible for monitoring scheduled events and delivering them to the central platform. To learn more, visit Spot handler documentation or our GitHub.

To install the spot-handler component for handling spot interruptions, run the following command:

helm upgrade -i castai-spot-handler castai-helm/castai-spot-handler -n castai-agent \
  --set castai.apiURL=https://api.cast.ai \
  --set castai.clusterID="<your-cluster-id>" \
  --set castai.provider="<aws|azure|gcp>"

Replace <aws|azure|gcp> with your cloud provider.

Evictor

To install Evictor to reduce the cluster size, run the following command:

helm upgrade -i castai-evictor castai-helm/castai-evictor -n castai-agent --set replicaCount=0

Learn more about bin-packing and Evictor.

Kvisor

To install the Security posture assessment agent, called kvisor, run the following command:

📘

Note

If your cluster is in the EU region, update the apiURL to:
https://kvisor.prod-eu.cast.ai:443

helm upgrade -i castai-kvisor castai-helm/castai-kvisor -n castai-agent \
  --set castai.apiURL=https://api.cast.ai \
  --set castai.clusterID="<your-cluster-id>" \
  --set structuredConfig.provider="<eks|aks|gcp>" \
  --set castai.apiKey="<your-api-key>"

Replace <eks|aks|gcp> with your cloud provider.

To learn more about the capabilities of Cast AI's security posture management solution and how it helps you be sure to head to our Security section.

Customize installations

Each Cast AI Helm chart supports various configuration options. Refer to the CAST AI Helm charts repository for detailed value descriptions and examples.

To customize an installation, create a values.yaml file with your desired settings and use the -f flag:

helm upgrade -i <release-name> castai-helm/<chart-name> -n castai-agent -f values.yaml