Ir al contenido

Documentación

Hetzner

Hetzner vende dos cosas a través de dos API: Cloud, un proyecto alquilado de servidores virtuales facturados por horas, y Robot, máquinas dedicadas con contrato mensual. Esta página trata de la integración de Cloud, la única que se puede activar hoy, y todo lo que hay en ella se deriva de esa única diferencia: los anfitriones no son propios, así que no hay nodo que elegir, ni almacenamiento que indicar, ni rango de numeración que repartir.

Una integración es un proyecto

Un token de API de Hetzner pertenece exactamente a un proyecto y no ve nada fuera de él. Una cuenta con tres proyectos se convierte aquí en tres integraciones, cada una con su token y su propio presupuesto de peticiones.

No podemos leer el nombre del proyecto: Hetzner no tiene ningún endpoint para ello. Conviene dar a cada integración un nombre reconocible, porque ese nombre es lo único que las distingue en el panel.

El token

Un campo, y eso es toda la credencial. Se crea en la Hetzner Cloud Console, en Security → API tokens, dentro del proyecto que debe gestionar Provibr.

  • Elija Read & Write. Un token de solo lectura se conecta sin problemas y la prueba de conexión sale en verde, porque esa prueba solo lee; falla en el primer botón que cambia algo.
  • Un token de lectura y escritura es todo o nada: sin ámbitos, sin fecha de caducidad, sin restricción de IP. Quien lo tenga puede eliminar cualquier servidor de ese proyecto.
  • Pegue el token tal cual aparece. Un token con un espacio suelto se rechaza, y Hetzner lo notifica igual que un token incorrecto.
El token pasa directamente al agente y allí queda sellado. La plataforma guarda que existe una integración, nunca el token en sí.

Las máquinas llegan por importación

Provibr ignora todo servidor del que no se le ha hablado, así que una integración recién creada muestra una lista vacía. Abra la integración, ejecute la importación y marque los servidores que quiera tener en el panel.

Es deliberado: en un proyecto suele haber máquinas que no tienen nada que ver con clientes, y adoptarlas de forma automática las metería en el recuento de capacidad sin que nadie lo pidiera.

Qué se puede hacer con una máquina

Arrancar, detener, apagar de forma ordenada, eliminar y reconstruir sobre otra imagen. Eliminar elimina de verdad: la máquina desaparece y la facturación se detiene. Una reconstrucción conserva tanto la dirección IPv4 como el bloque IPv6.

El apagado ordenado se da por logrado en cuanto se ha enviado la señal ACPI, no cuando el sistema invitado la ha obedecido. El estado puede seguir marcando en ejecución durante unos segundos.

La suspensión no existe, y no es una carencia

Hetzner factura un servidor mientras exista, funcione o no. Apagarlo cuesta exactamente lo mismo al cliente y no le aporta nada; por eso Provibr no lo ofrece, y la aplicación de límites de licencia tampoco lo hace.

Cuando una cuenta supera su límite, Provibr lo indica y rechaza máquinas nuevas, pero no apaga ningún servidor de Hetzner. Aquí, la forma honesta de liberar capacidad es eliminar una máquina.

Lo que todavía no hay

Los volúmenes, los cortafuegos y las IP primarias son objetos aparte en Hetzner, con su propia vida útil y su propio precio. Por eso aquí no hay pestaña de hardware, ni reglas de cortafuegos, ni asignación de direcciones. Tampoco se puede pausar: Hetzner no tiene una suspensión propia, así que una máquina que supera la capacidad contratada se apaga.

Robot, la línea dedicada de Hetzner, es una integración aparte con su propio host y sus propias credenciales, y todavía no se conecta. Cuando lo haga tendrá su propia sección en esta página: los pasos son realmente distintos, así que seguirán separados en lugar de fundirse en un solo conjunto de instrucciones.