This is a Vagrant plugin that adds a Hetznercloud provider to Vagrant, allowing Vagrant to control and provision machines in Hetznercloud.
NOTE: This is currently a MVP Prototyp (and my first vagrant plugin). Probably the interface will change. Development is tracked at Trello
- Boot Hetznercloud servers (supports types, user_data and ssh_keys)
- SSH into the servers.
- Provision the servers with any built-in Vagrant provisioner.
- Minimal synced folder support via rsync.
Missing Features:
- cli "command" support for listing server types, prieces, datacenters, locations ... everything
- proper cli "command" support with multi machine vagrantfiles
- probably a lot :)
Prior to using this plugin, you will first need to create an API token and identify your organization ID. Please see the following help pages for instructions.
Install using standard Vagrant plugin installation methods.
$ vagrant plugin install vagrant-hetznercloud
Note: As this plugin is not yet released you have to:
- checkout the code
- run $rake build
- vagrant install pkd/plugin.gem
- vagrant box add --name base hetznercloud.box
- Generate Token in the Web GUI of Hetznercloud
Create new API token in the Hetznercloud Console.
- Optional: Install the hcloud cli
If you install the Hetzner cli and configure it with credentials, the vagrant-hetznercloud driver automatically picks up your default context from the ~/.config/hcloud/cli.toml settings file. Therefor you do not need to set the credentials in the environment or in the Vagrantfile.
- Create Vagrantfile
See examples/Vagrantfile for an example Vagrantfile:
- Start your machines
And then run vagrant up and specify the hetznercloud provider:
2.1) With hcloud cli installed and configured
$ vagrant up --provider=hetznercloud
2.1) With Token via environment
$ export HETZNERCLOUD_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxx
$ vagrant up --provider=hetznercloud
2.2) With Token in Vagrantfile
See examples/Vagrantfile.
Note: This is not recommended, as this tends to leak credentials in SCM
FIXME: Write proper documentation
To work on the vagrant-hetznercloud plugin, clone this repository out, and use
Bundler to get the dependencies:
$ bundle
If those pass, you're ready to start developing the plugin. You can test
the plugin without installing it into your Vagrant environment by just
creating a Vagrantfile in the top level of this directory (it is gitignored)
that uses it, and uses bundler to execute Vagrant:
$ bundle exec vagrant up --provider=scaleway
For Debugging you can run:
$ LANG=C VAGRANT_LOG=debug VAGRANT_DEFAULT_PROVIDER=hetznercloud VAGRANT_HOME=~/.vagrant.develop.d bundle exec -- vagrant up
Development is tracked at Trello
Bug reports and pull requests are welcome on GitHub at https://github.com/elconas/vagrant-hetznercloud.
The plugin is available as open source under the terms of the APACHE-2.0.