Overview

This guide will walk you through how to quickly install Thoras and get to see resource recommendations for your workloads in just a few minutes.

What you’ll need

  1. Your Thoras license key, provided by your Thoras point-of-contact
  2. Helm
  3. Privileged access to a Kubernetes cluster
  4. The cluster should have Kubernetes metrics server installed. It probably already has this!

Install

Let’s get Thoras up-and-running!

Use the Thoras Helm repo

Install the Thoras Helm repo, which will give you access to all of the Thoras Helm charts.

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

Install Thoras

  1. Note the name of your license key file. We’ll use thoras_license.txt in our example below.
  2. Install Thoras via Helm:
helm install thoras thoras/thoras \
    --namespace thoras \
    --create-namespace \
    --set imageCredentials.password="$(cat ./thoras_license.txt)"

Verify installation

It should only take 1-2 minutes for all Thoras pods to come online. Verify that all pods are healthy by confirming their Running status:

kubectl get pods -n thoras

Once all pods are in Running status, congratulations! You’ve successfully installed Thoras!

Get Workload Resource Recommendations

Now that Thoras is up and running, we’re just minutes away from getting resource recommendations that will help our workloads run more efficiently — saving on cloud costs while boosting reliability.

View the dashboard

We’ll be working out of the Thoras Dashboard from here on out. To access it:

  1. Port-forward to the dashboard pod
kubectl port-forward service/thoras-dashboard 8080:80
  1. Pull up the dashboard in your browser: http://localhost:8080

Thoras will auto-discover workloads in your cluster and give you the option to onboard all the workloads in a namespace - zero configuration needed! This is a great way to experiment and see the value of Thoras quickly!

  1. Click “Create all” on a namespace that contains the workloads you’d like to target. This will enroll workloads into Recommendation Mode so they may begin receiving resource recommendations. This is a read-only operation — no changes will take place to your workloads.

  1. You’ll see a new popup where Thoras tells you it’s populating AIScaleTargets for you
  2. You’ll see live workload targets on the left-hand column. Try selecting one!

  1. You should immediately see metrics beginning to collect! Use the slider below the graph to narrow the time window.

  1. Predictions will run on a 15m interval. Grab a cup of coffee! ☕

Replica and resource recommendations

Predictions will become more accurate over time as the Thoras Reasoning Engine learns more about your environment. But we can still get useful predictions even on the first forecast! Let’s dive in.

Workload efficiency at a glance

The Pod Health widget will give you a quick overview of replica count recommendations and workload’s overall resource utilization.

Pod resource recommendations

Check out how much more efficiently, reliably, and cost-effectively your workloads could be running in the Resource Allocation Settings widget.

Horizontal metric utilization

If your workload uses an HPA, how efficient is your scaling resource metric utilization?

Getting support

Don’t hesitate to reach out to your Thoras point-of-contact — we’re here for any questions 24/7!