beaker-hcloud

A beaker extension for provision Hetzner Cloud instances.

Installation

Include this gem alongside Beaker in your Gemfile or project.gemspec. E.g.

# Gemfile
gem 'beaker', '~> 5.0'
gem 'beaker-hcloud'

# project.gemspec
s.add_runtime_dependency 'beaker', '~> 5.0'
s.add_runtime_dependency 'beaker-hcloud'

Authentication

You need to create an API token using Hetzner's cloud console. Make sure to create the token in the correct project.

beaker-hcloud expects the token to be in the BEAKER_HCLOUD_TOKEN environment variable.

Configuration

Some options can be set to influence how and where server instances are being created:

configuration option	required	default	description
image	true		The name of one of Hetzner's provided images, e.g. ubuntu-20.04, or a custom one, i.e. a snapshot in your account.
server_type	false	cx11	Hetzner cloud server type
location	false	nbg1	One of Hetzner's datacenter locations

Cleanup

In cases where the beaker process is killed before finishing, it may leave resources in Hetzner cloud. These will need to be manually deleted.

Look for servers in your project named exactly as the ones in your beaker host configuration and SSH keys with names beginning with Beaker-.

Contributing

Please refer to voxpupuli/beaker's contributing guide.