Create the new EKS Cluster #

This guide details the steps to create an Amazon EKS cluster directly from the Stackbooster Console, enabling seamless management and monitoring of your Kubernetes workloads.

Prerequisites #

Before you begin, ensure you have completed the following prerequisites:

1. Connect your AWS Account
   Ensure your AWS account is connected to Stackbooster. Refer to the Connect Your AWS Account Guide.

2. Check the AWS Account Quotas
   Verify that your AWS account has the necessary quotas to create EKS clusters. See the Prepare AWS Account Quotas Guide.

3. Install AWS CLI
   Ensure you have installed the AWS CLI on your workstation. If not, follow the instructions.

4. Install kubectl
   Confirm that kubectl, the command-line tool for interacting with Kubernetes clusters, is installed. If not, follow the instructions.

Steps to Create an EKS Cluster #

Step 1: Navigate to the Clusters Section #

1. Log in to the Stackbooster Console.
2. In the main navigation menu, select the Clusters section.
3. Click the Add New button to initiate the cluster creation process.

Step 2: Configure Cluster Parameters #

In the popup window, configure the following parameters:

• AWS Account: Select the AWS account from the dropdown list. This option is available if you have multiple AWS accounts connected to Stackbooster.
• Cluster Name: Enter a unique name for your cluster, e.g., “development”. The cluster name must be unique within your AWS account.
• Region: Choose the region for your cluster deployment.
• SSH Key Name (Optional): Select the SSH key name from your AWS EC2 key pairs. This key will be added to the machines launched by Stackbooster.
• IAM User: Choose the IAM role ARN that will be granted administrative privileges in the cluster. This field is required.

Step 3: Create the Cluster #

1. After configuring the parameters, click the Create button.
2. You will be redirected to a screen displaying the current progress and resource creation status. Cluster provisioning typically takes 10-20 minutes.

Step 4: Install Stackbooster Agents #

1. Once the cluster is provisioned, click the Connect button.
2. You will be presented with commands to run in your workstation’s console.

Command 1: Export EKS Cluster Configuration #

Copy the provided command to export the EKS cluster configuration to your workstation. Ensure the command includes the EKS Cluster Name entered previously. If you have multiple AWS CLI profiles configured, append --profile {profile-name} to the command, replacing {profile-name} with the corresponding profile name.

Command 2: Install Stackbooster Agents #

Copy the second command to install the Stackbooster agents in the newly provisioned cluster. Run this command after the previous step.

Step 5: Verify Cluster Status #

After installing the agents, the cluster status will change to “Active” in the clusters list. Note that some metrics will be displayed after a short period as Stackbooster collects the required information and performs the necessary analysis.