Learn Chef by doing.
This Lab will help you understand the whole concept of Chef/Chef Server/Chef DK/Knife and all Chef utilities that revolve around provisioning boxes.
The end goal of this project is be able to setup the following:
- Run Chef Server locally on a Vagrant virtual machine.
- Provision 1 load balancer and 2 Web applications through Chef
- Write your own cookbooks and deploy them to Chef Server.
- Write tests for Chef
This would be the end result of this provisioning:
Prerequisites
- Decent command line -> I'm using cmder
- Git -> Install cmder and you will get Git
- VirtualBox
- Vagrant
- Chef Development Kit - ChefDK
Step One - Setting up Chef Server
First you have to clone this repository, open up cmder and clone it.
NOTE: MAKE SURE YOUR SHELL HAS ADMINISTRATOR PRIVILEGES
λ cd C:\
λ mkdir git-repos
λ cd git-repos
λ git clone https://github.com/hyeomans/chef-lab
λ cd chef-lab
Files explanation
Go ahead and inspect the Vagrant file. This file contains Ruby which is pretty straightforward,
in this section you need to take a look at config.vm.define :chef_server do |chef_server_config|
.
If you haven't work with Vagrant, the following lines mean:
- Vagrant will provision an ubuntu box in Virtual box.
- This vagrant box is downloaded from https://atlas.hashicorp.com/ubuntu/boxes/trusty64
- If this is the first time you provision, it will take a while to download.
- The following lines explain themselves, you set the hostname, ip address, a forwarded port (8080 is ubuntu, 80 is your machine), and the RAM for this box.
- The last line before the
end
block is a way to provision boxes for Vagrant. In this case is a bash file.
Now open up provision/bootstrap-chef-server.sh
. Ubuntu need some basic packages for Chef Server, this is the apt-get
portion.
Then your provision script downloads Chef Server deb package and installs it.
All those steps, after installing Chef Server, can be found at their Website, this is what they do:
- Create a first user to be able to log in into Chef Server
- Create an Org and associate the user to this Org.
- Install Chef Manage, this is the Web interface for Chef Server.
- Install Chef Reporting.
The lines modifying the hosts file allow chef-server box to talk to all other nodes without knowing the IP's.
Go back to cmder and type the following:
C:\chef\chef-lab
λ vagrant up chef_server
This will take a while, if you're in Linux/macOS you might get asked for your password. This is OK.
Once that's done you can open up your browser and go to: https://chef-server/
You will get a certificate exception, that's OK you can skip it and continue.
Login with testlabdev
and password password
Step 2 - Configure ChefDK
Make sure that ChefDK is installed and part of you PATH:
C:\chef\chef-lab
λ chef --version
//You should see ChefDK version
Your next step is to download Chef Starter Package from you current Chef Server installation:
- Go to https://chef-server/organizations
- Click testcheflab
- On the left menu search for Starter Kit and click on it.
- Click on "Download Starter Kit"
- Click on "Proceed"
This will download a .zip
file, the objective is two have the chef-starter-repo
next to chef-lab
directory.
Unzip the file and you should have something like this:
C:\chef\
λ dir
//chef-lab
//chefrepo
Chef repo directory is where most of the work would happen. Here you will create cookbook, recipes, assign roles to nodes and make tests for you recipes.
The first step is to make contact with Chef server.
C:\chef\chef-repo
λ knife ssl fetch
λ knife ssl check
λ chef verify
//This last command will take a while
Now you're ready to start creating cookbooks.
Step 3 - Making your first cookbook.
Cookbooks
Cookbooks are the fundamental unit of configuration for our Chef infrastructure. Cookbooks are created on the workstation and then uploaded to a Chef server. Cookbooks serve as a logical foundation of directories rather than something concrete. Recipes is where you would do most of the coding.
Recipes
A recipe is a Ruby file that contains Chef specific domain language to setup you environment. A cookbook has many recipes, is a one to many association.
Recipes can be self-contained, using only Chef Recipes DSL , or they could have external dependencies to other internal/external recipes.
Each recipe is composed by resources. Recipes are a list of resources.
Resources
Chef uses the term resource to describe a part of the system and what state should be in. A resource is, for Chef, a call to their specific API.
When a recipe runs on a desired node (node are whatever you want to provision with Chef), Chef checks the current state per resource and acts upon the desired state of the recipe.
One of the common resources you will constantly work with is called templates.
Templates
Templates are files that have placeholders for string interpolation, just as Razor templates. The difference between Razor and templates is that templates are written in erb language.
Templates have their own folder structure inside a cookbook. From within the templates you can access attributes.
3.1 Leveraging ChefDK to create cookbooks and recipes
By the end of this section you will:
- Create a new nginx cookbook inside the starter folder.
- Create two recipes, one for nginx installation and one for epel packages.
- Create a new template for the index of you nginx installation.
Start by deleting files from starter cookbook you won't need
C:\chef\chef-repo
λ rm -Recurse .\cookbooks\starter\ roles/starter.rb
λ rm -Recurse .\roles\starter.rb
Next step is to generate a new cookbook. Let's start with EPEL
C:\chef\chef-repo
λ cd cookbooks
C:\chef\chef-repo\cookbooks
λ chef generate cookbook epel
Then remove unnecessary git
files and folders:
C:\chef\chef-repo\cookbooks
λ cd epel
C:\chef\chef-repo\cookbooks\epel
λ Remove-Item -Force -Recurse .\.git\
λ Remove-Item -Force -Recurse .\.gitignore
Inside the Epel cookbook, you will create recipe. This recipe will do nothing more than update yum packages and then install common Epel packages.
C:\chef\chef-repo\cookbooks\epel
λ chef generate recipe . install
Inside this recipe, you need to add these two resources:
#cookbooks/epel/recipes/install.rb
execute 'yum update' do
command 'yum update -y'
end
# https://fedoraproject.org/wiki/EPEL/FAQ#What_is_EPEL.3F
yum_package 'epel-release.noarch' do
action :install
end
3.2 Upload your first recipe to Chef Server.
Before creating an nginx
cookbook, you will need to upload your newly created cookbook to Chef Server.
To do that, go back to your command line and type:
C:\chef\chef-repo <--- Make sure you're at the root of the project
λ knife cookbook upload epel
Open up your browser and go to https://chef-server/organizations/testcheflab/cookbooks
You will see your new epel
cookbook now hosted on your local chef server.
3.3 Creating an Nginx cookbook
Now let's create nginx
cookbook, go back to cookbooks directory, and from there execute:
C:\chef\chef-repo\cookbooks
λ chef generate cookbook nginx
C:\chef\chef-repo\cookbooks
λ rm -Recurse -Force .\nginx\.git\
C:\chef\chef-repo\cookbooks
λ rm .\nginx\.gitignore
nginx
recipe will have a dependecy on the epel
cookbook. epel
packages are required in order
to have nginx installed.
Open cookbooks\nginx\metadata.rb
and add:
# cookbooks\nginx\metadata.rb
name 'nginx'
maintainer 'The Authors'
maintainer_email '[email protected]'
license 'all_rights'
description 'Installs/Configures nginx'
long_description 'Installs/Configures nginx'
version '0.1.0'
depends 'epel', '0.1.0' ##Add this line
To fulfill this dependency, we will use berks
command. berks
is part of
Berkshelf. Berkshelf is nothing more than a Nuget package manger. Berkshelf will
locate your cookbooks dependencies and download them locally.
Search for cookbooks\nginx\Berksfile
and add the following:
source :chef_server
metadata
cookbook 'epel'
Go back to your command line and type:
C:\chef\chef-repo\cookbooks\nginx
λ berks install
Next step is to generate an install.rb
recipe:
C:\chef\chef-repo\cookbooks
λ chef generate recipe .\nginx\ install
Add the following resource statements install.rb
:
# cookbooks/nginx/recipes/install.rb
include_recipe 'epel::install'
yum_package 'nginx' do
action :install
end
template '/usr/share/nginx/www/index.html' do
source 'index.erb'
mode '0644'
end
service 'nginx' do
action :start
end
Create a new template with knife:
C:\chef\chef-repo
λ chef generate template cookbooks/nginx index.html.erb
Paste the following template to index.html.erb
:
<!-- cookbooks/nginx/templates/index.html.erb -->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>Hello world</title>
<link rel="stylesheet" href="">
</head>
<body>
<h1>Hi</h1>
<h2>This is webserver <%= node[:fqdn] %></h2>
</body>
</html>
Now you can upload your nginx
cookbook to Chef server:
C:\chef\chef-repo\cookbooks
λ knife cookbook upload nginx
Finally go back to https://chef-server/organizations/testcheflab/cookbooks and you will
see nginx
cookbook in there.
3.4 Creating an Load Balancer cookbook
Creating the load balancer cookbook would be part of the exercise for this lab.
- Investigate how to install HAProxy manually, you can provision a vagrant box for this.
- Once you know you can translate those commands to resources on a new cookbook.
- Upload your new cookbook to Chef server
- I would recommend to learn how to use Kitchen to test your cookbook locally.
Step 4 - Bootstrapping nodes
Go back to the chef-lab
directory and bring up the missing boxes.
C:\chef\\chef-lab
λ vagrant up lb web2 web3
Right now, our web-servers don't know how to communicate to our installation of Chef server. knife
provides an easy way to
do this. Usually you run this once.
C:\chef\chef-repo
λ knife bootstrap web3 -x vagrant -P vagrant --sudo --verbose --node-name web3-node
C:\chef\chef-repo
λ knife bootstrap web2 -x vagrant -P vagrant --sudo --verbose --node-name web2-node
You can go to https://chef-server/organizations/testcheflab/nodes and you will see your new nodes.
Step 4.1 Bootstrap your HAProxy node
Follow the previous steps to bootstrap your load balancer node.
Step 5 - Adding roles
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. When a role is run against a node, the configuration details of that node are compared against the attributes of the role, and then the contents of that 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.
Create a new file under roles directory:
{
"name": "webapp-role",
"description": "Role to configure all web nodes",
"chef_type": "role",
"run_list": [
"recipe[epel::install]",
"recipe[nginx::install]"
]
}
Add the roles to your nodes:
C:\chef\chef-repo
λ knife node run_list add web2-node 'role[webapp-role]'
C:\chef\chef-repo
λ knife node run_list add web3-node 'role[webapp-role]'
Now we have to run chef-client on each of the boxes.
C:\chef
λ cd .\chef-lab\
C:\chef\chef-lab
λ vagrant ssh web2
Inside do this:
[vagrant@web2 ~]$ sudo chef-client
//after it finishes
[vagrant@web2 ~]$ exit
Now do the same for web3:
[vagrant@web3 ~]$ sudo chef-client
[vagrant@web3 ~]$ exit
Now you can visit on your browser: http://web3/ and http://web2/
Step 6 Exercise - Create HA Proxy cookbook.
With the knowledge you have right, you can create another cookbook for your HA Proxy box. What you have to do can be break down like this:
- Create a new cookbook inside
cookbooks
folder. - Search Google how to install
HAProxy
, once you figure the steps out, translate them to Chef recipe(s). HAProxy
should sit between the two web-servers and your clients, for this you will need to modifyHAProxy
configuration, make sure you create the required templates.