README.md

Terraform EKS tools

Terraform module which creates Kubernetes tools on AWS EKS.

• ALB Ingress Controller: This module can install the ALB Ingress controller into AWS-managed EKS clusters.

  • see https://docs.aws.amazon.com/eks/latest/userguide/alb-ingress.html
  • see https://github.com/kubernetes-sigs/aws-load-balancer-controller
  • see https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.2/

• External DNS: This module can install the External DNS into AWS-managed EKS clusters.

  • see https://github.com/kubernetes-sigs/external-dns
  • see https://github.com/kubernetes-sigs/external-dns/blob/master/docs/tutorials/aws.md
  • see https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.1/guide/integrations/external_dns/

• Metrics Server: This module can install the Metrics Server into AWS-managed EKS clusters.

  • see https://github.com/kubernetes-sigs/metrics-server
  • see https://kubernetes.io/docs/tasks/debug-application-cluster/resource-metrics-pipeline/
  • see https://docs.aws.amazon.com/eks/latest/userguide/vertical-pod-autoscaler.html

• Cluster Namespaces: This module can create k8s namespaces on the cluster.

Assumptions

• You have created an OpenID Connect (OIDC) identity provider for the EKS cluster.
  • see https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html
  • see https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_openid_connect_provider
  • see https://github.com/terraform-aws-modules/terraform-aws-eks/blob/master/irsa.tf

Usage

module "eks_tools" {
  source = "button-inc/tools/eks"

  cluster_name                  = "eks-dev"
  create_alb_ingress_controller = true
  create_external_dns           = true
  create_metrics_server         = true
  cluster_namespaces            = ["dev", "test", "prod"]
}

Authors

Module is maintained by Junmin Ahn.

License

Apache 2 Licensed. See LICENSE for full details.