Deploy and Manage Kubernetes Cluster in AWS - EKS Cluster

Amazon Elastic Kubernetes Service (Amazon EKS) gives you the flexibility to start, run, and scale Kubernetes applications in the AWS cloud.

Prerequisites

Mandatory:

AWS account with the following IAM permissions :
Terraform ~> 0.14
AWS CLI v2 ~> 2.0

Optional but recommended:

kubectl
wget (required for the eks module)

HLD - Terraform template and tfvars to manage AWS EKS Cluster

Usage

Create a Terraform variable (.tfvars) file containing the following parameters

$ vim my.tfvars

## AWS params and creds
AWS_ACCESS_KEY_ID="<AWS_ACCESS_KEY>"
AWS_SECRET_ACCESS_KEY="<AWS_SECRET_ACCESS_KEY>"
# AWS Region to use, by default "eu-west-3"
AWS_REGION="<AWS_REGION>"

## Cluster params
# Master Name is the name that will be used to prefix all AWS Component (VPC,  to setup your deployment
MASTER_NAME="<MASTER_NAME>"
# Kubernetes version to use, by default "1.20"
K8s_VERSION="<Kubernetes_Version>"
# Type of EC2 instance to use for Worker node
INSTANCE_TYPE="t3.medium"
# MINIMUM WORKER NODE
MIN_WORKER_NODE="3"
# MAXIMUM WORKER NODE
MAX_WORKER_NODE="3"
# DESIRED WORKER NODE
DESIRED_WORKER_NODE="3"

Deploy & Manage

Use Terraform to deploy EKS Cluster

Init and download Terraform plugin and Module

$ terraform init

Plan the deployment and visualize what will be deployed and the changes

$ terraform plan -var-file="<tfvars file>"

Apply the deployment

$ terraform apply -var-file="<tfvars file>"

Destroy the deployment

$ terraform destroy -var-file="<tfvars file>"

Troubleshooting the deployment

Sometimes, depending on the size of the deployed cluster (type of instance, number of nodes defined in the parameters of the EKS cluster), it is possible that the terraform apply falls in error after reaching the timeout. Don't panic, just restart the terraform apply.

Example of errors

│ Error: Error making request: Get "https://BD627AEA2C596BA986969096F8594EC7.gr7.us-east-1.eks.amazonaws.com/healthz": EOF
│
│   with module.eks.data.http.wait_for_cluster[0],
│   on .terraform\modules\eks\cluster.tf line 68, in data "http" "wait_for_cluster":
│   68: data "http" "wait_for_cluster" {

Re Apply the deployment

$ terraform apply -var-file="<tfvars file>"

Connect to EKS Cluster

Show the clusters in AWS

chris@toolbox-chris:~/certs$ aws eks list-clusters --region us-east-1
{
    "clusters": [
        "eks-k8s-chrisley-5c76224e9d"
    ]
}

Update kubeconfig

chris@toolbox-chris:~/certs$ aws eks --region us-east-1 update-kubeconfig --name eks-k8s-chrisley-5c76224e9d

Check the new EKS Cluster context is well set and active in kubeconfig (the one with "*" is active)

chris@toolbox-chris:~/certs$ kubectl config get-contexts
CURRENT   NAME                                                                     CLUSTER                                                                  AUTHINFO                                                                 NAMESPACE
*         arn:aws:eks:us-east-1:005915627013:cluster/eks-k8s-chrisley-5c76224e9d   arn:aws:eks:us-east-1:005915627013:cluster/eks-k8s-chrisley-5c76224e9d   arn:aws:eks:us-east-1:005915627013:cluster/eks-k8s-chrisley-5c76224e9d
          chris-k8s-01                                                             chris-k8s-01                                                             chris-k8s-01
          chris-k8s-01-worker1-rancher                                             chris-k8s-01-worker1-rancher                                             chris-k8s-01

Your cluster is now ready and available. You can deploy applications with kubectl, helm, etc....

chrisley75 / eks Goto Github PK

eks's Introduction

Deploy and Manage Kubernetes Cluster in AWS - EKS Cluster

Prerequisites

Mandatory:

Optional but recommended:

HLD - Terraform template and tfvars to manage AWS EKS Cluster

Usage

Create a Terraform variable (.tfvars) file containing the following parameters

Deploy & Manage

Init and download Terraform plugin and Module

Plan the deployment and visualize what will be deployed and the changes

Apply the deployment

Destroy the deployment

Troubleshooting the deployment

Example of errors

Re Apply the deployment

Connect to EKS Cluster

Show the clusters in AWS

Update kubeconfig

Check the new EKS Cluster context is well set and active in kubeconfig (the one with "*" is active)

Optional - Use Lens IDE to manage your cluster

Download and install LENS Kubernetes IDE

Setup your cluster in LENS

Manage your cluster with LENS

eks's People

Contributors

Watchers

Recommend Projects

Recommend Topics

Recommend Org