Salta al contenuto

Documentazione

Hetzner

Hetzner vende due cose attraverso due API: Cloud, un progetto a noleggio di server virtuali con fatturazione oraria, e Robot, macchine dedicate con contratto mensile. Questa pagina riguarda l’integrazione Cloud, l’unica che si possa attivare oggi, e tutto ciò che vi si trova discende da questa sola differenza: gli host non sono suoi, quindi non c’è alcun nodo da scegliere, nessuno storage da indicare e nessun intervallo di numeri da distribuire.

Un’integrazione è un progetto

Un token API di Hetzner appartiene esattamente a un progetto e non vede nulla al di fuori. Un account con tre progetti diventa quindi da noi tre integrazioni, ciascuna con il proprio token e il proprio budget di richieste.

Non possiamo leggere il nome del progetto: Hetzner non offre alcun endpoint per farlo. Conviene dare a ogni integrazione un nome riconoscibile, perché quel nome è l’unica cosa che le distingue nel pannello.

Il token

Un campo, e sono tutte le credenziali. Lo crei nella Hetzner Cloud Console, in Security → API tokens, all’interno del progetto che Provibr deve gestire.

  • Scelga Read & Write. Un token di sola lettura si collega senza problemi e il test di connessione diventa verde, perché quel test si limita a leggere; fallisce al primo pulsante che modifica qualcosa.
  • Un token in lettura e scrittura è tutto o niente: nessun ambito, nessuna scadenza, nessuna restrizione di IP. Chi lo possiede può eliminare qualsiasi server di quel progetto.
  • Incolli il token esattamente com’è. Un token con uno spazio di troppo viene rifiutato, e Hetzner lo segnala allo stesso modo di un token errato.
Il token passa direttamente all’agente e lì viene sigillato. La piattaforma conserva il fatto che esista un’integrazione, mai il token stesso.

Le macchine arrivano tramite l’importazione

Provibr ignora ogni server di cui non gli è stato detto nulla, quindi un’integrazione appena creata mostra un elenco vuoto. Apra l’integrazione, avvii l’importazione e selezioni i server che desidera nel pannello.

È voluto: in un progetto ci sono di solito anche macchine che non hanno nulla a che vedere con i clienti, e adottarle automaticamente le inserirebbe nel conteggio della capacità senza che nessuno l’abbia chiesto.

Che cosa si può fare con una macchina

Avviare, arrestare, spegnere in modo ordinato, eliminare e ricostruire su un’altra immagine. Eliminare elimina davvero: la macchina sparisce e la fatturazione si ferma. Una ricostruzione conserva sia l’indirizzo IPv4 sia il blocco IPv6.

Lo spegnimento ordinato viene dato per riuscito non appena il segnale ACPI è stato inviato, non quando il sistema ospite vi ha obbedito. Lo stato può indicare «in esecuzione» ancora per qualche secondo.

La sospensione non esiste, e non è una mancanza

Hetzner fattura un server finché esiste, che sia acceso o meno. Spegnerlo costa quindi al cliente esattamente lo stesso e non gli porta alcun vantaggio; per questo Provibr non lo offre, e nemmeno l’applicazione dei limiti di licenza lo fa.

Quando un account supera il proprio limite, Provibr lo segnala e rifiuta nuove macchine, ma non spegne alcun server Hetzner. Qui il modo onesto di liberare capacità è eliminare una macchina.

Che cosa non c’è ancora

Volumi, firewall e IP primari sono da Hetzner oggetti separati, con una vita e un prezzo propri. Per questo qui non esiste una scheda hardware, né regole del firewall, né assegnazione di indirizzi. Non è possibile nemmeno mettere in pausa: Hetzner non ha una sospensione propria, quindi una macchina che supera la capacità viene spenta.

Robot, la linea dedicata di Hetzner, è un’integrazione a sé con host proprio e credenziali proprie, e non si collega ancora. Quando lo farà avrà una sezione propria in questa pagina: i passaggi sono davvero diversi, quindi resteranno separati invece di fondersi in un’unica istruzione.