https://github.com/gregretkowski/vmth

The VMTH (Virtual Machine Test Harness) provides a mechanism to unit-test your infrastructure automation
https://github.com/gregretkowski/vmth

Last synced: 3 months ago
JSON representation

The VMTH (Virtual Machine Test Harness) provides a mechanism to unit-test your infrastructure automation

• Host: GitHub
• URL: https://github.com/gregretkowski/vmth
• Owner: gregretkowski
• License: apache-2.0
• Created: 2011-04-26T19:40:35.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2011-04-28T01:00:10.000Z (over 13 years ago)
• Last Synced: 2024-07-27T19:43:00.068Z (4 months ago)
• Language: Ruby
• Homepage:
• Size: 386 KB
• Stars: 87
• Watchers: 5
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.rdoc
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

README

        
=== Introduction

The VMTH (Virtual Machine Test Harness) provides a mechanism to unit-test your infrastructure automation - puppet policies, chef recipes, release deployment scripts, etc. It uses features of modern VM monitors (like qemu) to snapshot system state, and then reset that state after each test, so that a series of tests can be performed on a VM instance in rapid succession.

It can be integrated with your continuous integration environment and triggered each time a commit is made to your automation code.

=== What it does

It will go through a series of scenarios (a scenario is usualy a service name).  It will run the 'prep' steps, freeze the vm, then run one scenario at a time, and unfreeze after

each scenario.

== Getting started

See QUICKSTART[link:files/QUICKSTART_rdoc.html] to get started.

== Command-line tools

* vmth[link:files/bin/vmth.html]: vm test harness command-line tool

* virb[link:files/bin/virb.html]: Interactive vm test debugger...

== Gochas

Took a while to track down a bug where our VM instance was running out of memory and then crashing. It just appeared that qemu just plain exited without error. traced it to the guest having vm.panic_on_oom to 1 - which causes the kernel to panic and exit if we run out of memory.

Here is the Vmth[link:classes/Vmth.html] class documentation.

== Config file format

See sample_config.yaml[link:files/CONFIG_rdoc.html] for the vmth config file format.

== Support

For support or to report bugs open an issue at the gitub issue tracker:

https://github.com/gregretkowski/vmth/issues