/kubernetes-aws

(Deprecated as AWS EKS has been released) CloudFormation template for Kubernetes

MIT LicenseMIT

Kubernetes CloudFormation Template

This repository contains CloudFormation templates for Kubernetes clusters on AWS.

Deprecated: since AWS EKS (https://aws.amazon.com/eks/) has now been released, consider this template to be deprecated.

Single Master Cluster

The single-master-kubernetes.yaml CloudFormation template creates a Kubernetes cluster with a single master node. The peristent files of the master node are stored on EFS.

The current setup requires exactly two subnets for the cluster to be deployed to.

During the initial cluster initialisation with kubeadm, this template also deploys the Flannel (Github) overlay network as well as Traefik (Github) as ingress controller.

Input & Output Parameters

The template has several parameters, the most important ones are

  • VPC & Subnets
  • Versions for Docker, Kubernetes, Flannel and Traefik
  • Instance Types for the master and node instances

The template's output is the load balanced URL for the cluster.

Resources

The following list only outlines the most important resources.

  • Network Load Balancer
    • Routes HTTP(S) traffic to the nodes
    • Routes Kubernetes API (6443) requests to the master
  • Cluster Master
    • EFS
    • Autoscaling Group
    • Launch Configuration
    • Security Group
    • IAM Instance Role
  • Cluster Node
    • Autoscaling Group
    • Launch Configuration
    • Security Group
    • IAM Instance Role

TODO

  • Delete root volume on instance termination
  • Master failover testing