SM4527 / EKS-K8-Dashboard

Deploy Kubernetes Dashboard on an EKS cluster using Terraform & Helm.

Project Title

EKS-K8-Dashboard

Description

Deploy Kubernetes Dashboard on an EKS cluster using Terraform and Helm.

Getting Started

Dependencies

• Docker
• AWS user with programmatic access and high privileges
• Linux terminal
• Deploy an EKS K8 Cluster with Self managed Worker nodes on AWS using Terraform.
• Deploy a Metrics server on the above EKS cluster using Terraform and Helm.
• Deploy a NGINX Ingress on the above EKS cluster (Pod->service->Ingress->ELB+ACM->Route 53->Domain URL).

Installing

• Clone the repository
• Set environment variable TF_VAR_AWS_PROFILE
• Review terraform variable values in variables.tf, locals.tf
• Override values in the Helm chart through the "chart_values.yaml" file
• Update kubernetes.tf with the AWS S3 bucket name and key name from the output of the EKS K8 Cluster

Executing program

• Configure AWS user with AWS CLI.

docker-compose run --rm aws configure --profile $TF_VAR_AWS_PROFILE

docker-compose run --rm aws sts get-caller-identity

• Specify appropriate Terraform workspace.

docker-compose run --rm terraform workspace show

docker-compose run --rm terraform workspace select default

• Run Terraform apply to create the EKS cluster, k8 worker nodes and related AWS resources.

./run-docker-compose.sh terraform init

./run-docker-compose.sh terraform validate

./run-docker-compose.sh terraform plan

./run-docker-compose.sh terraform apply

• Verify K8 Dashboard pod is running and the Ingress is set correctly.

./run-docker-compose.sh kubectl get all -A | grep -i dashboard

./run-docker-compose.sh kubectl describe ingress kubernetes-dashboard -n kube-system

• Retrieve the secret token of the Serviceaccount.

./run-docker-compose.sh kubectl -n kube-system describe sa dashboard-admin

./run-docker-compose.sh kubectl -n kube-system describe secret dashboard-admin-token-< token_name >

• View the K8 dasboard using the Domain Https URL, prefixed by "k8dashboard." and when prompted, enter K8 service account secret token.

Help

• nginx-ingress-not-forwarding-to-dashboard

Issue: The NGINX ingress on EKS cluster is not forwarding to K8 Dashboard.

Fix:  Added the annotations in the K8 helm chart_values.yaml

Reference: https://stackoverflow.com/questions/57813603/nginx-ingress-not-forwarding-to-dashboard

Authors

Sivanandam Manickavasagam

Version History

• 0.1
  • Initial Release

License

This project is licensed under the MIT License - see the LICENSE file for details

Repo rosters

Stargazers