Home

Awesome

Beaker

License Test codecov Release RubyGem Version RubyGem Downloads Donated by Puppet Inc

Beaker is a test harness focused on acceptance testing via interactions between multiple (virtual) machines. It provides platform abstraction between different Systems Under Test (SUTs), and it can also be used as a virtual machine provisioner - setting up machines, running any commands on those machines, and then exiting.

Beaker runs tests written in Ruby, and provides additional Domain-Specific Language (DSL) methods. This gives you access to all standard Ruby along with acceptance testing specific commands.

Installation

See Beaker Installation.

Documentation

Documentation for Beaker can be found in this repository in the docs/ folder.

Table of Contents

Beaker Libraries

Beaker functionality has been extended through the use of libraries available as gems. See the complete list for available gems. See the beaker-template documentation for documentation on creating beaker-libraries.

Support & Issues

Please log tickets and issues at our Beaker Issue Tracker. In addition there is an active #puppet-dev channel on Freenode.

For additional information on filing tickets, please check out our CONTRIBUTOR doc, and for ticket lifecycle information, check out our ticket process doc.

Contributing

If you'd like to contribute improvements to Beaker, please see CONTRIBUTING.

Maintainers

For information on project maintainers, please check out our CODEOWNERS doc.

Transfer Notice

This plugin was originally authored by Puppet Inc. The maintainer preferred that Puppet Community take ownership of the module for future improvement and maintenance. Existing pull requests and issues were transferred over, please fork and continue to contribute here.

Previously: https://github.com/puppetlabs/beaker

License

This gem is licensed under the Apache-2 license.

Release information

To make a new release, please do: