rapid-eks

Rapid AWS EKS deployment in under 30 minutes.

# Homebrew (macOS)
brew tap jtaylortech/rapid-eks
brew install rapid-eks

# pip
pip install git+https://github.com/jtaylortech/rapid-eks.git

rapid-eks create my-cluster --region us-east-1

---

Why?

Setting up EKS manually takes 2-4 weeks. rapid-eks does it in under 30 minutes with best practices built-in.

What you get:

• Multi-AZ VPC (3 AZs, 6 subnets, 3 NAT gateways)
• EKS cluster with OIDC provider
• Managed nodegroup (2-4 nodes, autoscaling)
• Karpenter (node autoscaler)
• AWS Load Balancer Controller
• Prometheus + Grafana

Validated: 13 min deploy, 17 min destroy, $0.33/hour

New in v0.2.0:

• --nat-gateway-type fck-nat - Save ~$86/month on NAT costs
• --auth-mode pod-identity - Modern alternative to IRSA (EKS 1.24+)
• rapid-eks eject - Export standalone Terraform

---

Quick Start

Prerequisites

# AWS credentials configured
aws configure

# Terraform installed
brew install terraform  # or: https://terraform.io

Install

Homebrew (macOS):

brew tap jtaylortech/rapid-eks
brew install rapid-eks

pip:

pip install git+https://github.com/jtaylortech/rapid-eks.git

Deploy

# Create cluster
rapid-eks create my-cluster --region us-east-1

# Connect
aws eks update-kubeconfig --region us-east-1 --name my-cluster
kubectl get nodes

# Destroy
rapid-eks destroy my-cluster --auto-approve

---

Configuration

Create rapid-eks.yaml:

cluster:
  name: prod-cluster
  region: us-west-2
  version: "1.31"

nodegroups:
  - name: general
    instance_type: t3.large
    min_size: 3
    max_size: 10

addons:
  - prometheus
  - karpenter
  - alb-controller

tags:
  Environment: production
  Team: platform

rapid-eks create prod-cluster --config rapid-eks.yaml

---

What Gets Deployed

Resource	Configuration
VPC	3 AZs, /16 CIDR, public + private subnets
NAT Gateways	3 (one per AZ, HA)
EKS Cluster	Latest stable, OIDC enabled
Nodegroup	t3.medium, 2-4 nodes, autoscaling
Karpenter	Node autoscaler with IRSA
ALB Controller	Load balancer integration with IRSA
Prometheus	Monitoring + Grafana

Cost: ~$240/month (minimal cluster)

• EKS control plane: $73/month
• 2x t3.medium: ~$60/month
• 3x NAT gateways: ~$96/month
• Data transfer + EBS: ~$11/month

---

Commands

# Create cluster
rapid-eks create <name> --region <region>

# Destroy cluster
rapid-eks destroy <name> --auto-approve

# Validate config
rapid-eks validate <config-file>

---

Documentation

• Configuration Reference - All config options
• Architecture - How it works under the hood
• Addons - Addon configuration
• Troubleshooting - Common issues
• FAQ - Frequently asked questions
• Contributing - Contribution guide

---

Development

# Clone
git clone https://github.com/jtaylortech/rapid-eks.git
cd rapid-eks

# Install
poetry install

# Test
poetry run pytest -v

# Run locally
poetry run rapid-eks create test-cluster --region us-east-1

---

Contributing

Contributions welcome! See docs/CONTRIBUTING.md.

We need:

• Bug reports
• Feature requests
• Documentation improvements
• Code contributions

---

Support

Free, open source (MIT License). Community support via GitHub Issues.

Need help? Implementation services available for enterprise deployments.
Contact: jtaylortechnologies@gmail.com

---

Support rapid-eks

If rapid-eks saves you time and effort deploying EKS clusters, consider supporting its development:

💖 Sponsor on GitHub | Learn more

Your sponsorship helps:

• Maintain compatibility with latest AWS/EKS versions
• Add support for new addons and integrations
• Provide timely bug fixes and security updates
• Keep the project free and open-source forever

Current Sponsors

Thank you to all sponsors! Your support makes rapid-eks possible.

---

License

MIT License - See LICENSE

---

Ready to deploy EKS in under 30 minutes? Star the repo | Report issues | Contribute