Documentation
Pterodactyl
Pterodactyl est l’intégration panneau de jeu. Un serveur de jeu est un conteneur construit à partir d’une recette plutôt que d’une image de système d’exploitation : presque tout y diffère donc d’une machine virtuelle, y compris le fait que la console soit l’essentiel et non un supplément.
Deux clés, pas une
Pterodactyl scinde son API en deux, et Provibr a besoin des deux moitiés. Elles font un travail différent et l’une ne peut pas remplacer l’autre.
- Clé application : créer, suspendre, réinstaller, supprimer et lire. Elle commence par ptla_.
- Clé client : contrôle de l’alimentation, relevés d’utilisation et console. Elle commence par ptlc_.
- Hôte : l’adresse du panneau. Aucun port n’est renseigné pour vous : un panneau Pterodactyl est un site web ordinaire derrière un proxy inverse.
Paramètres
Un seul champ facultatif : l’adresse e-mail à laquelle appartiennent les serveurs créés par Provibr. Laissez-le vide et ils appartiendront au compte derrière la clé client. Indiquez une adresse qui n’existe pas encore sur le panneau et un compte est créé pour elle.
Le vocabulaire de Pterodactyl
- Egg
- La recette de construction : les images de conteneur utilisables, la commande de démarrage et ses propres variables. Un egg est ce que vous choisissez à la place d’un système d’exploitation.
- Nest
- Un groupe d’eggs. C’est un libellé ; c’est l’egg qui est réellement référencé.
- Nœud
- Une machine qui fait tourner Wings, le démon qui exécute les conteneurs. Si vous n’en choisissez pas, le nœud disposant du plus de mémoire libre est retenu, en écartant les nœuds en maintenance et ceux qui ne sont pas publics.
- Allocation
- L’adresse et le port sur lesquels un serveur écoute. Le panneau les distribue depuis sa propre liste ; Provibr n’attribue pas d’adresses ici, car ce serait une promesse qu’il ne peut pas tenir.
Les plans de jeu
Un plan de jeu est l’endroit où l’ensemble du conteneur est décrit, et c’est le seul moyen de commander un serveur de jeu. Il n’existe pas de formulaire de commande manuel, car trop d’éléments doivent concorder pour être saisis à chaque fois.
- Un egg sur une intégration, le nest étant consigné comme libellé.
- Éventuellement une image de conteneur et une commande de démarrage. Laissés vides, c’est l’egg qui décide.
- Des valeurs de variables qui remplacent celles par défaut de l’egg. Toutes les variables de l’egg sont envoyées, y compris celles que le client ne voit jamais, car le panneau refuse une création s’il manque un champ.
- Mémoire, swap, disque, processeur et poids d’E/S. Zéro signifie illimité pour la mémoire, le swap, le disque et le processeur.
- Le nombre de bases de données, d’allocations supplémentaires et de sauvegardes que le serveur peut avoir.
Ce que vous pouvez faire
Démarrer, arrêter, redémarrer, forcer l’arrêt, suspendre, reprendre, actualiser, réinstaller et supprimer. La différence entre les options douces et les options brutales compte ici plus qu’ailleurs.
- L’arrêt envoie à la console la commande d’arrêt propre à l’egg, pour que le jeu s’éteigne comme il l’attend.
- L’arrêt forcé abat le conteneur immédiatement. Tout ce qui n’a pas encore été écrit sur le disque est perdu, et le panneau vous demande de confirmer.
- La suspension arrête le serveur et en bloque l’accès à son propriétaire. Les fichiers restent en place. C’est aussi ce qu’emploie la plateforme lorsque vous dépassez votre limite de licence.
- La réinstallation relance le conteneur d’installation de l’egg. Ce que cela fait aux fichiers existants relève du choix de l’egg, pas du nôtre, et la confirmation le précise.
Console
La console est un terminal sur le conteneur en marche, relayé depuis Wings par votre agent jusqu’à votre navigateur. Vous voyez la sortie console, les changements de statut et l’utilisation ; vous pouvez envoyer des commandes. Elle est décrite plus en détail sur la page consacrée à la console.
Reprendre des serveurs existants
L’onglet d’import liste les serveurs présents sur le panneau avec leurs limites et leur état, y compris ceux que Provibr connaît déjà, affichés mais non sélectionnables. Les serveurs importés comptent dans votre capacité exactement comme ceux que vous avez commandés.
Bon à savoir
- Gérer le panneau lui-même, ou ses nœuds, n’existe pas. Provibr construit, fait tourner et supprime des serveurs sur un panneau que vous exploitez.
- Les sauvegardes, les bases de données et les allocations supplémentaires sont des limites que vous fixez sur le plan ; leur utilisation se fait dans le panneau de jeu lui-même. Les décomptes remontent avec l’interrogation.
- Le panneau met ses chiffres d’utilisation en cache pendant une vingtaine de secondes, et Provibr interroge à peu près au même rythme. Le processeur, la mémoire et le disque sont toujours justes ; un relevé répété peut afficher un débit réseau nul là où il y a eu du trafic.
- Pterodactyl 1.x ne communique pas sa propre version par l’API : le test de connexion laisse donc ce champ vide. Ce n’est pas un défaut.