Hackernoon logoSetting up an etcd cluster on AWS using CoreOS & Terraform by@mlabouardy

Setting up an etcd cluster on AWS using CoreOS & Terraform

Mohamed Labouardy Hacker Noon profile picture

@mlabouardyMohamed Labouardy

DevOps Engineer

This post is part of “IaC” series explaining how to use Infrastracture as Code concepts with Terraform. In this part, I will show you how to setup an etcd cluster on AWS using CoreOS & Terraform as shown in the diagram below :

All the templates used in this demo can be found on my Github.

So let’s start with “variables.tf” file which contains the global variables such as AWS region, cluster instances type …

Note: As of writing this article, the latest stable CoreOS version is 1465.6.0.

So make sure to find an AMI that is as close to the latest version as possible.

Next, we need to define a security group for our cluster. For simplicity, Im going to make this security group open to the world. Even though security is important, this tutorial serves an educational purposes and you should never have all ports open in production.

And finally, we will define our cluster which consists of 3 Nodes:

In order to bring up an etcd cluster, I used a cloud config file that I passed as a parameter to user_data attribut:

Note: Make sure to grab the discovery token, and place it into the discovery parameter:

$ curl https://discovery.etcd.io/new?size=3

Once you defined all templates required, just type the following command to bring up the etcd cluster:

terraform apply

Note: Don’t forget to set the AWS credentials as an envrionment variables before:


Setting up an etcd cluster in action is shown below:

Once done, go to your AWS Management Console then navigate to your EC2 Dashboard:

Congratulations ! You have your CoreOS cluster.

To verify the cluster health, you can either point your browser to the discovery url you generated earlier:

or SSH to one of your cluster nodes using the command:

ssh [email protected]<NODE-IP>

Then, use the etcd command line to fetch the cluster status:

Now we have an etcd cluster ready to use. Let’s see what we can do with it:

  • Through etcdctl:
etcdctl set nginx/port 80
etcdctl get nginx/port 80
etcdctl ls nginx
etcdctl rm nginx/port
  • Through HTTP API:
curl -sS -X PUT -d value=”80" http://localhost:2379/v2/keys/nginx/port | jq ‘.’ # Create
curl -sS http://localhost:2379/v2/keys/nginx/port | jq ‘.’ # Get
curl -sS -X DELETE http://localhost:2379/v2/keys/nginx/port | jq ‘.’ # Delete


Join Hacker Noon

Create your free account to unlock your custom reading experience.