Documentación
Primeros pasos
Seis pasos, de una cuenta vacía a una máquina virtual en marcha. Hace falta un host Linux dentro de la red donde vive su clúster de Proxmox, y acceso root en ese host.
Antes de empezar
- Un nodo o un clúster de Proxmox VE, accesible por HTTPS desde el host que se va a usar
- Un host Linux x86 de 64 bits con systemd, en esa misma red, con acceso root
- Una plantilla en Proxmox de la que clonar máquinas
Crear una cuenta
Al registrarse se entra en el panel con un periodo de prueba ya en marcha. No se piden datos de pago y se puede conectar un host de inmediato.
Crear un agente
En el panel, añada un agente y póngale un nombre que indique dónde está, por ejemplo la ubicación o el rack. El panel muestra un código de activación una sola vez y nunca más, así que conviene guardarlo en un sitio seguro antes de salir de la página.
Instalar el agente en su host
El panel construye un comando de una línea que contiene un enlace de instalación de corta duración. Ejecútelo como root en el host Linux. Comprueba la arquitectura, descarga el binario, verifica la suma de comprobación contra la plataforma, crea la cuenta de servicio y los directorios, obtiene el archivo de licencia, registra el agente e inicia el servicio con systemd.
shellcurl -fsSL https://app.provibr.com/api/install/<token> | shEl comando pide el código de activación por el terminal en lugar de tomarlo de la línea de comandos, así que el código nunca acaba en el historial del shell ni en una lista de procesos.Compruebe que ha arrancado:
shellsystemctl status provibr-agent journalctl -u provibr-agent -fEn unos segundos el agente aparece en línea en el panel. Si no lo hace, el registro del servicio en el host dice por qué.
Obtener la huella TLS de su nodo de Proxmox
Provibr fija el certificado que su nodo de Proxmox presenta realmente. Es el propio certificado de servidor del nodo, no el certificado de la autoridad que lo emitió, ni el de un proxy inverso situado delante. Ejecute esto desde el host del agente, para tomar la huella exactamente de lo que verá el agente:
shellopenssl s_client -connect pve.example.com:8006 </dev/null 2>/dev/null | \ openssl x509 -noout -fingerprint -sha256Copie el valor hexadecimal separado por dos puntos. El prefijo que openssl imprime delante se puede incluir sin problema; el panel lo acepta de las dos formas. Si se ha sustituido el certificado del nodo, hay que volver a tomar la huella, porque una renovación la cambia.El mismo valor se puede leer también en la interfaz web de Proxmox, en System y después Certificates del nodo, en la entrada del certificado web propio del nodo.
Conectar la integración de Proxmox
En el panel, añada una integración, elija Proxmox VE y elija el agente que acaba de instalar. Rellene el host, el identificador del token de API, el secreto del token y la huella del paso anterior. Las credenciales se envían una sola vez a ese agente y quedan selladas en su almacén; la plataforma conserva únicamente los nombres de los campos.
En la práctica, la huella no es opcional. Sin ella el agente no puede decidir si el certificado que se le ofrece es el suyo, y la conexión se rechaza en lugar de confiar a ciegas.Cuando la integración informe de que está activa, abra sus ajustes y establezca el nombre del nodo, el almacenamiento y el rango de vmid que Provibr puede usar. Una integración sin rango no puede crear nada, y es intencionado: el rango es lo que mantiene al panel lejos de las máquinas que no se le han entregado.
Crear su primera máquina
Añada un plan con los núcleos, la memoria y el disco que quiera, y apúntelo a un pool de direcciones. Después cree un servidor: elija la integración, el plan y el sistema operativo que se va a clonar. El panel sigue la tarea de clonado mientras se ejecuta y la máquina aparece con una dirección de su pool ya en su configuración de cloud-init.
Si algo falla, el registro de actividad del servidor muestra el motivo que ha comunicado el agente, en su propio idioma, con el mensaje original de Proxmox citado debajo.