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