Skip to main content

Bootstrapping EC2 Instances with Chef

This is a guest post from 47Line Technologies
In the previous blogs, we  introduced Chef and setup the Chef Server, Workstation on EC2 instances. Please refer to the earlier blogs here.
Configuration Management – Introducing Chef
Getting Started with Chef on Amazon AWS
In the blog, we will look into bootstrapping EC2 instances with Chef.
The bootstrapping process involves setting up a Chef Client on a node. Chef Client Communicates with the Chef Server to receive directions for its own configuration. After the client receives the policy, it applies to the node to ensure the client is configured as per the directions of the server.
Knife-ec2 is official Chef Knife plugin for EC2. This plugin gives knife the ability to create, bootstrap, and manage EC2 instances.
Install the knife-ec2 plugin on your workstation

sudo apt-get install gcc g++ make autoconf
sudo apt-get install libxml2 libxml2-dev libxslt1-dev
sudo /opt/chef/embedded/bin/gem install nokogiri -v '1.5.2' -- --with-xml2-lib=/usr/lib/i386-linux-gnu --with-xml2-include=/usr/include/libxml2 --with-xslt-lib=/usr/lib/i386-linux-gnu --with-xslt-include=/usr/include/libxslt
sudo /opt/chef/embedded/bin/gem install knife-ec2 –V

The plugin provides the following sub-commands. Use the — help flag to find specific command options.

knife ec2 server create
knife ec2 server delete
knife ec2 server list

On the workstation, create the required cookbooks and upload to the Chef Server.

cd ~/chef-repo/cookbooks/
#clone the repositories from github
git clone
git clone
git clone
git clone
# upload the cookbooks to the server
knife cookbook upload java apt
knife cookbook upload openssl tomcat

A role is a way to define certain patterns and processes that exist across nodes in an organization as belonging to a single job function. Each role consists of zero (or more) attributes and a run list. Each node can have zero (or more) roles assigned to it.
We will create a “tomcatwebapp” role and then use it bootstrap an EC2 instance.

export EDITOR=$(which vi)
# Create tomcatwebapp role
knife role create tomcatwebapp

the command will open up the vim editor, edit the file contents as below.

"name": "tomcatwebapp",
 "description": "Install Java and Tomcat",
