Hetzner Installimage Ansible Role

Ansible role for re-installing OS on Hetzner dedicated servers using Hetzner APIs and InstallImage

Introduction

Hetzner offers dedicated servers ranging from cheap i7, AMD to high performance Xeon processors. They offer a rescue system for reinstalling the OS, configure the basics like partitions, RAID and SSH keys. A webservice can be used to reboot servers, activate the rescue system, perform network setup and many others operations.

Requirements & Dependencies

Hetzner

• dedicated Hetzner Root server
• SSH key added to the Key Management
• WebService activated with user/pass (https://robot.your-server.de/preferences/index)

PS: make sure that you the default port 22 is accesible from your machine (ex: whitelisted in the hetzner firewall)

Ansible

This role was tested against Ansible version 2.7 2.8 2.9 2.10

Variables

For a full reference of the configuration variables checl defaults/main.yml. The required variables are:

robotws_user: username
robotws_password: password

image:
  distro: ubuntu
  version: 20.04

Example

# inventory
[servers]
1.2.3.4 hostname=node1
node2.example.com

# playbook.yml
- hosts: servers
  roles:
    - mariancraciun1983.hetzner_install_image

# install the role
ansible-galaxy install mariancraciun1983.hetzner_install_image

# run the playbook
ansible-playbook -i inventory playbook.yml

License

MIT License