Project

bunka

0.01
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
A gem to perform command over parallel ssh connections on multiple chef serverspec. Output is rspec-like.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 11.0
>= 0
>= 0
 Project Readme

Bunka

Parallel ssh commands over chef servers with rspec-like output. Bunka uses the exit codes of a command to determine whether it qualifies as a success or failure.

example

Installation

Requirements

Install the gem:

gem install bunka

Usage

bunka test COMMAND [QUERY] or bunka -t COMMAND [QUERY]

Test command

Test if a given command returns 0 on all nodes:

bunka -t 'test -d /foo/bar/'

Test if a given command does not return 0 on nodes:

bunka -t 'php -i | grep -i memcached' --invert

Test if a given command returns 0 on all nodes, also print out the STDOUT of successfull commands:

bunka -t 'cat /etc/apache2/conf.d/ssl' --print-success

Test if a given command returns 0, scoped on certain nodes (with knife search syntax):

bunka -t 'test -f /etc/apache2/conf.d/ssl' 'recipe:apache AND listen_ports:443'

Note

Bunka is not meant to modify server configurations, only to test how a server replies on a given (non-destructive) command. Use with caution.

To-do

  • Make the output truly RSpec compatible, so we can use RSpec formatters
  • Stop forcing root user, system user (with sudo) should also work
  • bunka should not be limited to Chef (main reason this isn't a knife plugin)

Contributing

Bug reports, feature requests and test implementations are more than welcome. Please use our Github account for this.