autonomic-cooperative/molecule-hetznercloud
5
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Molecule Hetzner Cloud driver plugin
61 Commits 3 Branches 10 Tags 251 KiB
Python 99.4%
Makefile 0.6%
d6b8fb11a8
Go to file
Luke Murphy d6b8fb11a8
All checks were successful
continuous-integration/drone/push Build is passing
Details
Shape up wording and remove white space
2020-04-25 08:21:04 +02:00
.github Get CI working with Drone 2020-04-24 13:04:35 +02:00
integration Shorten name 2020-04-25 07:50:45 +02:00
molecule_hetznercloud Remove debug and fix old tasks 2020-04-24 14:59:20 +02:00
.drone.yml Shape up README and fix typo 2020-04-25 08:14:56 +02:00
.envrc.sample Fixup envrc.sample with missing env var 2020-04-24 14:38:24 +02:00
.gitignore Testing configuration cleanup 2020-04-24 10:45:20 +01:00
.pre-commit-config.yaml Fix linters 2020-04-24 14:19:38 +02:00
.yamllint.yml Remove Molecule project cruft 2020-04-24 14:41:40 +02:00
LICENSE Relicense to LGPL 2020-04-24 12:22:29 +02:00
Makefile Remove cruft and shorten dir name 2020-04-24 15:09:25 +02:00
pyproject.toml Shape up package configuration and update deps 2020-04-24 13:24:38 +02:00
pytest.ini Ignore those warnings 2019-11-16 08:05:55 +07:00
README.md Missing capitalisation 2020-04-25 08:18:49 +02:00
setup.cfg Shape up wording and remove white space 2020-04-25 08:21:04 +02:00
setup.py Testing configuration cleanup 2020-04-24 10:45:20 +01:00
tox.ini Get CI working with Drone 2020-04-24 13:04:35 +02:00

README.md

Molecule Hetzner Cloud Plugin

Drone CI-CD PyPI Package Repository License

A Hetzner Cloud plugin for Molecule.

This plugin allows you to do molecule init role myrolename -d hetznercloud and have Molecule provision on-demand Hetzner Cloud VPSes of your choice for your integration testing. New VPSes will be automagically created and provisioned on each molecule test run, SSH keys are generated and managed internally and all resources are cleaned up regardless of whether the role under test succeeds or fails.

Support

If you use this plugin in a commercial setting or you find it personally useful, please support my maintenance work financially through my Liberapay profile or through my Github Sponsor profile. I do not receive any financial support from RedHat or Hetzner Cloud for this work.

Usage

You need to expose a HCLOUD_TOKEN environment variable in your environment. Find out more about how to get one of those over here.

$ export HCLOUD_TOKEN=mycoolapitoken

Then install the required Python package.

$ pip install molecule-hetznercloud
$ molecule init role myrolename -d hetznercloud

Your myrolename/molecule/default/molecule.yml should then look like the following.

---
dependency:
  name: galaxy
driver:
  name: hetznercloud
platforms:
  - name: my-instance-name
    server_type: cx11
    image: debian-10
provisioner:
  name: ansible
verifier:
  name: ansible

Please see docs.hetzner.cloud for information regarding images and server types.

Then just run the role.

$ cd myrolename && molecule test

To ease initial debugging for getting thing started, also expose the following environment variables.

$ export MOLECULE_NO_LOG=False  # not so verbose, helpful
$ export MOLECULE_DEBUG=True  # very verbose, last ditch effort

Mirroring

Issues will be responded to on both issue trackers.

Molecule Documentation

https://molecule.readthedocs.io

Contact

License

The LGPL license.

Testing

This is all done on our drone.autonomic.zone setup.

Unit tests and such.

$ pip install tox
$ tox -v

Integration tests.

(Only doable by Autonomic Cooperative members.)

$ sudo apt install -y direnv
$ cp .envrc.sample .envrc
$ direnv allow
$ pip install -e .
$ cd integration-test-role && molecule test