Hetzner Installimage Ansible Role

This is an Ansible role that helps you reinstall the operating system on Hetzner dedicated servers using Hetzner APIs and InstallImage.

Introduction

Hetzner provides dedicated servers with a range of options, from affordable i7 and AMD models to high-performance Xeon processors. They have a rescue system for reinstalling the OS and can set up partitions, RAID, and SSH keys. You can use a web service to reboot servers, activate the rescue system, set up networks, and perform various other tasks.

Requirements & Dependencies

Hetzner

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

Note: Make sure that the default port 22 is accessible from your machine (e.g., whitelisted in the Hetzner firewall).

Ansible

This role has been tested with Ansible versions 2.7 through 2.10.

Variables

For a full reference of configuration variables, see defaults/main.yml. Here are the required variables:

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