Documentation
Hetzner
Hetzner vend deux choses via deux API : Cloud, un projet loué de serveurs virtuels facturés à l’heure, et Robot, des machines dédiées sous contrat mensuel. Cette page porte sur l’intégration Cloud, la seule que vous pouvez activer aujourd’hui, et tout ce qui suit découle de cette seule différence : les hôtes ne vous appartiennent pas, donc il n’y a pas de nœud à choisir, pas de stockage à désigner et pas de plage de numéros à distribuer.
Une intégration, c’est un projet
Un jeton d’API Hetzner appartient à exactement un projet et ne voit rien en dehors. Un compte avec trois projets devient donc chez nous trois intégrations, chacune avec son jeton et son propre budget de requêtes.
Le jeton
Un champ, et c’est tout l’identifiant. Créez-le dans la Hetzner Cloud Console, sous Security → API tokens, à l’intérieur du projet que Provibr doit gérer.
- Choisissez Read & Write. Un jeton en lecture seule se connecte sans problème et le test de connexion passe au vert, car ce test ne fait que lire ; il échoue au premier bouton qui modifie quelque chose.
- Un jeton en lecture-écriture, c’est tout ou rien : pas de portées, pas de date d’expiration, pas de restriction d’IP. Qui le détient peut supprimer tous les serveurs de ce projet.
- Collez le jeton tel quel. Un jeton contenant une espace parasite est refusé, et Hetzner le signale de la même façon qu’un jeton erroné.
Les machines arrivent par l’import
Provibr ignore tout serveur dont on ne lui a rien dit ; une intégration fraîche affiche donc une liste vide. Ouvrez l’intégration, lancez l’import et cochez les serveurs que vous voulez voir dans le panneau.
Ce que vous pouvez faire avec une machine
Démarrer, arrêter, éteindre proprement, supprimer et reconstruire sur une autre image. Supprimer supprime vraiment : la machine disparaît et la facturation s’arrête. Une reconstruction conserve l’adresse IPv4 comme le bloc IPv6.
La suspension n’existe pas, et ce n’est pas un manque
Hetzner facture un serveur tant qu’il existe, qu’il tourne ou non. L’éteindre coûte donc exactement autant à votre client et ne lui apporte rien ; Provibr ne le propose donc pas, et l’application des limites de licence non plus.
Ce qui n’existe pas encore
Les volumes, les pare-feu et les IP primaires sont chez Hetzner des objets distincts, avec leur propre durée de vie et leur propre tarif. C’est pourquoi il n’y a ici ni onglet matériel, ni régles de pare-feu, ni attribution d’adresses. La mise en pause n’existe pas non plus : Hetzner ne propose aucune suspension, une machine qui dépasse votre capacité est donc éteinte.