molecule-hetznercloud/README.md

119 lines
3.4 KiB
Markdown
Raw Normal View History

# Molecule Hetzner Cloud Plugin
2020-04-24 11:15:45 +00:00
[![Drone CI-CD](https://drone.autonomic.zone/api/badges/autonomic-cooperative/molecule-hetznercloud/status.svg)](https://drone.autonomic.zone/autonomic-cooperative/molecule-hetznercloud)
[![PyPI Package](https://badge.fury.io/py/molecule-hetznercloud.svg)](https://badge.fury.io/py/molecule-hetznercloud)
[![Repository License](https://img.shields.io/badge/license-LGPL-brightgreen.svg)](LICENSE)
2020-04-25 06:14:56 +00:00
A [Hetzner Cloud](https://www.hetzner.com/cloud) plugin for [Molecule](https://molecule.readthedocs.io/en/latest/).
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
2020-04-25 06:16:06 +00:00
internally and all resources are cleaned up regardless of whether the role
under test succeeds or fails.
2020-04-25 06:14:56 +00:00
## Support
2020-04-25 06:17:16 +00:00
If you use this plugin in a commercial setting or you find it personally
2020-04-25 06:17:46 +00:00
useful, please support my maintenance work financially through my
[Liberapay](https://liberapay.com/decentral1se/) profile or through my [Github
Sponsor profile](https://github.com/sponsors/decentral1se). I do not receive
any financial support from RedHat or Hetzner Cloud for this work.
2020-04-24 11:15:45 +00:00
## Usage
2020-04-25 06:14:56 +00:00
You need to expose a `HCLOUD_TOKEN` environment variable in your environment.
2020-04-25 06:18:49 +00:00
Find out more about how to get one of those [over here](https://docs.hetzner.cloud/#overview-authentication).
2020-04-25 06:14:56 +00:00
```bash
$ export HCLOUD_TOKEN=mycoolapitoken
```
Then install the required Python package.
```bash
$ pip install molecule-hetznercloud
$ molecule init role myrolename -d hetznercloud
```
Your `myrolename/molecule/default/molecule.yml` should then look like the following.
```yaml
---
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](https://docs.hetzner.cloud/) for information regarding images and server types.
Then just run the role.
```bash
$ cd myrolename && molecule test
```
To ease initial debugging for getting thing started, also expose the following
environment variables.
```bash
$ export MOLECULE_NO_LOG=False # not so verbose, helpful
$ export MOLECULE_DEBUG=True # very verbose, last ditch effort
```
2020-04-24 11:15:45 +00:00
## Mirroring
2020-04-25 06:14:56 +00:00
Issues will be responded to on both issue trackers.
- [git.autonomic.zone](https://git.autonomic.zone/autonomic-cooperative/molecule-hetznercloud) (primary)
- [github.com](https://github.com/ansible-community/molecule-hetznercloud) (mirror)
2020-04-25 06:24:39 +00:00
## Change log
See [CHANGELOG.md](./CHANGELOG.md).
2020-04-24 11:15:45 +00:00
## Molecule Documentation
2020-04-24 11:15:45 +00:00
> https://molecule.readthedocs.io
2020-04-24 11:15:45 +00:00
## Contact
2020-04-25 06:14:56 +00:00
- Ping @decentral1se on the `#ansible-molecule` channel on [Freenode](https://webchat.freenode.net).
2020-04-24 11:15:45 +00:00
## License
2020-04-25 06:34:01 +00:00
The [LGPLv3](https://www.gnu.org/licenses/lgpl-3.0.en.html) license.
2020-04-24 12:12:57 +00:00
## Testing
2020-04-25 06:14:56 +00:00
This is all done on our [drone.autonomic.zone](https://drone.autonomic.zone/autonomic-cooperative/molecule-hetznercloud) setup.
2020-04-24 12:12:57 +00:00
Unit tests and such.
```bash
$ pip install tox
$ tox -v
```
Integration tests.
2020-04-25 06:18:49 +00:00
(Only doable by [Autonomic Cooperative](https://autonomic.zone/) members.)
2020-04-24 12:12:57 +00:00
```bash
$ sudo apt install -y direnv
$ cp .envrc.sample .envrc
$ direnv allow
$ pip install -e .
$ cd integration-test-role && molecule test
```