!Release

cdk-eksdistro

CDK construct library that allows you to create Amazon EKS Distro on Amaozn EC2 instance(s).

How it works

Under the hood, cdk-eksdistro creates an Amazon Auto Scaling Group with single Amazon EC2 instance running Ubuntu Linux LTS 20.04 and installs the eks snap from the UserData.

Install

Use the npm dist tag to opt in CDKv1 or CDKv2:

``sh
// for CDKv2
npm install cdk-eksdistro
or
npm install cdk-eksdistro@latest

// for CDKv1
npm install cdk-eksdistro@cdkv1
`

Sample

`ts
imoprt { Cluster } from 'cdk-eksdistro';

const app = new cdk.App();

const env = {
region: process.env.CDK_DEFAULT_REGION,
account: process.env.CDK_DEFAULT_ACCOUNT,
};

const stack = new cdk.Stack(app, 'eksdistro-stack', { env });

new Cluster(stack, 'Cluster');
`

Spot Instance

To create Amazon EC2 Spot instance instead of on-demand, use the spot property:

`ts
new Cluster(stack, 'Cluster', { spot: true });
`

Validate the cluster

By default, the Cluster construct creates a single-node EKS-D cluster on AWS EC2 with the latest Ubuntu Linux LTS AMI. To validate the cluster, open the EC2 console, select the instance and click the Connect button and select session manager.

Run the following commands to execute kubectl` in the cluster.


Reference

- https://aws.amazon.com/blogs/opensource/introducing-amazon-eks-distro/
- https://ubuntu.com/blog/install-amazon-eks-distro-anywhere
- https://microk8s.io/
- https://snapcraft.io/microk8s