Version: v0.1.0-alpha.5

Install on Amazon EKS

There are a many different ways to create a Kubernetes Cluster on Amazon. We will cover installing with terraform and kops (coming soon).

Step 1: Install Prerequisites

Step 2: AWS Setup

You will 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 eks 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/ - you can now access Kalm on your Amazon EKS cluster!

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 greater sense of how Kalm works, see the Hello Kalm tutorial.

Last updated on by Scott Winges