Ir al contenido

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.
El secreto de cliente se muestra una vez, al crear el cliente. Cópielo de inmediato: PufferPanel no vuelve a mostrarlo, y un secreto copiado a medias da un error de autenticación normal en lugar de indicar que está incompleto.

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:

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.

Deje 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.

Una plantilla de la comunidad usa por defecto un entorno de host, que necesita binarios que un host de panel nuevo no tiene. Provibr cambia a la variante docker de la plantilla, que los lleva en su imagen: un servidor que, de lo contrario, no se construiría por un binario ausente.

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.

El motor ubica en ese nodo sin clasificarlo por espacio libre, porque no hay nada que medir. Un panel con varios nodos se elige por orden de nombre, no por cuál tiene más espacio.

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.

Como el panel no impone la suspensión, cualquiera con acceso directo a la instalación de PufferPanel puede volver a iniciar el servidor. El bloqueo es un concepto de Provibr, no del panel, y por eso es honesto decir que el proveedor no lo impone.

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.