jasonumiker / eks-school

eks-school

In order to deploy this EKS Enviroment:

1. Do a git clone https://github.com/jasonumiker/eks-school to clone this project to your home directory
2. Ensure you have nodejs 10 or greater and python 3 or greater installed. On a Mac this is brew install node and brew install python
3. Install the CDK with a sudo npm install -g --upgrade aws-cdk
4. If you have a hosted zone, export CDK_HOSTEDZONEID=<hostedzoneID from console> , export CDK_HOSTEDZONENAME=<domainname.abc.xyz>
5. Paste in the environment variables for temporary admin role access to an account
6. Run ./bootstrap.sh
7. Run ./deploy.sh
8. If you had a hosted zone, go to https://codeserver.<domainname.abc.xyz> , otherwise, find the ALB address and go to it on http://
9. The password is the instance id of EKSEnvironmentStack/CodeServerInstance (find in the EC2 console)
10. Open a new Terminal (click the hamburger in the upper left) and run the command aws eks update-kubeconfig --name cluster
11. Run a kubectl get nodes to confirm everything is working
12. This project should have been git cloned to the bastion - cd to eks-school
13. Run kubectl apply -f nyancat.yaml to deploy a test workload
14. Wait a couple minutes then find the ALB address with a kubectl get ingress -A
15. Go to that address for some nyancat fun...

And then you're ready go go!

Note that because we are accessing VS Code through a insecure HTTP you need to insert into this by going Shift+Insert instead of Ctrl-V. On the Macbook Insert is Fn+Return so it is Shift+Fn+Return.

Direct access from your laptop

The above instructions get you working from a cloud-based VS Code Bastion. Alternatively, the stack has an output with an aws eks update-kubeconfig command that inclues a --role-arn in it. If you run that on your laptop where the AWS CLI is working with an administrative role then that will set up your ~/.kube/config in a way that kubectl will work that way too (as this EKS is Public and Private).

If you'd like to use the Lens IDE then get it from https://github.com/lensapp/lens/releases and run it from the terminal after you have gotten it to a point where kubectl works (so it can see the environment variables you pasted in with our temporary credentials).