Integraciones

Cada proveedor se describe en un único sitio: a qué categoría pertenece, qué tipo de recurso entrega, qué credenciales necesita y cuáles de las siete capacidades tiene. El panel, la plataforma y el agente leen esa misma descripción. Nada en el producto pregunta si un sistema resulta ser Proxmox.

Por eso las pestañas de una integración cambian según el proveedor. Hay una pestaña de prueba porque el proveedor declara una prueba de conexión; hay una pestaña de sistemas operativos porque el proveedor puede guardar plantillas; hay una pestaña de importación porque el proveedor puede enumerar lo que ya ejecuta. Una pestaña que falta es una capacidad que falta, no una página que no ha cargado.

Hipervisor

Ejecuta máquinas virtuales y entrega la máquina entera: núcleos, memoria, disco, red. Qué hipervisores están disponibles y cuáles están en la hoja de ruta se indica en la página de integraciones.

Panel de hosting

Ejecuta cuentas de hosting web en una máquina que ya está en marcha. Crea una cuenta con un paquete, no con un sistema operativo. La página de integraciones marca cada panel de control como disponible o en la hoja de ruta.

Panel de juegos

Ejecuta contenedores de servidores de juego, construidos a partir de una receta y no de una imagen de sistema operativo. Está junto a los paneles de control y no dentro de ellos, porque casi nada de ambos es igual. La página de integraciones muestra los paneles de juego que están disponibles.

Servidores dedicados

Máquinas físicas, instaladas por red y operadas fuera de banda. Anunciado y sin construir.

Dispositivos de red

Switches y routers. Anunciado y sin construir, y ni siquiera aparece en la página de integraciones, porque los dispositivos de red tienen sus propias pantallas y no cuentan como recurso.

Siete capacidades deciden qué aparece y qué está dispuesta a enviar la plataforma. Un comando que necesita una capacidad que el proveedor no tiene se rechaza antes de llegar al agente, indicando el motivo.

• Consola: una pantalla o un terminal en directo sobre el recurso.
• Firewall: la plataforma puede imponer qué direcciones puede usar un recurso.
• Reglas del firewall: una lista ordenada de reglas que se edita a mano, más el registro del firewall.
• Hardware: discos y tarjetas de red que se pueden añadir, ampliar y quitar.
• Mediciones: medidas de consumo y, por tanto, gráficas.
• Sistemas operativos: plantillas o imágenes desde las que la plataforma puede instalar.
• Asignación de direcciones: Provibr decide qué dirección recibe el recurso.

Añadir una integración son tres pasos: el tipo de sistema, la conexión y las credenciales. Una categoría sin nada construido detrás se ve, pero no se puede seleccionar, de modo que se aprecia lo que viene sin poder elegirlo.

• Se elige un agente además de un proveedor. Ese agente es el que llegará al sistema, así que tiene que estar en una red desde la que se pueda.
• El nombre es de uso propio. Es una etiqueta del panel y no lo lee nada más.
• Las credenciales se validan con las mismas reglas que usa el agente y después se envían a ese agente y quedan selladas en su almacén. Se permanece en la página hasta que el agente responde.
• Si el agente las rechaza, se muestra el motivo y los valores escritos se quedan donde están, para que una sola errata no cueste el formulario entero.

Las credenciales nunca se escriben en la base de datos de la plataforma. Lo que se conserva son los nombres de los campos rellenados y el host y el puerto, para que el panel tenga algo que mostrar y el registro de auditoría tenga algo a lo que apuntar.

En el host se cifran con una clave mezclada con la identidad de esa máquina. Copiar el almacén y su clave a otra máquina no sirve de nada. No protege frente a root en su propio host. Ese host es suyo, y las credenciales también.

Todo proveedor que habla HTTPS ofrece un campo de huella. Al rellenarlo, el agente solo acepta el certificado exacto que se ha fijado, que es lo que permite usar sin riesgo un certificado autofirmado en un nodo propio. Conviene tomar la huella desde el host del agente, para fijar lo que el agente verá realmente:

openssl s_client -connect <host>:<port> </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

«Activa» solo significa que el agente aceptó las credenciales. No significa que la integración esté lista para entregar máquinas. La lista de comprobación que hay sobre las pestañas muestra qué falta todavía y enlaza directamente con ello.

• Credenciales: entregadas al agente y aceptadas.
• Ajustes: las decisiones no secretas que necesita el proveedor, como el nodo y el rango de vmid. Un proveedor sin nada que elegir se salta este paso en lugar de mostrarlo como pendiente.
• Método de instalación: si las máquinas se clonan de una plantilla o se instalan por red.
• Sistemas operativos: al menos una imagen vinculada, para el método elegido.

El botón de prueba pone en cola una llamada real a su sistema, que ejecuta su agente, y muestra lo que ha vuelto. Lo que informa cambia según el proveedor, porque lo que una prueba de conexión puede decir con sentido depende de la API de ese producto.

• Proxmox: la versión y la lista de nodos con su estado de conexión.
• DirectAdmin: la versión del panel, el número de cuentas, cuántos comandos puede ejecutar la clave de acceso y si la conexión está cifrada. Esto último solo lo puede determinar su agente.
• Webmin: si el módulo Virtualmin responde, cuántas cuentas de hosting y planes hay, y si el certificado coincide con la huella indicada.
• Pterodactyl: el número de nodos y de servidores de juego, y si la clave de cliente funciona. Sin ella no hay encendido y apagado ni consola, y eso conviene saberlo antes del primer botón de inicio y no después.

Desactivar es el paso intermedio seguro: el agente deja de recibir comandos para esa integración y todo se queda donde está. Al volver a activarla pasa a activa si las credenciales se habían aceptado antes y, si no, vuelve a esperar credenciales, porque si siguen funcionando solo lo puede decir una prueba.

El agente informa de un código con parámetros, no de una frase, para que el panel pueda mostrar el motivo en el idioma propio. Donde la otra parte ha dicho algo por sí misma (un cuerpo HTTP del hipervisor, un error del panel) se cita debajo, sin traducir, porque es una cita.

Hay un segundo canal para el caso de «funciona, pero». Un panel que funciona sobre una conexión sin cifrar no es un fallo, y tampoco es un estado, así que aparece como un aviso en la pestaña de resumen mientras el agente lo siga informando.