AWS (EKS)

Before creating the provider, please note that any clusters provisioned via provisioning need to be deleted from Cocktail, not from the EKS console.

Cocktail continuously monitors the status of provisioned clusters. If there are any changes in the EKS console, deleting the cluster from the console will trigger Cocktail to recreate the cluster.

To create a cluster, certain prerequisites need to be completed. Please refer to the following steps

1. Create a Cloud Provider

1) To create a cloud provider for cluster creation, click on the "+ Create" button in the [Provisioning] - [Cloud Providers] tab, and select AWS.

[Screen] Cloud Provider List

2) Register AWS authentication information in the basic information and click the "Save" button.

[Screen] Register AWS Authentication Information

Item (* is required)	Content
Account Name*	Enter the name for the registered AWS account
Description	Enter the description for the AWS account
AWS Access Key ID*	Input AWS Account ID
AWS Secret Access Key*	Input AWS Secret Access Key
AssumeRole ARN	Input AWS AssumeRole ARN value

3) Confirm successful registration.

[Screen] Cloud Provider Configuration Information

2. Create an EKS Cluster

1) [Provisioning] - Navigate to the [Templates] tab, then click the "Start" button under the EKS (Elastic Kubernetes Service)​ item in the templates section

[Screen] Provisioning Template List

2) Select the previously created cloud provider information, choose the required version, and click "Save."

[Screen] EKS Provisioning

Item (* is required)	Content
Account Name*	Select the registered cloud provider
Region*	Select the region for the cluster to be created
Cluster Name*	Register the name of the cluster to be created
Version*	Select the version of the cluster to be created

3) Once saved, the cluster status changes to "CREATING" as it is being provisioned.

[Screen] EKS Cluster Creation List

4) Click on the "CREATING" status to monitor the cluster creation progress.

[Screen] EKS Installation Information (Resource Information)

[Screen] EKS Installation Information (Resource Information)

5) Click on the [Activity] tab to check the ongoing installation details.

[Screen] EKS Installation Information (Activity)

6) Confirm the status changes to "RUNNING" when the cluster is successfully created.

[Screen] Cluster Creation List

To serve the provisioned cluster, addon-manager deployment and storage class deployment are required.

3. Add AWS Node Group

Amazon Node Group creation is possible only after cluster provisioning installation is completed.

1) Once the cluster configuration is complete, select the cluster, go to the [Resources] tab, and click "+ Add Node Group."

[Screen] EKS Installation Information (Resource Information)

2) Enter the required information for the node group to be created and click "Save."

[Screen] EKS Node Addition Information

Item (* is required)	Content
Node Group Name*	Enter the name of the Node to be created
Instance Type*	Select the instance (resource) to be created
Disk Size (GiB)*	Enter the disk capacity of the Node Group to be created
Desired Node*	Enter the number of Node Groups to be created
Min Node Count*	Enter the minimum number of Node Groups to be created when scaling in
Max Node Count*	Enter the maximum number of Node Groups to be created when scaling out

3) When the node group addition starts, the status is displayed in the "Node Group" section.

[Screen] EKS Node Addition Status

4) As the node group addition progresses, the status changes to "ACTIVE."

[Screen] EKS Node Addition Completion Status

5) Check in the [Infrastructure] - [Clusters] tab if the cluster status and the number of nodes are displayed correctly.

[Screen] Cluster Creation List

4. Add Amazon EBS CSI Driver

Amazon EBS CSI Driver creation is possible only when there is more than one node group.

1) Once the node group configuration is complete, select the cluster, go to the [Resources] tab, and click "+ Install Amazon EBS CSI Driver."

2) During the installation process, it takes some time to create resources, and later, confirm the installation completion.

3) Once the Amazon EBS CSI Driver installation is complete, the status is displayed in the "Amazon EBS CSI Driver" section.

4) Confirm the installation of the Amazon EBS CSI Driver in [Workloads] - [Deployments].

5. Add Cluster Autoscaler

The Cluster Autoscaler can be created only when there is more than one node group.

1) Once the node group configuration is complete, select the cluster, go to the [Resources] tab, and click "+ Install Cluster Autoscaler."

2) During the installation process, it takes some time to create resources, and later, confirm the installation completion.

3) Once the installation is complete, the status is displayed in the "Cluster Autoscaler" section.

4) Confirm the installation of the Cluster Autoscaler in [Workloads] - [Deployments].