How to Create an ECS Cluster on AWS: Simple Steps

To create an ECS cluster, use the AWS CLI command aws ecs create-cluster --cluster-name your-cluster-name. This command sets up a new ECS cluster where you can run and manage your containerized applications.

Syntax

The basic syntax to create an ECS cluster using AWS CLI is:

aws ecs create-cluster --cluster-name <cluster-name>

Here:

• aws ecs create-cluster is the command to create the cluster.
• --cluster-name specifies the name you want to give your ECS cluster.

bash

aws ecs create-cluster --cluster-name my-ecs-cluster

Output

{
    "cluster": {
        "clusterArn": "arn:aws:ecs:region:account-id:cluster/my-ecs-cluster",
        "clusterName": "my-ecs-cluster",
        "status": "ACTIVE",
        "registeredContainerInstancesCount": 0,
        "runningTasksCount": 0,
        "pendingTasksCount": 0,
        "activeServicesCount": 0
    }
}

Example

This example shows how to create an ECS cluster named test-cluster using AWS CLI. After running the command, AWS returns details about the new cluster.

bash

aws ecs create-cluster --cluster-name test-cluster

Output

{
    "cluster": {
        "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/test-cluster",
        "clusterName": "test-cluster",
        "status": "ACTIVE",
        "registeredContainerInstancesCount": 0,
        "runningTasksCount": 0,
        "pendingTasksCount": 0,
        "activeServicesCount": 0
    }
}

Common Pitfalls

• Not specifying --cluster-name will create a cluster with a default name, which can be confusing.
• Trying to create a cluster with a name that already exists will return an error.
• Running the command without AWS CLI configured with proper credentials and region will fail.
• For production, ensure your cluster has proper capacity providers or EC2 instances registered to run tasks.

bash

aws ecs create-cluster
# Wrong: no cluster name specified, creates default cluster

aws ecs create-cluster --cluster-name my-ecs-cluster
# Right: specify a unique cluster name

Quick Reference

Remember these tips when creating an ECS cluster:

• Always use a clear, unique cluster name with --cluster-name.
• Configure AWS CLI with aws configure before running commands.
• Check your AWS region matches where you want the cluster.
• After creating the cluster, add capacity providers or container instances to run tasks.

Key Takeaways

Use the AWS CLI command 'aws ecs create-cluster --cluster-name your-cluster-name' to create an ECS cluster.

Always specify a unique cluster name to avoid conflicts and confusion.

Ensure AWS CLI is configured with credentials and the correct region before creating the cluster.

Creating a cluster alone does not run containers; you must add capacity or services afterward.

Check the command output to confirm the cluster status is ACTIVE.