# AWS (EKS)

{% hint style="danger" %}
Before creating the provider, please note that any clusters provisioned via provisioning need <mark style="color:red;">**to be deleted from Cocktail**</mark>, 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.
{% endhint %}

#### To create a cluster, certain prerequisites need to be completed. Please refer to the following [steps](/cocktail-cloud-online-en/start/undefined/aws.md)

## 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.

<figure><img src="/files/sk76XFtNBd5XMJVF2Mma" alt=""><figcaption><p>[Screen] Cloud Provider List</p></figcaption></figure>

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

<figure><img src="/files/G3HXBPdcYa1kLOvMq00Y" alt=""><figcaption><p>[Screen] Register AWS Authentication Information</p></figcaption></figure>

<table><thead><tr><th width="399.28205128205127">Item (* is required)</th><th>Content</th></tr></thead><tbody><tr><td>Account Name*</td><td>Enter the name for the registered AWS account</td></tr><tr><td>Description</td><td>Enter the description for the AWS account</td></tr><tr><td>AWS Access Key ID*</td><td>Input AWS Account ID</td></tr><tr><td>AWS Secret Access Key*</td><td>Input AWS Secret Access Key</td></tr><tr><td>AssumeRole ARN</td><td>Input AWS AssumeRole ARN value</td></tr></tbody></table>

3\) Confirm successful registration.

<figure><img src="/files/9682e47zjczclsXyeTxW" alt=""><figcaption><p>[Screen] Cloud Provider Configuration Information</p></figcaption></figure>

## 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

<figure><img src="/files/znVspfsGwsZ3jH7uZ3SP" alt=""><figcaption><p>[Screen] Provisioning Template List</p></figcaption></figure>

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

<figure><img src="/files/71rcj5orirMSkB1YSRvy" alt=""><figcaption><p>[Screen] EKS Provisioning</p></figcaption></figure>

<table><thead><tr><th width="205">Item (* is required)</th><th>Content</th></tr></thead><tbody><tr><td>Account Name*</td><td>Select the registered cloud provider</td></tr><tr><td>Region*</td><td>Select the region for the cluster to be created</td></tr><tr><td>Cluster Name*</td><td>Register the name of the cluster to be created</td></tr><tr><td>Version*</td><td>Select the version of the cluster to be created</td></tr></tbody></table>

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

<figure><img src="/files/uRHpfHbov2XqQPNLG8PU" alt=""><figcaption><p>[Screen] EKS Cluster Creation List</p></figcaption></figure>

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

<figure><img src="/files/CBC0JEW9Qa0qb8Zg1nnL" alt=""><figcaption><p>[Screen] EKS Installation Information (Resource Information)</p></figcaption></figure>

<figure><img src="/files/YtWdLS2upZ14KrnnKELd" alt=""><figcaption><p>[Screen] EKS Installation Information (Resource Information)</p></figcaption></figure>

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

<figure><img src="/files/J3Z4EBGxkcwOp11w0NmL" alt=""><figcaption><p>[Screen] EKS Installation Information (Activity)</p></figcaption></figure>

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

<figure><img src="/files/ghMquThR4exegm5xfqVK" alt=""><figcaption><p>[Screen] Cluster Creation List</p></figcaption></figure>

{% hint style="info" %}
**To serve the provisioned cluster, addon-manager deployment and storage class deployment are required.**
{% endhint %}

## 3. Add AWS Node Group

{% hint style="info" %}
**Amazon Node Group creation is possible only after cluster provisioning installation is completed.**
{% endhint %}

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

<figure><img src="/files/2pr5WDiYS1H9SSyjFhNz" alt=""><figcaption><p>[Screen] EKS Installation Information (Resource Information)</p></figcaption></figure>

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

<figure><img src="/files/WjCWFPHevo5jphxQSVeh" alt=""><figcaption><p>[Screen] EKS Node Addition Information</p></figcaption></figure>

<table><thead><tr><th width="192">Item (* is required)</th><th>Content</th></tr></thead><tbody><tr><td>Node Group Name*</td><td>Enter the name of the Node to be created</td></tr><tr><td>Instance Type*</td><td>Select the instance (resource) to be created</td></tr><tr><td>Disk Size (GiB)*</td><td>Enter the disk capacity of the Node Group to be created</td></tr><tr><td>Desired Node*</td><td>Enter the number of Node Groups to be created</td></tr><tr><td>Min Node Count*</td><td>Enter the minimum number of Node Groups to be created when scaling in</td></tr><tr><td>Max Node Count*</td><td>Enter the maximum number of Node Groups to be created when scaling out</td></tr></tbody></table>

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

<figure><img src="/files/cYo16ukGBcbnH750D4kY" alt=""><figcaption><p>[Screen] EKS Node Addition Status</p></figcaption></figure>

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

<figure><img src="/files/DJK1oU0Nh5m0Dnuf5VfP" alt=""><figcaption><p>[Screen] EKS Node Addition Completion Status</p></figcaption></figure>

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

<figure><img src="/files/pnAGC14PK1DyKMEmsMoH" alt=""><figcaption><p>[Screen] Cluster Creation List</p></figcaption></figure>

## 4. Add Amazon EBS CSI Driver

{% hint style="info" %}
**Amazon EBS CSI Driver creation is possible only when there is more than one node group.**
{% endhint %}

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

<figure><img src="/files/sLc31UWe0JTuw3I7KIw9" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/N2bUaI2bXkarmyclaaMy" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/kei9lLi3dD4euke3mZlt" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/vYJ44kM9ZGo7DTRR7FXo" alt=""><figcaption></figcaption></figure>

## 5. Add Cluster Autoscaler

{% hint style="info" %}
**The Cluster Autoscaler can be created only when there is more than one node group.**
{% endhint %}

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

<figure><img src="/files/vTlqHA8FWaCEuPYNSsg1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/ZbjvddMQqWGl9ES3bvQo" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/VoaBcwYtKaImGQaT5CQf" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/rD33eXOVAKT1qPsLg28I" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cocktailcloud.gitbook.io/cocktail-cloud-online-en/start/clusterscreate/aws.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.