Non eksctl-created clusters¶

From eksctl version 0.40.0 users can run eksctl commands against clusters which were not created by eksctl.

Note

Eksctl can only support unowned clusters with names which comply with the guidelines mentioned here. Any cluster names which do not match this will fail CloudFormation API validation check.

Supported commands¶

The following commands can be used against clusters created by any means other than eksctl. The commands, flags and config file options can be used in exactly the same way.

If we have missed some functionality, please let us know.

Creating nodegroups¶

eksctl create nodegroup is the only command which requires specific input from the user.

Since users can create their clusters with any networking configuration they like, for the time-being, eksctl will not attempt to retrieve or guess these values. This may change in the future as we learn more about how people are using this command on non eksctl-created clusters.

This means that in order to create nodegroups or managed nodegroups on a cluster which was not created by eksctl, a config file containing VPC details must be provided. At a minimum:

---
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name: non-eksctl-created-cluster
  region: us-west-2

vpc:
  id: "vpc-12345"
  securityGroup: "sg-12345"    # this is the ControlPlaneSecurityGroup
  subnets:
    private:
      private1:
          id: "subnet-12345"
      private2:
          id: "subnet-67890"
    public:
      public1:
          id: "subnet-12345"
      public2:
          id: "subnet-67890"

...

Further information on VPC configuration options can be found here.