Docker Cookbook

See Also
• Video of an ECS 
demo
• ECS 
documentation
8.12 Creating an ECS Cluster
Problem
You are set up to use ECS (see 
Recipe 8.11
). Now you want to create a cluster and
some instances in it to run containers.
8.12 Creating an ECS Cluster | 261

---

Solution
Use the AWS CLI that you installed in 
Recipe 8.11
and explore the new ECS API. In
this recipe, you will learn to use the following:
•
aws ecs list-clusters
•
aws ecs create-cluster
•
aws ecs describe-clusters
•
aws ecs list-container-instances
•
aws ecs delete-cluster
By default, you have one cluster in ECS, but until you have launched an instance in
that cluster, it is not active. Try to describe the default cluster:
$ aws ecs describe-clusters
---------------------------------------------------------------------
| DescribeClusters |
+-------------------------------------------------------------------+
|| failures ||
|+------------------------------------------------------+----------+|
|| arn | reason ||
|+------------------------------------------------------+----------+|
|| arn:aws:ecs:us-east-1:587534442583:cluster/default | MISSING ||
|+------------------------------------------------------+-----------+
Currently you are limited to two ECS clusters.
To activate this cluster, launch an instance using Boto. The AMI used is specific to
ECS and contains the ECS 
agent
. You need to have created an SSH key pair to 
ssh
into the instance, and you need an instance profile associated with a role that has the
ECS policy (see 
Recipe 8.11
):
$ python
...
>>> import boto
>>> c = boto.connect_ec2()
>>> c.run_instances('ami-34ddbe5c', \
key_name='ecs', \
instance_type='t2.micro', \
instance_profile_name='cookbook')