Skip to main content

The CDK Construct Library for AWS::EKS

Project description

AWS Elastic Container Service for Kubernetes (EKS) Construct Library

This construct library allows you to define and create Amazon Elastic Container Service for Kubernetes (EKS) clusters programmatically.


The following example shows how to start an EKS cluster and how to add worker nodes to it:

    const vpc = new ec2.VpcNetwork(this, 'VPC');

    const cluster = new eks.Cluster(this, 'EKSCluster', {

    cluster.addCapacity('Nodes', {
      instanceType: new ec2.InstanceType('t2.medium'),
      desiredCapacity: 1,  // Raise this number to add more nodes

After deploying the previous CDK app you still need to configure kubectl and manually add the nodes to your cluster, as described in the EKS user guide.

SSH into your nodes

If you want to be able to SSH into your worker nodes, you must already have an SSH key in the region you're connecting to and pass it, and you must be able to connect to the hosts (meaning they must have a public IP and you should be allowed to connect to them on port 22):

    const asg = cluster.addCapacity('Nodes', {
      instanceType: new ec2.InstanceType('t2.medium'),
      vpcSubnets: { subnetType: ec2.SubnetType.Public },
      keyName: 'my-key-name',

    // Replace with desired IP
    asg.connections.allowFrom(new ec2.CidrIPv4(''), new ec2.TcpPort(22));

If you want to SSH into nodes in a private subnet, you should set up a bastion host in a public subnet. That setup is recommended, but is unfortunately beyond the scope of this documentation.


  • [ ] Add ability to start tasks on clusters using CDK (similar to ECS's "Service" concept).
  • [ ] Describe how to set up AutoScaling (how to combine EC2 and Kubernetes scaling)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
aws_cdk.aws_eks-0.29.0-py3-none-any.whl (55.7 kB) Copy SHA256 hash SHA256 Wheel py3 (57.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page