Skip to main content
Version: 1.0.0

AWS EKS Cluster


Katonic can natively run using an EKS cluster hosted on your own AWS account and an EKS cluster can also be used to run all your Katonic job. This allows you to leverage Katonic and Kubernetes to create one flexible compute and DS environment.

In this guide, you will learn how to:

  • Create a EKS cluster using eksctl and the AWS CLI

Prerequisites: Prepare Your Local Environment#

Before you can complete the installation, you must install and prepare the following dependencies on your local machine:

Use the AWS CLI to Connect to your Account#

NOTE You can skip this step if you have already logged in to the AWS CLI. :::

To connect with your AWS account, use the AWS configure command:

aws configure

The AWS website has information for using the above command.

Create the YAML Recipe for the Cluster#

We will use eksctl to create the cluster in AWS. To use eksctl, you will need to create a YAML file that provides the necessary configuration for the cluster.

In the file, you must set:

  • name: the name for the cluster you will create
  • region: the name of the Amazon region you want to create the cluster in.

The rest of the configuration is already set within the file to the default recommended values for running Katonic. However, excluding the lines commented as Required., you can edit the rest of the configuration to your needs. For example, you could add new node pools or change the instance types for the node pools. You could also change the lower and upper bounds of the node pools.

Copy the following text into a new file called cluster.yaml and then edit it accordingly:

---
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig
metadata:
name: katonic-cluster
region: ap-south-1
version: "1.18"
nodeGroups:
- name: katonic-app-core
instanceType: t3.xlarge
desiredCapacity: 2
minSize: 2
maxSize: 3
volumeSize: 50
iam:
withAddonPolicies:
autoScaler: true

Create the cluster using the YAML file#

To create the cluster based on your prepared cluster.yaml file use the following command:

eksctl create cluster -f cluster.yaml

Conclusion#

Congratulations, you have now set up a working EKS cluster in AWS!

Follow this guide to complete the setup.