Ir al contenido

Documentación

VMware vSphere

Provibr se conecta a un vCenter Server y gestiona las máquinas virtuales de su inventario: pedir, clonar, arrancar, detener, suspender, eliminar y leer el consumo, mediante el mismo agente, los mismos planes y el mismo registro de auditoría que cualquier otra integración.

A qué se conecta

La integración habla con vCenter Server a través de su API de Web Services. Todo lo que hace el panel (ubicación, clonado, configuración del invitado) pasa por vCenter, de modo que un clúster con DRS sigue decidiendo por sí mismo en qué host acaba una máquina.

Un host ESXi independiente no está admitido. Responde en la misma API e incluso el inicio de sesión funciona, pero no tiene clústeres ni DRS ni un grupo de recursos al que clonar. El agente comprueba con qué está hablando y rechaza un host independiente en lugar de fallar en el primer pedido.

En qué se diferencia de Proxmox

El modelo es el mismo: un agente, una integración, planes y plantillas. Cuatro cosas se comportan de otra manera, y son precisamente las que se notan.

Una máquina se identifica por su UUID de instancia y no por un número que reparta Provibr. Todo lo que se elige en la configuración (centro de datos, grupo de recursos, red) es una referencia de objeto de vSphere y no un nombre, porque allí los nombres solo son únicos dentro de su carpeta. Y el «nodo» que aparece en el panel es el centro de datos, no el host ESXi: ese host cambia con cada vMotion, y una máquina que pareciera mudarse cada hora sería imposible de seguir.

Qué se rellena

Cuatro campos. Conviene crear un usuario propio en lugar de reutilizar un administrador: vCenter no tiene un token de API revocable, así que el rol de la cuenta es el límite.

  • La dirección https de vCenter, tal como se abre en el navegador.
  • El nombre de usuario con su dominio, por ejemplo provibr@vsphere.local.
  • La contraseña. Viaja una sola vez al agente y Provibr nunca la almacena.
  • La huella SHA-256 del certificado que presenta vCenter.
Conviene dar a la cuenta un rol sobre el centro de datos que deba gestionar. El inicio de sesión funciona con cualquier cuenta que vCenter conozca, así que una cuenta sin rol se conecta sin problemas y después no ve absolutamente nada: ningún error, solo un inventario vacío. Por eso la prueba de conexión indica cuántos centros de datos ve; cero significa que las credenciales son correctas y falta el rol.

La huella TLS

Se lee desde cualquier máquina que alcance vCenter:

shell
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Los comandos y la salida del terminal están en inglés en todas partes, en el panel y en estas páginas. Un solo texto, una sola verdad: lo que se lee aquí es literalmente lo que devolverá su host.

Este campo es obligatorio. vCenter siempre presenta un certificado de su propia CA integrada, de modo que no hay ninguna cadena de confianza pública a la que recurrir ni tampoco una ruta sin cifrar. Con una huella, el agente confía en ese certificado concreto en lugar de desactivar la verificación.

Hay que tomar la huella del certificado de la máquina, no la de la CA integrada. El vSphere Client muestra ambas y se parecen. Fijar la de la CA da una integración que funciona de inmediato y se detiene meses después, en la siguiente rotación del certificado.

Configuración

Dónde se ubican las máquinas nuevas. Se eligen de lo que informa vCenter; no hay nada que escribir.

  • El centro de datos donde se crean las máquinas nuevas.
  • El grupo de recursos. En un clúster con DRS es su grupo raíz y vSphere elige el host.
  • El grupo de puertos al que se conecta la tarjeta de red.
  • Opcionalmente un host fijo; conviene dejarlo vacío allí donde DRS está activo.
No hay ajuste de almacén de datos. Un clon hereda el almacenamiento de su plantilla, que ya está en un sitio permitido; elegir otro permitiría apuntar a un almacén que quizá el host de destino ni siquiera vea.

Plantillas

En vSphere una plantilla es una máquina virtual corriente marcada como tal, en el mismo inventario. Basta con vincularla a un sistema operativo del catálogo y los pedidos de ese sistema se clonarán de ella.

La lista muestra el centro de datos junto al nombre, porque dos plantillas pueden compartir nombre en carpetas distintas. Conviene que la plantilla lleve VMware Tools y cloud-init; Provibr entrega la configuración del invitado por el canal guestinfo, que funciona en cualquier imagen de nube sin requisitos añadidos.

Qué se puede hacer con una máquina

Crearla desde una plantilla, arrancarla, detenerla, reiniciarla en frío, apagarla y reiniciarla ordenadamente mediante VMware Tools, suspenderla y reanudarla, leer su estado y eliminarla.

Todavía no: añadir o quitar discos y tarjetas de red, y reinstalar. Reinstalar en vSphere significa volver a clonar, y no hay ninguna orden que reconstruya la misma máquina en su sitio. Un cortafuegos por máquina no existe en vSphere: eso es NSX, un producto aparte.

Red

Una máquina nueva recibe una tarjeta en el grupo de puertos de la configuración, y su dirección del IPAM si el plan tiene un conjunto asociado.

Los grupos de puertos distribuidos están admitidos y son el caso habitual. Se conectan de otra forma que las redes clásicas (por el UUID de su conmutador más su propia clave) y el agente lo deduce del propio objeto, así que no hay nada que configurar.

Importar lo que ya existe

Las máquinas que existen en vCenter al margen de Provibr se pueden importar desde la página de la integración: se marcan las deseadas y aparecen como servidores, con su centro de datos, su estado y sus características.