This terraform example creates an EKS cluster with workers that run Flatcar Container Linux Pro.
To run this successfully, you'll need to use AWS keys that can create an EKS cluster (with at least these permissions enabled). And have the authentication to that account setup in any of the supported ways.
This example uses the Flatcar Container Linux Pro for AWS offer, which comes with AWS specific optimization and simplified EKS integration. To launch the workers, you'll need to subscribe to the Pro offer with your AWS account.
This only needs to be done once per account. After subscribing, you will be able to launch as many clusters and workers as you need using the Flatcar Container Linux Pro offer. You will be charged an hourly rate on top of the infrastructure cost, according to the pricing scheme. You only get charged for the hours your instances are running.
Typical customization values (region, number of workers, instance type, etc) are split into the variables.tf file. You can modify these values by creating a terraform.tfvars file, or passing them in the command-line (-var name=value).
To create the cluster, this example uses the terraform-aws-eks module. Check out the module documentation if you want to customize other values.
Once you've set the right environment variables and subscribed to the Flatcar Container Linux Pro offer, you can create the cluster by running:
terraform init
terraform apply
This will do a number of validations and if everything is ok will prompt you to confirm that you want those resources to be created.
The EKS worker nodes are not accessible from outside the VPC. You can only interact with the cluster through the generated kubeconfig file. To do that, you'll need aws-iam-authenticator to connect to it using kubectl, passing the generated kubeconfig_<cluster-name> file. As in this example:
$ kubectl --kubeconfig kubeconfig_flatcar-cluster get nodes
NAME STATUS ROLES AGE VERSION
ip-10-0-1-125.us-east-2.compute.internal Ready <none> 20s v1.18.9-eks-d1db3c
ip-10-0-3-208.us-east-2.compute.internal Ready <none> 25s v1.18.9-eks-d1db3c
$ kubectl --kubeconfig kubeconfig_flatcar-cluster get pods -A
NAMESPACE NAME READY STATUS RESTARTS AGE
kube-system aws-node-pq7vc 1/1 Running 0 60s
kube-system aws-node-sw2gw 1/1 Running 0 60s
kube-system coredns-66bc8b7b7b-f4r7s 1/1 Running 0 21m
kube-system coredns-66bc8b7b7b-mpp64 1/1 Running 0 21m
kube-system kube-proxy-fjxpj 1/1 Running 0 60s
kube-system kube-proxy-q4z5s 1/1 Running 0 60s
Please note that it might take a minute for the cluster to be ready after terraform is done setting it up.
The cluster as set up will use compute resources that will be billed to your account. Once you're done using them, you should destroy them, to avoid unnecessary charges. To do that, you can run:
terraform destroy