Gem Version Build Status Dependency Status Code Climate

A Busser runner plugin for Serverspec


You should use Kitchen::Verifier::Shell + Serverspec instead of Busser::RunnerPlugin::Serverspec.

Installation and Setup

Please read the Busser plugin usage page for more details.


Please put test files into [COOKBOOK]/test/integration/[SUITES]/serverspec/

`-- test
    `-- integration
        `-- default
            `-- serverspec
                |-- Gemfile
                |-- localhost
                |   `-- httpd_spec.rb
                `-- spec_helper.rb

Gemfile is optional. You can specify installing Serverspec version and install gems you need.


File Matching

Globbing pattern to match files is "serverspec/*/*_spec.rb". You need to use "_spec.rb" (underscore), not "-spec.rb" (minus).

Specify Serverspec version

If you have to specify Serverspec version, you can use Gemfile. Example Gemfile:

source 'https://rubygems.org'
gem 'serverspec', '< 2.0'

Serverspec backend

It runs on a target server for testing after ssh log in it. So you need to specify set :backend, :exec not set :backend, :ssh (Serverspec v2). If you use Serverspec v1, you need to specify include SpecInfra::Helper::Exec not include SpecInfra::Helper::Ssh.


Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Created and maintained by HIGUCHI Daisuke ([email protected])


Apache 2.0 (see LICENSE)