Dokumentation

Hetzner

Hetzner verkauft zwei Dinge über zwei APIs: Cloud, ein gemietetes Projekt aus stündlich abgerechneten virtuellen Servern, und Robot, dedizierte Maschinen mit Monatsvertrag. Diese Seite behandelt die Cloud-Integration, die einzige, die Sie heute einschalten können, und alles darauf folgt aus diesem einen Unterschied: die Hosts gehören Ihnen nicht, also gibt es keinen Knoten zu wählen, keinen Speicher zu bestimmen und keinen Nummernbereich zu vergeben.

Eine Integration ist ein Projekt

Ein Hetzner-API-Token gehört zu genau einem Projekt und sieht außerhalb davon nichts. Ein Konto mit drei Projekten wird bei uns also zu drei Integrationen, jede mit eigenem Token und eigenem Anfragebudget.

Wir können den Projektnamen nicht auslesen, denn Hetzner hat dafür keinen Endpunkt. Geben Sie jeder Integration einen Namen, den Sie wiedererkennen, denn dieser Name ist das Einzige, woran Sie sie im Panel unterscheiden.

Das Token

Ein Feld, und das ist die gesamte Zugangsinformation. Erstellen Sie es in der Hetzner Cloud Console unter Security → API tokens, innerhalb des Projekts, das Provibr verwalten soll.

Wählen Sie Read & Write. Ein Lese-Token verbindet sich problemlos und der Verbindungstest wird grün, denn dieser Test liest nur; er scheitert bei der ersten Schaltfläche, die etwas ändert.
Ein Read-&-Write-Token ist alles oder nichts: keine Scopes, kein Ablaufdatum, keine IP-Beschränkung. Wer es besitzt, kann jeden Server dieses Projekts löschen.
Fügen Sie das Token genau so ein, wie es dort steht. Ein Token mit einem versehentlichen Leerzeichen wird abgelehnt, und Hetzner meldet das genauso wie ein falsches Token.

Das Token geht direkt an Ihren Agenten und wird dort versiegelt. Die Plattform speichert, dass eine Integration existiert, niemals das Token selbst.

Maschinen kommen über den Import

Provibr ignoriert jeden Server, von dem ihm nichts gesagt wurde, deshalb zeigt eine frische Integration eine leere Liste. Öffnen Sie die Integration, starten Sie den Import und kreuzen Sie an, welche Server Sie im Panel haben möchten.

Das ist Absicht: in einem Projekt stehen meist auch Maschinen, die nichts mit Kunden zu tun haben, und sie automatisch zu übernehmen würde sie ungefragt in Ihre Kapazitätszählung setzen.

Was Sie mit einer Maschine tun können

Starten, Stoppen, Herunterfahren, Löschen und Neuaufbau auf einem anderen Image. Löschen ist wirklich Löschen: die Maschine ist weg und die Abrechnung endet. Ein Neuaufbau behält sowohl die IPv4-Adresse als auch den IPv6-Block.

Das Herunterfahren meldet Erfolg, sobald das ACPI-Signal gesendet wurde, nicht sobald der Gast ihm gefolgt ist. Der Status kann danach noch einige Sekunden auf laufend stehen.

Stilllegen gibt es nicht, und das ist keine Lücke

Hetzner berechnet einen Server, solange er existiert, ob er läuft oder nicht. Ihn auszuschalten kostet Ihren Kunden also genauso viel und bringt ihm nichts; Provibr bietet es deshalb nicht an, und die Lizenzdurchsetzung tut es ebenso wenig.

Überschreitet ein Konto sein Limit, meldet Provibr das und verweigert neue Maschinen, schaltet aber keinen Hetzner-Server ab. Der ehrliche Weg, hier Platz zu schaffen, ist das Löschen einer Maschine.

Was es noch nicht gibt

Volumes, Firewalls und primäre IP-Adressen sind bei Hetzner eigenständige Objekte mit eigener Lebensdauer und eigenem Preis. Deshalb gibt es hier keinen Hardware-Tab, keine Firewall-Regeln und keine Adresszuweisung. Pausieren geht ebenfalls nicht: Hetzner kennt selbst kein Stilllegen, deshalb wird eine Maschine über Ihrer Kapazität stattdessen ausgeschaltet.

Robot, die dedizierte Linie von Hetzner, ist eine eigene Integration mit eigenem Host und eigenen Zugangsdaten, und sie verbindet sich noch nicht. Sobald das der Fall ist, bekommt sie auf dieser Seite einen eigenen Abschnitt: die Schritte unterscheiden sich wirklich, also bleiben sie getrennt, statt zu einer einzigen Anleitung zu verschmelzen.

ZurückoVirt WeiterInterServer