Quick EKS Cluster Setup with eksctl: A Step-by-Step Guide


Introduction

Most EKS tutorials either go too deep or stay too high level.

You’ll see:

  • Long Terraform setups
  • Complex IAM explanations
  • Too many AWS details

But in reality, getting started with EKS comes down to a simple flow:

πŸ‘‰ Create cluster β†’ Add nodes β†’ Deploy app

This guide focuses on that exact flow using real commands.


1. What you need before starting

Before creating an EKS cluster, make sure you have:

  • AWS account βœ…
  • AWS CLI installed βœ…
  • kubectl installed βœ…
  • eksctl installed βœ…

Basic verification commands

aws --version
kubectl version --client
eksctl version

If these work β†’ you’re ready.


For eksctl installation, please follow below steps

2. Installing eksctl (Simple Setup Guide)

Before creating an EKS cluster, you need the eksctl CLI, which is the official tool used to create and manage EKS clusters.

It simplifies a complex setup into a few commands.


βœ… Prerequisite: AWS CLI configured

First, make sure AWS CLI is installed and configured.

aws --version

If not configured, run:

aws configure

Enter:

  • Access Key
  • Secret Key
  • Default region

πŸ‘‰ eksctl relies on AWS credentials to create clusters [docs.aws.amazon.com]


Install eksctl based on your system


πŸ’» Linux (quick install)

curl --silent --location "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp
sudo mv /tmp/eksctl /usr/local/bin

🍎 macOS (recommended)

brew tap weaveworks/tap
brew install weaveworks/tap/eksctl

πŸͺŸ Windows (simple approach)

Download the latest version from GitHub and:

  • Extract the zip file
  • Add it to your system PATH

OR install using:

choco install eksctl

βœ… Verify installation

After installation, confirm eksctl is working:

eksctl version

βœ… If you see a version β†’ installation successful


βœ… Quick test command

You can run:

eksctl get cluster

πŸ‘‰ If no error appears, your setup is ready for cluster creation.


βœ… Why eksctl matters

Without eksctl, setting up EKS requires:

  • VPC configuration
  • IAM setup
  • Node group creation
  • Networking setup

With eksctl:

πŸ‘‰ A single command can create a full cluster


2. Creating your first EKS cluster

The easiest way is using eksctl.


Command to create cluster

eksctl create cluster \
--name infradecode-cluster \
--region us-west-2 \
--node-type t3.medium \
--nodes 2

What this does

This single command:

  • Creates EKS control plane (managed by AWS)
  • Creates 2 worker nodes (EC2)
  • Configures networking automatically

πŸ‘‰ This is why EKS is powerful β€” setup is simplified.


3. Connecting to your cluster

After cluster creation, configure kubectl:

aws eks --region us-west-2 update-kubeconfig --name infradecode-cluster

Verify cluster access

kubectl get nodes

βœ… You should see your nodes in Ready state


4. Deploy your first application

Now we test if everything works.


Create a simple deployment

kubectl create deployment nginx --image=nginx

Expose service

kubectl expose deployment nginx --type=LoadBalancer --port=80

Check resources

kubectl get pods
kubectl get svc

πŸ‘‰ Your application is now running inside EKS.


5. How EKS actually works behind the scenes

Even though setup looks simple, internally:

  • AWS manages control plane (API server, etcd)
  • You manage nodes and workloads
  • Kubernetes schedules Pods automatically

πŸ‘‰ You still use normal Kubernetes commands.


6. Common issues beginners face


❌ Nodes not visible

Check:

kubectl get nodes

If empty β†’ kubeconfig issue


❌ Pods stuck in Pending

Check:

kubectl describe pod <pod-name>

Usually:

  • Resource issue
  • Networking issue

❌ Service not accessible

Check:

kubectl get svc

Wait for external IP (LoadBalancer can take time).


7. Cleaning up (IMPORTANT to avoid costs)

Always delete cluster after testing.

eksctl delete cluster --name infradecode-cluster --region us-west-2

πŸ‘‰ Otherwise AWS will keep charging.


8. When should you use EKS?

Use EKS when:

  • You want Kubernetes without managing control plane
  • You are working in AWS ecosystem
  • You need production-ready cluster

πŸš€ InfraDecode Takeaway

EKS simplifies Kubernetes setup by managing the control plane for you.
But you still manage nodes, applications, and debugging.
Think of EKS as reducing setup complexity, not Kubernetes complexity.
Learn core Kubernetes first, then EKS becomes much easier to use.


Discover more from

Subscribe to get the latest posts sent to your email.

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top