Naar de inhoud

Documentatie

Hetzner

Hetzner verkoopt twee dingen via twee API-koppelingen: Cloud, een gehuurd project met virtuele servers die per uur afrekenen, en Robot, dedicated machines met een maandcontract. Deze pagina gaat over de Cloud-koppeling, de enige die je vandaag kunt aanzetten, en alles erop volgt uit dat ene verschil: de hosts zijn niet van jou, dus er is geen node te kiezen, geen storage aan te wijzen en geen nummerreeks uit te delen.

Eén integratie is één project

Een Hetzner-API-token hoort bij precies één project en ziet daarbuiten niets. Een account met drie projecten wordt bij ons dus drie integraties, elk met een eigen token en een eigen verzoekenbudget.

Wij kunnen de projectnaam niet uitlezen, want Hetzner heeft er geen endpoint voor. Geef elke integratie een naam die je herkent, want die naam is het enige waaraan je ze in het paneel uit elkaar houdt.

Het token

Eén veld, en dat is de hele credential. Maak hem aan in de Hetzner Cloud Console onder Security → API tokens, binnen het project dat Provibr mag beheren.

  • Kies Read & Write. Een leestoken koppelt gewoon en de verbindingstest wordt groen, want die test leest alleen; hij faalt bij de eerste knop die iets verandert.
  • Een read-write token is alles of niets: geen scopes, geen vervaldatum, geen IP-beperking. Wie het heeft kan elke server in dat project verwijderen.
  • Plak het token precies zoals het er staat. Een token met een losse spatie wordt geweigerd, en Hetzner meldt dat op dezelfde manier als een verkeerd token.
Het token gaat rechtstreeks door naar je agent en wordt daar verzegeld. Het platform bewaart dát er een integratie is, nooit het token zelf.

Machines komen binnen via de import

Provibr negeert elke server waarvan hem niets verteld is, dus een verse integratie toont een lege lijst. Open de integratie, draai de import en vink aan welke servers je in het paneel wilt.

Dat is met opzet: in een project staan meestal ook machines die niets met klanten te maken hebben, en ze automatisch overnemen zou ze in je capaciteitstelling zetten zonder dat iemand erom vroeg.

Wat je met een machine kunt doen

Starten, stoppen, netjes afsluiten, verwijderen en opnieuw opbouwen op een ander image. Verwijderen is echt verwijderen: de machine is weg en de facturatie stopt. Opnieuw opbouwen behoudt zowel het IPv4-adres als het IPv6-blok.

Netjes afsluiten meldt geslaagd zodra het ACPI-signaal verstuurd is, niet zodra de gast eraan gehoorzaamd heeft. De status kan daarna nog enkele seconden op draaiend staan.

Opschorten bestaat niet, en dat is geen gemis

Hetzner belast een server zolang hij bestaat, of hij nu draait of niet. Hem uitzetten kost je klant dus precies evenveel en levert hem niets op; Provibr biedt het daarom niet aan, en de licentiehandhaving doet het evenmin.

Komt een account boven zijn limiet, dan meldt Provibr dat en weigert hij nieuwe machines, maar hij zet geen Hetzner-server uit. De eerlijke manier om hier ruimte te maken is een machine verwijderen.

Wat er nog niet is

Volumes, firewalls en primaire IP-adressen zijn bij Hetzner losse objecten met een eigen levensduur en een eigen prijs. Daarom is er hier geen hardwaretabblad, geen firewallregels en geen adrestoewijzing. Pauzeren kan ook niet: Hetzner kent zelf geen opschorten, dus een machine die boven je capaciteit uitkomt gaat uit.

Robot, de dedicated lijn van Hetzner, is een aparte integratie met een eigen host en eigen inloggegevens, en hij verbindt nog niet. Zodra dat wel zo is krijgt hij een eigen sectie op deze pagina: de stappen verschillen werkelijk, dus ze blijven gescheiden in plaats van dat ze tot één instructie versmelten.