Litmus provides a simple command line tool for Puppet content creators, to enable both simple and complex test deployments against specifically configured target systems. It is available as a gem, and can be installed by running
gem install puppet_litmus.
Litmus allows Puppet module developers to:
- provision targets to test against,
- install the Puppet Agent,
- install a module,
- run tests, and
- tear down the infrastructure.
The tool facilitates parallel test runs, running tests in isolation, and each step is standalone, allowing other operations between test runs, such as debugging, or configuration updates on the test targets.
All our documentation is currently available in the Wiki.
- Overview of the main functions
- Architecture with an explanation of what's going on under the hood
- Step-by-step guide of how to use Litmus with the popular and simple MoTD Puppet module.
- How to guide walking through how to use Litmus in a module
- Helper functions a guide to the various helper functions within Litmus.