Documentación
PufferPanel
Conecte una instalación de PufferPanel y Provibr crea, controla e importa servidores de juego en ella. Esta página describe en qué se diferencia PufferPanel de los demás paneles de juego.
Credenciales OAuth2
PufferPanel se autentica con un cliente OAuth2 y no con una clave de API: un ID de cliente y un secreto de cliente. Cree uno en el panel dentro de su cuenta y pegue ambos en Provibr junto con la URL del panel.
- Host: la URL completa del panel, por ejemplo http://panel.example.com:8080. El puerto 8080 es el predeterminado de una instalación nueva; un panel tras un proxy inverso usa el 443, y no hay ningún puerto que Provibr pueda añadir sin adivinar.
- ID de cliente: el identificador del cliente OAuth2.
- Secreto de cliente: el secreto que pertenece a ese cliente.
- Huella TLS (opcional): solo para un host https://, para fijar el certificado.
Lo que el cliente puede hacer depende de la cuenta a la que pertenece. Asígnele una cuenta de administrador para que pueda crear y eliminar servidores.
Transporte
Un PufferPanel nuevo usa HTTP sin cifrar en el puerto 8080. Si el panel está tras TLS con un certificado autofirmado, indique su huella; el agente confía entonces solo en ese certificado en lugar de desactivar la verificación. Léala con:
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Deje el campo vacío con un certificado de una autoridad pública, y también cuando el panel solo sea accesible por http: una huella junto a una dirección http se rechaza, porque no hay certificado que fijar. Un panel en http sin cifrar funciona, pero el secreto de cliente y todo lo que hace la integración viajan entonces sin cifrar.
Plantillas
PufferPanel construye un servidor a partir de una plantilla de la comunidad, como minecraft o factorio, en lugar de un egg numerado. Provibr enumera las plantillas por nombre; la definición completa, con sus variables, se obtiene al hacer el pedido, de modo que el editor de variables del plan recurre a los valores predeterminados de la plantilla.
Planes
Un plan de juego lleva el nombre de la plantilla y los límites de recursos. El pedido se hace mediante un plan y no hay vía manual: PufferPanel exige la definición completa de la plantilla en línea, que es justo lo que resuelve un catálogo.
Ubicación
PufferPanel muestra sus nodos, pero no su memoria, disco ni CPU. Provibr informa del nodo de todos modos, pero con capacidad desconocida, porque un panel de juego sin nodo no se puede pedir.
Ciclo de vida
Crear, iniciar, detener, reiniciar, forzar la parada, reinstalar y eliminar funcionan todos. Eliminar detiene el servidor primero, porque el daemon se niega a quitar un contenedor en marcha.
Suspensión
PufferPanel no tiene una suspensión propia. Cuando Provibr suspende un servidor de juego para hacer cumplir un límite de licencia, detiene el contenedor y bloquea el acceso a él en el panel de Provibr.
Lo que Provibr no hace
No hay consola: la de PufferPanel se basa en sondeo y no es una terminal en vivo. Las gráficas no van más allá de CPU y memoria, porque es todo lo que informa el endpoint de estadísticas del panel. Provibr no gestiona el panel, sus nodos, archivos, copias de seguridad ni usuarios; un servidor de juego en el panel es la integración.