AWS Engineering Learning Series - EKS

Launching your Lab Environment

Follow the below steps to get setup with a Cloud9 environment and create your Cluster.

1. Launch a Cloud9 Environment

This will be where you'll be performing the labs throughout the sessions.

Click the button to begin creating a CloudFormation stack for the region you are assigned.

Preferably right click an open it in a new tab.

Region	CloudFormation
eu-west-1 (Ireland)
us-east-1 (N. Virginia)
us-west-2 (Oregon)
ap-southeast-1 (Singapore)

Just before clicking "Create stack" button, please tick "I acknowledge that AWS CloudFormation might create IAM resources."

If you get stuck, the CloudFormation template is available here and also in this repo.

2. Attach the IAM Role to the Cloud9 instance

This will allow your cloud9 environment access to perform the actions needed for the sessions.

This can be done in the EC2 console, navigate to your EC2 instances, or click the link below:

Preferably right click an open it in a new tab.

Region	EC2
eu-west-1 (Ireland)	Console link
us-east-1 (N. Virginia)	Console link
us-west-2 (Oregon)	Console link
ap-southeast-1 (Singapore)	Console link

• Select the Cloud9 instance
• Click Actions > Instance Settings > Attach/Replace IAM Role
• Filter the roles, searching for "cloud9"
• Click Apply once the role is selected

3. Access your Cloud9 environment

This can be done in the Cloud9 console, navigate to Cloud9 or click the link below:

Preferably right click an open it in a new tab.

Region	EC2
eu-west-1 (Ireland)	Console link
us-east-1 (N. Virginia)	Console link
us-west-2 (Oregon)	Console link
ap-southeast-1 (Singapore)	Console link

• Click Open IDE

4. Setup the Cloud9 environment

The environment will be our workstation for the sessions, there are a few steps needed to get it setup

• From within the Cloud9 environment perform the below steps:

  • Click on AWS Cloud9 (top left) > Preferences
  • Click on AWS SETTINGS > Credentials
  • Turn off 'AWS managed temporary credentials'

• Change to a dark theme if you prefer:

  • View > Themes > UI Themes > Classic Dark

Run the below commands in the Cloud9 terminal

Clone the repository

$ git clone https://github.com/aws-els-cpt/eks.git

Run the bootstrap script

The script installs and configures the necessary pre-requisites

$ eks/scripts/bootstrap.sh

Confirm the IAM role is as expected

5. Launch the EKS Cluster

Before launching the cluster with the command below, ensure the IAM role is correct in the previous step.

$ eksctl create cluster --version 1.14 --node-type t3.medium --name eks

The EKS cluster creation process will take about 15-20 minutes

Once complete, 2 Worker Nodes should now be in Ready status

kubectl get nodes

Example output:

NAME                                               STATUS   ROLES    AGE   VERSION
ip-192-168-29-29.eu-west-1.compute.internal   Ready    <none>   27h   v1.14.6-eks-5047ed
ip-192-168-88-24.eu-west-1.compute.internal   Ready    <none>   27h   v1.14.6-eks-5047ed

View the EKS Cluster in the console

To view the EKS Cluster configuration, navigate to EKS in the console or click the link below:

Region	EC2
eu-west-1 (Ireland)	Console link
us-east-1 (N. Virginia)	Console link
us-west-2 (Oregon)	Console link
ap-southeast-1 (Singapore)	Console link

---

Cleanup (Only do this after the end of all three sessions)

After the end of all three sessions, follow the below steps to delete the EKS cluster and Cloud9 environment

Delete the EKS cluster

This can be done in the Cloud9 console, navigate to Cloud9, or click the link below:

Region	EC2
eu-west-1 (Ireland)	Console link
us-east-1 (N. Virginia)	Console link
us-west-2 (Oregon)	Console link
ap-southeast-1 (Singapore)	Console link

• Delete the EKS cluster from the Cloud9 terminal with the below command:

$ eksctl delete cluster eks

Delete the Cloud9 CloudFormation stack

This can be done in the CloudFormation console, navigate to CloudFormation, or click the link below:

Region	EC2
eu-west-1 (Ireland)	Console link
us-east-1 (N. Virginia)	Console link
us-west-2 (Oregon)	Console link
ap-southeast-1 (Singapore)	Console link

There may be a number of stacks, select the stack named "cloud9", and click the "Delete" button