"json_class": "Chef::Role", 
"default_attributes": {  }, 
"chef_type": "role",
"run_list": [  "recipe[apt]",  "recipe[tomcat]  ], 
"env_run_lists": {   }, 
"override_attributes": {  }

Login to the Chef Server and navigate to the Roles tab, you must see the role we created.

Now we are all set to bootstrap an EC2 instance with the tomcatwebapp role with the following command.

knife ec2 server create -I ami-3c39686e -r "role[tomcatwebapp]" -Z ap-southeast-1a --groups Chef-SecGrp -S chef -i chef.pem -f m1.medium -A 'AKIXXXXXXXXXXXXXXXXXX' -K "XXXXXXXXXXXXXXXXXXXXXXX" --region ap-southeast-1 --ssh-user ubuntu

A m1.medium EC2 instance will be launched in the ap-southeast-1a zone with the given group and key name.  The role ‘tomcatwebapp’ will be applied to the instance as well.
When the role ‘tomcatwebapp’ is run against the node, the configuration details of that node are compared against the attributes of the role, and then the contents of the role’s run list are applied to the node’s configuration details. When a chef-client runs, it merges its own attributes and run lists with those contained within each assigned role.
On the Chef Server, we will be able to list the nodes and see the node with the tomcatwebapp role.

In the next blog, we will introduce creating cookbooks and recipes.
Contributed by Santhosh Daivajna, Senior Cloud Consultant at 47Line Technologies

Written by

47Line is building solutions solving critical business problems using “cloud as the backbone”. The team has been working in Cloud Computing domain for last 6 years and have proven thought leadership in Cloud, Big Data technologies.

Related Posts

— November 28, 2018

Two New EC2 Instance Types Announced at AWS re:Invent 2018 – Monday Night Live

Let’s look at what benefits these two new EC2 instance types offer and how these two new instances could be of benefit to you. Both of the new instance types are built on the AWS Nitro System. The AWS Nitro System improves the performance of processing in virtualized environments by...

Read more
  • AWS
  • EC2
  • re:Invent 2018
— November 21, 2018

Google Cloud Certification: Preparation and Prerequisites

Google Cloud Platform (GCP) has evolved from being a niche player to a serious competitor to Amazon Web Services and Microsoft Azure. In 2018, research firm Gartner placed Google in the Leaders quadrant in its Magic Quadrant for Cloud Infrastructure as a Service for the first time. In t...

Read more
  • AWS
  • Azure
  • Google Cloud
Khash Nakhostin
— November 13, 2018

Understanding AWS VPC Egress Filtering Methods

Security in AWS is governed by a shared responsibility model where both vendor and subscriber have various operational responsibilities. AWS assumes responsibility for the underlying infrastructure, hardware, virtualization layer, facilities, and staff while the subscriber organization ...

Read more
  • Aviatrix
  • AWS
  • VPC
— November 10, 2018

S3 FTP: Build a Reliable and Inexpensive FTP Server Using Amazon’s S3

Is it possible to create an S3 FTP file backup/transfer solution, minimizing associated file storage and capacity planning administration headache?FTP (File Transfer Protocol) is a fast and convenient way to transfer large files over the Internet. You might, at some point, have conf...

Read more
  • Amazon S3
  • AWS
— October 18, 2018

Microservices Architecture: Advantages and Drawbacks

Microservices are a way of breaking large software projects into loosely coupled modules, which communicate with each other through simple Application Programming Interfaces (APIs).Microservices have become increasingly popular over the past few years. The modular architectural style,...

Read more
  • AWS
  • Microservices
— October 2, 2018

What Are Best Practices for Tagging AWS Resources?

There are many use cases for tags, but what are the best practices for tagging AWS resources? In order for your organization to effectively manage resources (and your monthly AWS bill), you need to implement and adopt a thoughtful tagging strategy that makes sense for your business. The...

Read more
  • AWS
  • cost optimization
— September 26, 2018

How to Optimize Amazon S3 Performance

Amazon S3 is the most common storage options for many organizations, being object storage it is used for a wide variety of data types, from the smallest objects to huge datasets. All in all, Amazon S3 is a great service to store a wide scope of data types in a highly available and resil...

Read more
  • Amazon S3
  • AWS
— September 18, 2018

How to Optimize Cloud Costs with Spot Instances: New on Cloud Academy

One of the main promises of cloud computing is access to nearly endless capacity. However, it doesn’t come cheap. With the introduction of Spot Instances for Amazon Web Services’ Elastic Compute Cloud (AWS EC2) in 2009, spot instances have been a way for major cloud providers to sell sp...

Read more
  • AWS
  • Azure
  • Google Cloud
— August 23, 2018

What are the Benefits of Machine Learning in the Cloud?

A Comparison of Machine Learning Services on AWS, Azure, and Google CloudArtificial intelligence and machine learning are steadily making their way into enterprise applications in areas such as customer support, fraud detection, and business intelligence. There is every reason to beli...

Read more
  • AWS
  • Azure
  • Google Cloud
  • Machine Learning
— August 17, 2018

How to Use AWS CLI

The AWS Command Line Interface (CLI) is for managing your AWS services from a terminal session on your own client, allowing you to control and configure multiple AWS services.So you’ve been using AWS for awhile and finally feel comfortable clicking your way through all the services....

Read more
  • AWS
Albert Qian
— August 9, 2018

AWS Summit Chicago: New AWS Features Announced

Thousands of cloud practitioners descended on Chicago’s McCormick Place West last week to hear the latest updates around Amazon Web Services (AWS). While a typical hot and humid summer made its presence known outside, attendees inside basked in the comfort of air conditioning to hone th...

Read more
  • AWS
  • AWS Summits
— August 8, 2018

From Monolith to Serverless – The Evolving Cloudscape of Compute

Containers can help fragment monoliths into logical, easier to use workloads. The AWS Summit New York was held on July 17 and Cloud Academy sponsored my trip to the event. As someone who covers enterprise cloud technologies and services, the recent Amazon Web Services event was an insig...

Read more
  • AWS
  • AWS Summits
  • Containers
  • DevOps
  • serverless