convert chef cookbooks to serverspec examples
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
generated-spec
lib
spec
.document
.gitignore
.rspec
Gemfile
Gemfile.lock
LICENSE.txt
README.md
Rakefile
VERSION
chef-serverspec-handler.gemspec

README.md

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

SEE ALSO