Terraform module for creating an AWS EKS cluster
Clone or download


Terraform AWS EKS Module

Terraform configuration to create an AWS EKS cluster

Adapted from https://github.com/terraform-providers/terraform-provider-aws

For details, see https://www.terraform.io/docs/providers/aws/guides/eks-getting-started.html

Configures an AWS account with the following resources:

  • EKS Kubernetes API server
  • VPC with:
    • "" CIDR block
    • 2 subnets, each in a different availability zone with:
      • "10.0.x.0/24" CIDR block
    • Internet gateway
  • EC2 autoscaling group for worker nodes, with:
    • 1-2 m4.large instances
    • 2 subnets



account_id (string)

The AWS account ID that should be used to automatically map IAM users into the Kubernetes cluster


cluster_name (string)

The Kubernetes cluster name (defaults to "cluster")

availability_zones (list)

List of exactly 2 availability zones in which to create the cluster (defaults to ["us-east-1a", "us-east-1b"])


config_map_aws_auth (string)

Kubernetes config map contents in YAML format, used to configure cluster authentication for users and worker nodes

kubeconfig (string)

Kubeconfig file contents, used to configure cluster access for Kubernetes client libraries

Getting started

  1. Apply the configuration:
$ terraform apply
  1. Create a kubeconfig file:
$ terraform output kubeconfig > kubeconfig
  1. Create and apply the config map:
$ terraform output config_map_aws_auth > config_map_aws_auth.yaml && \
KUBECONFIG=kubeconfig kubectl apply -f config_map_aws_auth.yaml
  1. Verify that the worker nodes have joined the cluster:
KUBECONFIG=kubeconfig kubectl get nodes