Getting Started with kOps on Spot Ocean

Ocean seamlessly integrates with your existing instance groups, as a drop-in replacement for AWS Auto Scaling groups, and allows you to streamline and optimize the entire workflow, from initially creating your cluster to managing and optimizing it on an ongoing basis.

• Simplify Cluster Management — Ocean’s Virtual Node Groups make it easy to run different infrastructure in a single cluster, which can span multiple AWS VPC availability zones and subnets for high-availability.

• Container-Driven Autoscaling and Vertical Rightsizing — Auto-detect your container infrastructure requirements so the appropriate instance size or type will always be available. Measure real-time CPU/Memory consumption of your Pods for ongoing resource optimization.

• Cloud-Native Showback — Gain a granular view of your cluster’s cost breakdown (compute and storage) for each and every one of the cluster’s resources such as Namespaces, Deployments, Daemon Sets, Jobs, and Pods.

• Optimized Pricing and Utilization — Ocean not only intelligently leverages Spot Instances and reserved capacity to reduce costs, but also eliminates underutilized instances with container-driven autoscaling and advanced bin-packing.

Prerequisites

Make sure you have and installed kubectl.

Setup your environment

To use environment variables, run:

To use credentials file, run the spotctl configure command:

? Enter your access token [? for help] **********************************
? Select your default account  [Use arrows to move, ? for more help]
  act-0abcdefg (dev)

Or, manually create an INI formatted file like this:

[default]
token   = <spotinst_token>
account = <spotinst_account>

and place it in:

• Unix/Linux/macOS:

• Windows:

  %UserProfile%\.spotinst\credentials

AWS

Creating a Cluster

You can add an Ocean instance group to new or existing clusters. To create a new cluster with a Ocean instance groups, run:

# configure the feature flags
export KOPS_FEATURE_FLAGS="Spotinst,SpotinstOcean,SpotinstOceanTemplate"
# create the cluster
kops create cluster --zones=us-west-2a example

Note

It’s possible to have a cluster with both Ocean-managed and unmanaged instance groups.

# instancegroups.yaml
# A cluster with both Ocean-managed and unmanaged instance groups.
---
# Use Ocean in hybrid mode.
apiVersion: kops.k8s.io/v1alpha2
  labels:
    kops.k8s.io/cluster: "example"
    spotinst.io/hybrid: "true"
  ...
---
# Use AWS Auto Scaling group.
apiVersion: kops.k8s.io/v1alpha2
kind: InstanceGroup
metadata:
  labels:
    kops.k8s.io/cluster: "example"
  ...

Creating an Instance Group

To create a new instance group, run:

# configure the feature flags
export KOPS_FEATURE_FLAGS="Spotinst,SpotinstOcean,SpotinstOceanTemplate"
# create the instance group
kops create instancegroup --role=node --name=example

To create a new instance group and have more control over the configuration, a config file can be used.

Documentation

If you’re new to and want to get started, please checkout our Getting Started guide, available on the website.

Getting Help

• Join our community on Slack.
• Ask a question on and tag it with spot-ocean.