Purpose

the purpose of this beaker-plugin is to extend beaker in a way that it can automatically provision servers at Hetzner Hcloud.

• Hetzner Cloud: https://www.hetzner.com/cloud?country=de
• Main beaker project: https://github.com/voxpupuli/beaker

Background

Beaker, in combination with rspec and serverspec, is the acceptance testing framework. Beakers main job is to prepare an environment where we can run tests. The usual workflow is:

• Spin up a container or VM. This can be local or remote
• Use the hypervisor/API to enable automatic access (usually via ssh key)
• start a whole operating system
• install puppet
• rspec and our helpers will copy puppet code to the target, run it, then validate the system with serverspec

Beaker is very flexible and enhanced with plugins, usually one plugin per hypervisor. the most common ones are:

• Docker - https://github.com/voxpupuli/beaker-docker
• Vagrant (works fine with virtualbox and libvirt as backend) - https://github.com/voxpupuli/beaker-vagrant

We've also some libs:

• https://github.com/voxpupuli/beaker-puppet - brings puppet onto the target
• https://github.com/voxpupuli/beaker-rspec - rspec integration
• https://github.com/voxpupuli/beaker-module_install_helper - can install puppet modules onto targets
• https://github.com/voxpupuli/beaker-hostgenerator - generates a node set (information about the system beaker should create)

And some plugins that also work with other cloud vendors:

• AWS - https://github.com/voxpupuli/beaker-aws
• Google Cloud Platform - https://github.com/puppetlabs/beaker-google

tasks in this gem

• extend beaker-hcloud so it can interact with hetzner cloud
  • automatically create beaker instances with predefined OS templates from hetzner
  • support custom OS images
  • cleanup stale VMs
  • cleanup VMs after jobs are done
  • provide the desired availability zone
• extend beaker-hostgenerator
  • it probably needs some adjustments for the hetzner cloud specific os names: https://github.com/voxpupuli/beaker-hostgenerator/tree/master/lib/beaker-hostgenerator/hypervisor

Hetzner provides ruby API bindings: https://rubygems.org/gems/hcloud. Whereever possible they should be used instead of the API: https://docs.hetzner.cloud/