Ir al contenido

Documentación

Pterodactyl

Pterodactyl es la integración de panel de juegos. Un servidor de juego es un contenedor construido a partir de una receta y no de una imagen de sistema operativo, así que casi todo en él es distinto de una máquina virtual, incluido el hecho de que la consola es lo principal y no un extra.

Dos claves, no una

Pterodactyl divide su API en dos, y Provibr necesita las dos mitades. Hacen trabajos distintos y una no puede sustituir a la otra.

  • Clave de aplicación: crear, suspender, reinstalar, eliminar y leer. Empieza por ptla_.
  • Clave de cliente: encendido y apagado, mediciones de consumo y la consola. Empieza por ptlc_.
  • Host: la dirección del panel. No se rellena ningún puerto: un panel de Pterodactyl es un sitio web normal detrás de un proxy inverso.
Conviene crear las dos claves con la sesión iniciada como administrador. La clave de cliente de una cuenta normal no ve los servidores de otras personas, y la prueba de conexión lo indica en lugar de dejar que se descubra más tarde.
Intercambiar las dos claves se detecta antes de que nada salga del host, porque cada una tiene su propio prefijo.

Ajustes

Un solo campo opcional: la dirección de correo propietaria de los servidores que crea Provibr. Si se deja vacío, el propietario es la cuenta que hay detrás de la clave de cliente. Si se indica una dirección que todavía no existe en el panel, se crea una cuenta para ella.

Las palabras que usa Pterodactyl

Egg
La receta de construcción: qué imágenes de contenedor se pueden usar, el comando de arranque y sus propias variables. Un egg es lo que se elige en lugar de un sistema operativo.
Nest
Un grupo de eggs. Es una etiqueta; lo que realmente se referencia es el egg.
Nodo
Una máquina que ejecuta Wings, el daemon que hace funcionar los contenedores. Si no se elige uno, se toma el nodo con más memoria libre, omitiendo los nodos en mantenimiento y los que no son públicos.
Asignación
La dirección y el puerto en los que escucha un servidor. El panel los entrega de su propia lista; Provibr no asigna direcciones aquí, porque sería una promesa que no puede cumplir.

Planes de juego

Un plan de juego es donde se describe el contenedor entero, y es la única forma de pedir un servidor de juego. No hay formulario de pedido manual, porque tienen que encajar demasiadas cosas como para escribirlas cada vez.

  • Un egg en una integración, con el nest anotado como etiqueta.
  • Opcionalmente, una imagen de contenedor y un comando de arranque. Si se dejan vacíos, decide el egg.
  • Valores de variables que sustituyen a los predeterminados del egg. Se envían todas las variables que tiene el egg, incluidas las que el cliente nunca ve, porque el panel rechaza una creación a la que le falta un campo.
  • Memoria, swap, disco, CPU y peso de E/S. Cero significa sin límite para la memoria, el swap, el disco y la CPU.
  • Cuántas bases de datos, asignaciones adicionales y copias de seguridad puede tener el servidor.
El peso de E/S es la excepción: ahí cero no significa sin límite. El panel solo acepta un valor entre 10 y 1000, y un cero se convierte en silencio en 500.

Qué se puede hacer

Iniciar, detener, reiniciar, forzar la parada, suspender, reanudar, actualizar el estado, reinstalar y eliminar. Aquí la diferencia entre las opciones suaves y las duras importa más que en otros sitios.

  • «Detener» envía a la consola el comando de parada del propio egg, de modo que el juego se apaga como espera hacerlo.
  • «Forzar la parada» detiene el contenedor de golpe. Se pierde todo lo que todavía no se haya escrito en disco, y el panel pide confirmación.
  • «Suspender» detiene el servidor y bloquea el acceso de su propietario. Los archivos se conservan. Es también lo que usa la plataforma cuando se supera el límite de la licencia.
  • «Reinstalar» vuelve a ejecutar el contenedor de instalación del egg. Lo que eso hace con los archivos existentes lo decide el egg, no nosotros, y la confirmación lo indica.
Ningún resultado se da por bueno bajo palabra. Pterodactyl confirma la mayoría de los cambios con una respuesta vacía, así que todas estas acciones terminan volviendo a leer el servidor e informando de lo que se ha encontrado realmente.

Consola

La consola es un terminal sobre el contenedor en marcha, retransmitido desde Wings a través de su agente hasta el navegador. Se ve la salida de la consola, los cambios de estado y el consumo; se pueden enviar comandos. Se describe con más detalle en la página de la consola.

Adoptar servidores que ya existen

La pestaña de importación enumera los servidores del panel con sus límites y su estado, incluidos los que Provibr ya conoce, que se muestran pero no se pueden seleccionar. Los servidores importados cuentan para la capacidad igual que los pedidos.

Conviene saber

  • Gestionar el propio panel, o sus nodos, no existe. Provibr construye, ejecuta y elimina servidores en un panel que sigue siendo suyo.
  • Las copias de seguridad, las bases de datos y las asignaciones adicionales son límites que se fijan en el plan; su uso ocurre en el propio panel de juego. Los recuentos llegan con el sondeo.
  • El panel guarda en caché sus cifras de consumo durante unos veinte segundos, y Provibr sondea con un ritmo parecido. El procesador, la memoria y el disco siempre son correctos; una lectura repetida puede mostrar una tasa de red de cero donde sí hubo tráfico.
  • Pterodactyl 1.x no informa de su propia versión por la API, así que la prueba de conexión deja ese campo vacío. No es un fallo.