AWS ECS Cluster Creation Documentation

AWS ECS Cluster Creation Documentation

Prerequisites for AWS ECS Cluster Creation:

There must be a registered AWS Account tool with proper Connection credentials verified for the tool to show up in AWS Tool drop down

To Create an AWS Account Tool:

  1. Navigate to Tool Registry and select +New Tool

2. Complete Create New Tool form. For Tool Identifier field, select AWS Account.

3. Select Create Tool and tool will save. When viewing Tool Details, navigate to Connection tab, enter the required values and Save . Select Test Connection to verify that tool is configured properly:

 

ECS Cluster Creation Documentation

To navigate to ECS Cluster Creation:

  1. Select Tasks from the left navigation and click +Create New Task.

2. Select “Create AWS ECS Cluster” from the Type drop down. Once this has been selected, other drop down fields will become available to select to continue creation process.

3. In the Cluster Template drop down, select Networking or EC2.

 

4. Either use an existing VPC or create new VPC by enabling Create VPC toggle. If creating a new VPC, give values to the following fields:

  • VPC CIDR Block

  • Public Subnet CIDR1

 

 

When Cluster Template is EC2 with Create VPC enabled, the following field become available:

  • EC2 Instance Type

  • Key Pair

  • Existing VPC

  • Private Subnets

  • Security Group

**Saving this form will only create a template in the tasks tab. To actually create the cluster the user must click on Run Task following this to trigger the cluster creation.

Cluster Creation

Once the template is created - the user can Run Task to provision a new cluster. If user has already created a cluster from this template, provide a new Cluster Name before selecting Run Task. AWS Does not support creating two clusters with the same name and configuration. Select gear/cog icon to edit Cluster Name in the form.

Activity Logs

To view any logs for this action, view Activity Logs tab which are refreshed as the data comes in from the microservice.

 

Note: User must know the correct values in order to create a cluster as it is a nuanced operation - chances for failures are high unless the user is experienced with AWS infrastructure creation.

 

In case of failures - the user will see the errors that can be viewed in the “Activity Logs” tab.

Click on row to inspect.

Message will display reason for failure.