Skip to content

Creating Amazon EKS Cluster

Prerequisites

  • An existing VPC with one or more Subnets.

Create an Amazon EKS Cluster

To create an Amazon EKS Cluster,

  1. Click on Clusters in the left menu and click on Add New button at the top right.
  2. Select the EKS Cluster type and click on Continue.
  3. On the Basics page, fill in the following fields:
    1. Provide a unique Name for your Cluster.
    2. A Description to help you identify what this Cluster is for.
    3. Provider - Select the Cloud Account where you would like to provision this Cluster.
    4. Region - Select the Cloud region where you would like to provision this Cluster.
    5. Kubernetes Version - Select the Kubernetes version you would like to run in this Cluster. Unless required specifically, select the latest version.
    6. Access - Configure access for the Control Plane / API Server. For Public Access, Worker node traffic will leave your VPC to connect to the API server. For Public and Private, Worker node traffic to API server traffic will remain within the VPC.
    7. Logging - Select the Checkbox, if you would like to enable Control Plane logs to be collected.

      Note: Turning on Cluster Logging can lead to additional costs charged by the Cloud Provider and can be significant for large / busy clusters.

    8. Tags - Add any Key-Value Tags for your Cluster. Tags are passed down to all the underlying cloud resources created for this cluster.
  4. Select Next.
  5. On the Network page, fill in the following fields:
    1. Select the VPC Network for your cluster. The cluster control plane and worker nodes will be provisioned in this VPC.
    2. Subnet Groups - Subnet Groups are useful to group different Subnets in your VPC and later launch worker nodes in them. When you select a VPC, Quark automatically recommends a default Public and default Private Subnet Group. You can choose to modify or remove them altogether. You can create additional Subnet Groups to suit your needs.

      Note: You need to provide at least one Subnet Group to create a cluster.

    3. Cluster Subnet Group - Select a Subnet Group for the Cluster. The cluster control plane will be provisioned in this Subnet Group.
  6. Select Next.
  7. On the Capacity page, you can create one or more Node Pools for your Cluster. Node Pools are group of Worker Nodes that provide compute capacity to your cluster. A cluster has one default Node Pool and many additional Node Pools that you can add.

    Note: Having multiple Node Pools in a Cluster provides flexibility to manage capacity, availability and workload scheduling.

    For example, you can have a default Node Pool for general purpose workloads and a dedicated Node Pool with GPU instances for workloads that needs GPU. Or, you could have a Node Pool with Spot Instances that can run non-critical workloads and save costs.

    1. Provide a Name for your Node Pool (The default Node Pool's name cannot be changed).
    2. Select a Subnet Group for the Node Pool. All the nodes in the Node Pool will be launched in this Subnet Group.
    3. Select the Architecture of Worker Nodes to be launched in this Node Pool.
    4. Select the Capacity Type for Worker Nodes in this Node Pool.
    5. Select if you need GPU instances in this Node Pool.
    6. Select the Instance Types for Worker Nodes in this Node Pool.
    7. Select the Autoscaling Checkbox, if you would like to enable Autoscaling.
    8. Set the Minimum, Desired and Maximum number of nodes in this Node Pool.
  8. If you need to add more Node Pools, click on the Add Node Pool button to add another Node Pool.

  9. Once you have configured the capacity for your Cluster, click on the Next button.
  10. On the Domains page, you can associate one or more Domains for your cluster. Associated Domains can be used later to create various endpoints for workloads (such as Workspace endpoints, Observability endpoints) deployed in this cluster.

    Note: This step is optional. Domains can also be associated to the Cluster after the cluster is created.

  11. Once you have associated all required Domains, click on the Next button.

  12. On the Settings page , you can add any Key-Value based Properties that you want to associate with your Cluster.
  13. Select Next.
  14. Review all the details you have provided so far. If everything looks good, click on the Submit button.

The cluster creation process will begin and the status of your cluster will initially show Unavailable/Progressing. Cluster creation process takes several minutes and once the cluster is fully ready, the status would change to Available.

Delete a Cluster

To delete your Cluster from Quark,

  1. Click on the Delete icon against the Cluster you wish to delete in the Clusters list page.
  2. A confirmation dialog will appear. Enter any additional details required and click on the Delete button. The Cluster will now be deleted from Quark.

    Note: If this Cluster is currently running any Resources (such as Workspaces, Jobs) created through Quark, then it cannot be deleted. If you want to delete your cluster, you must first delete all of the resources that are associated to it.