AWS ECS Cluster Creation Task Documentation

Owned by Christina
Last updated: Nov 19, 2021
4 min read

Use the following instructions to create an AWS ECS Cluster template then run the task to create a cluster. Setup requires experience with AWS infrastructure creation There are 2 steps to cluster creation. Template creation is a prerequisite to creating the cluster. Once the template has been created, you must select Run Task for the first cluster to be created.

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

AWS ECS Cluster Template 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.

  • AWS Tool - Select an established AWS tool from the Tool Registry.

  • Cluster Template - Select Networking/Fargate or EC2.

  • Cluster Name - Create a unique name for your cluster.

  • Image Type - Select Windows or Linux/Unix

  • Create VPC - 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

  • EC2 Instance Type - Select a value from the list fetched from the AWS portal.

  • Key Pair - Find this value in the AWS portal in EC2.

  • Existing VPC - Select an existing VPC from the list of values fetched from the AWS portal.

  • Private Subnets - Both subnets should be from different availability zones. Maximum 2 subnets preferred.

  • Security Group - Select a value from the list fetched from the AWS portal.

 

 

 

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

5. Click the ‘Create’ button to save the template.

Note: 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.

AWS Cluster Creation Documentation

Once the template is created using the steps above- 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.