Install Optimize Live as an EKS add-on

Optimize Live is available as an EKS add-on in AWS Marketplace

If you’re running an Amazon EKS cluster, you can install StormForge Optimize Live as an EKS add-on in one of two ways:

  • Using the EKS and StormForge UI
  • Using the EKS CLI

Install using the EKS UI and StormForge UI

Get the add-on

  1. Open two browser windows side by side.

  2. In one window, navigate to and log in to your Amazon EKS cluster.

  3. On the cluster page, add the Add-ons tab, and then click Get more add-ons.

  4. On the Select add-ons page, scroll to the AWS Marketplace add-ons section.

  5. From the Any category menu, select cost-management.

  6. On the StormForge Optimize Live add-on card, select the check box in the upper right (see below); then, click Next. EKS cost management card

  7. Note: If you don’t have a StormForge account, go to this section at the end of this topic, complete the steps, and then move to the next step.

  8. On the Configure selected add-ons settings page, expand the Optional configuration settings section.

  9. In the Add-on configuration schema section, you can customize your installation the same way you could as an in a Helm install.

  10. Copy the following placeholder text into the Configuration values text area. In a later step, you’ll replace this text with the values generated in the Optimize Live Add Cluster wizard.

authorization: 
  issuer: 
  clientID:
  clientSecret: 
standbyMode: false
Get your cluster credentials and copy them to EKS

In a second browser window, go to app.stormforge.io and complete the steps in the Add Cluster wizard.

  1. Enter your cluster name.

  2. From the generated credentials in the Download your Helm values step, copy the issuer, clientID, and clientSecret values as shown below.

    Copy credentials from the Add Cluster wizard

  3. In your EKS browser window, paste those lines into the Configuration values text area. The Advanced configuration panel will look like this:

    EKS Configuration panel

  4. In the Conflict resolution method, select Override.

  5. Click Next, and then click Next again.

Validate the installation

Switch to the browser window that shows the Optimize Live Add Cluster wizard.

Click Continue to update your installation with your credentials. This might take a minute.

When you see the Success message, your Optimize Live cluster is ready to go.

Install using the EKS CLI and StormForge UI

This method installs Optimize Live in standby mode.

Get the add-on

Run the following command, replacing CLUSTER_NAME with the name of your cluster and REGION with your region.

eksctl create addon –cluster CLUSTER_NAME –name stormforge_optimize-live –version "v2.8.0-eksbuild.1" –region REGION –force

This installs the add-on with the default values provided by StormForge. The Agent pod (workload-agent) is in standby mode, and the Prometheus agent is not started yet.

Validate the installation

To validate the installation, run:

aws eks describe-addon –cluster-name CLUSTERNAME –region REGION –addon-name stormforge_optimize-live

The output will look something like this: EKS add-on health check

In the output, look for "status": "ACTIVE" and confirm that there are no issues in the “health” section: EKS add-on health check

Manage your StormForge subscription

In Amazon EKS, go to the Add-ons page. To get the stormforge_optimize-live add-on, click the Manage subscription link.

Complete the steps in the Add Cluster wizard (or Get Started wizard, for new accounts)

This wizard generates your Optimize Live credentials.

  1. Enter your cluster name.

  2. From the generated credentials in the Download your Helm values step, copy the issuer, clientID, and clientSecret values as shown below.

    Copy credentials from the Add Cluster wizard

Copy the credentials to your config.yaml file and set standbyMode: false

Copy your credentials into your config.yaml file shown in your EKS browser window. Be sure to copy them to the addons.configurationValues.authorization section.

Make sure you set addons.configurationValues.standbyMode: false, otherwise you’ll get an error.

Optional: Override Optimize Live default values

In the same config.yaml file, you can override any default values by updating the addons.configurationValues.clusterDefaultConfig section, as in this excerpt:

clusterDefaultConfig:
   cpuOptimizationGoal: savings
   memoryOptimizationGoal: reliability

You can also change any Prometheus defaults. For example, you can set the scrape interval to 30s.

Your final config.yaml file will look something like this:

EKS config.yaml file

Apply the YAML config and activate the add-on

Run the following command to apply the config file and get it out of standby mode:

eksctl update addon –config-file config.yaml –force

You don’t need to specify the cluster name and region as command parameters - they’re already in the config.yaml file.

After a minute or two, you should see output similar to the following: EKS eksctl update output

Continue your subscription

You have to continue to subscribe to this add-on.

  1. Sign in to aws.amazon.com, and in the AWS Marketplace Buyer website, search for StormForge Optimize Live.
  2. On the StormForge Optimize Live product page, click Continue to Subscribe in the upper right.
  3. Review the agreement and then click Create Contract.
Register your cluster with the StormForge Agent
  1. In the browser window that shows the StormForge Add Cluster wizard, click Continue and then click Verify Install.

  2. Optional: While you wait 2-3 minutes for Optimize Live to collect some initial metrics, you can explore the Optimize Live UI. In the left navigation, click Workloads, and then click the Config tab. Notice that the CPU and memory optimization goals match what you set previously in the config.yaml file.

Get a StormForge account

Complete this step only if you don’t have a StormForge account. It takes only a few minutes to get up.

  1. In a separate browser window, go to stormforge.io/signup to get your free StormForge trial license.
  2. Check your email for a confirmation message from us.
  3. When you receive the message, click the confirmation link to start your trial.
Last modified November 13, 2023