This guide demonstrates how to create an Amazon EKS cluster using either the AWS Command Line Interface (CLI) or with Terraform. The resulting cluster generated from this guide will be ready to install Kalm.
Before following either guide below
- Install kubectl
- Install the the AWS CLI.
- Configure the AWS CLI with:Access key ID and secret need to be entered in the prompt, find the access key information at your aws page, create an access key if no one exists yet.$ aws configureAWS Access Key ID [None]: AKIAxxxxxxxxxEXAMPLEAWS Secret Access Key [None]: wJalrXUtxxxxxxxxxxxxxxXAMPLEKEYDefault region name [None]: us-west-2Default output format [None]: json
Creating an EKS Cluster using The AWS CLI
In addition to the AWS CLI, this guide uses eksctl - a simple CLI tool for creating clusters on EKS.
To install eksctl, follow Amazon's detailed eksctl installation instructions for linux, mac, and windows.
The creation process typically takes between 15 and 30 minutes. Once it completes, the
kubectl config file will automatically update to use the newly created cluster as the current cluster. To double-check this, run
kubectl config get-context. The new cluster should be marked with a
* in the output.
Creating an EKS Cluster with Terraform
Alternatively, the EKS Cluster can be created using Terraform. To use Terraform, first:
Next, clone the git repository below and
cd into the eks directory (script included below for convenience):
Create the cluster by running the following commands:
yes to confirm.
This process should take around 15-30 minutes.
Once it finishes, view the newly created cluster with:
The following command configures kubectl to use the new cluster.
Verify the cluster is properly setup and accessible.
To install Kalm onto the cluster, see Install Kalm Cloud.