Skip to content

README.md

Latest commit

 

History

History
28 lines (20 loc) · 1.63 KB

README.md

File metadata and controls

28 lines (20 loc) · 1.63 KB

Example Amazon EKS Deployment: Node.js + Express Server

This repository demonstrates a simple deployment of a Node.js + Express server to Amazon EKS using Docker, Kubernetes, and Bash scripting.

Overview

The application is a basic Node.js/Express server that returns the hostname of the Kubernetes pod that handled the request. This is useful for demonstrating load balancing across multiple pods in a cluster.

Key Components

  • Dockerized Application

    A lightweight Node.js server containerized with Docker and published to Docker Hub.

  • Kubernetes Configuration

    • deployment.yml

    • Defines a deployment with 3 replicas. Each pod pulls the Docker image and sets the default platform to linux/amd64, which is required for out-of-the-box compatibility with EC2-based EKS worker nodes. (Attempting to run on linux/arm64 will result in a failed image pull.)

    • service.yml

    • Configures a LoadBalancer service that distributes incoming traffic to the Node.js pods and exposes the application on port 80.

  • Automation Script

    A Bash script automates the following:

    • Builds and pushes the Docker image to Docker Hub
    • Provisions the EKS cluster and applies the Kubernetes manifests
    • Waits for the LoadBalancer service to become available
    • Sends 20 consecutive HTTP requests to the exposed endpoint to demonstrate load balancing across the 3 pods (evidenced by different hostnames in the response)

  • IMPORTANT: EKS is not free tier in AWS, so don't forget to tear down if just doing a temporary project / exercise

    eksctl delete cluster --name basic-node-app-cluster --region <AWS_REGION>