Browse the Repo

file-type-icon.circleci
file-type-icon_docs
file-type-iconexamples
file-type-iconeks-cluster-managed-workers
file-type-iconeks-cluster-with-iam-role-mappings
file-type-iconeks-cluster-with-supporting-services
file-type-iconeks-fargate-cluster-with-irsa
file-type-iconeks-fargate-cluster-with-supporting-services
file-type-iconeks-fargate-cluster
file-type-iconREADME.md
file-type-iconmodules
file-type-iconrfc
file-type-icontest
file-type-icon.gitignore
file-type-icon.pre-commit-config.yaml
file-type-iconCODEOWNERS
file-type-iconCONTRIBUTING.md
file-type-iconGRUNTWORK_PHILOSOPHY.md
file-type-iconLICENSE.md
file-type-iconREADME.adoc
file-type-iconcore-concepts.md
file-type-iconsetup.cfg

Browse the Repo

file-type-icon.circleci
file-type-icon_docs
file-type-iconexamples
file-type-iconeks-cluster-managed-workers
file-type-iconeks-cluster-with-iam-role-mappings
file-type-iconeks-cluster-with-supporting-services
file-type-iconeks-fargate-cluster-with-irsa
file-type-iconeks-fargate-cluster-with-supporting-services
file-type-iconeks-fargate-cluster
file-type-iconREADME.md
file-type-iconmodules
file-type-iconrfc
file-type-icontest
file-type-icon.gitignore
file-type-icon.pre-commit-config.yaml
file-type-iconCODEOWNERS
file-type-iconCONTRIBUTING.md
file-type-iconGRUNTWORK_PHILOSOPHY.md
file-type-iconLICENSE.md
file-type-iconREADME.adoc
file-type-iconcore-concepts.md
file-type-iconsetup.cfg
EC2 Kubernetes Service (EKS) Cluster

EC2 Kubernetes Service (EKS) Cluster

Deploy a Kubernetes cluster on top of Amazon EC2 Kubernetes Service (EKS).

Code Preview

Preview the Code

mobile file icon

README.md

down

Quickstart Guides and Examples

This folder contains various examples that demonstrate how to use the Terraform Modules provided by this repository. Each example has a detailed README that provides a step by step guide on how to deploy the example. Each example is meant to capture a common use case for the Modules in this repo.

If you are new to EKS and Kubernetes, start with the eks-fargate-cluster example. This example will setup a minimal EKS cluster that you can use to explore:

  • How the modules provision the EKS cluster control plane with Fargate.
  • How to authenticate to the cluster using kubectl.
  • How to authenticate the Terraform kubernetes provider to manage Kubernetes resources using Terraform.

Once you have a basic understanding of the modules and concepts surrounding EKS, Kubernetes, and Terraform, you can move on to the other examples:

Which example should I use for production?

When you are ready to integrate EKS into your infrastructure, we recommend using the eks-fargate cluster-with-supporting-services example or the eks-cluster-with-supporting-services example as a template for your infrastructure code. These examples includes everything you need to get started with running and managing your EKS cluster.

Questions? Ask away.

We're here to talk about our services, answer any questions, give advice, or just to chat.

Ready to hand off the Gruntwork?