Version: v0.1.0-alpha.4

Install on Amazon EKS

There are a many different ways to create a Kubernetes Cluster on Amazon. We will cover kops and terraform.

Step 1: Install Prerequisits

Step 2: Azure Setup

You need an AWS service account. Configure service credentials, then configure the aws CLI with:

aws configure

Enter your Access key ID and secret.

Step 3: Terraform Apply

Clone the repository below and cd into the aks directory

git clone https://github.com/kalmhq/tf-scripts
cd tf-scripts/eks

Install the cluster with the following commands.

terraform init
terraform apply

Type yes to confirm the installation.

After 5-10 minutes, the cluster should be created.

View the newly cluster with:

aws eks list-clusters

Configure kubectl to use the new cluster.

aws eks --region us-west-2 update-kubeconfig --name NAME_OF_YOUR_CLUSTER

Verify the cluster is properly setup and accessible.

kubectl get nodes

Step 4: Install Kalm

Once the cluster is setup, install Kalm with the following command.

curl -sL https://get.kalm.dev | bash

To enable localhost access, open a port via:

kubectl port-forward -n kalm-system \
$(kubectl get pod -n kalm-system \
-l app=kalm \
-ojsonpath="{.items[0].metadata.name}") \
3010:3010

Now open http://localhost:3010/

Clean Up

Delete the cluster to avoid resource charges.

terraform destroy

Next Step

You've now setup Kalm on an Amazon EKS cluster. To get a sense of how Kalm works, see the Hello Kalm tutorial.

Last updated on by david