Chef Serverspec Handler

ABOUT

Chef handler to convert recipe resources into serverspec examples.

INSTALL

gem install chef-serverspec-handler

USAGE

Edit your solo.rb config file to add lines like this:

require 'chef-serverspec-handler'

report_handlers << ChefServerspecHandler.new(:output_dir => '/path/to/dir')

Then run chef with --why-run option (for not affecting your working system):

chef-solo -c solo.rb -j dna.json --why-run

chef-serverspec-handler will be called at the end of the chef run, and generates serverspec examples to /path/to/dir.

input (chef recipe):

template '/var/tmp/template.txt' do
  source 'template.txt.erb'
  mode 0777
  owner 'root'
  group 'root'
  variables(:val1 => 'val1', :val2 => 'val2', :val3 => 'val3')
  action :create
end

output (severspec example):

context file('/var/tmp/template.txt') do
  it {
    should be_file
    should be_mode 777
    should be_owned_by 'root'
    should contain 'val1'
    should contain 'val2'
    should contain 'val3'
  }
end

For more example, see below:

SUPPORTED RESOURCES

resource name	actions
file	create, create_if_missing, touch
cookbook_file	create, create_if_missing
remote_file	create, create_if_missing
directory	create
remote_directory	create, create_if_missing
template	create, create_if_missing
link	create
user	create
group	create
service	start, enable
cron	create

TODO

mount
apt_package
dpkg_package
yum_package
rpm_package

chef-serverspec-handler

Development