Aller au contenu

Documentation

PufferPanel

Connectez une installation PufferPanel et Provibr y crée, pilote et importe des serveurs de jeu. Cette page décrit ce qui distingue PufferPanel des autres panneaux de jeu.

Identifiants OAuth2

PufferPanel s'authentifie avec un client OAuth2 et non avec une clé d'API : un identifiant de client et un secret de client. Créez-en un dans le panneau, sous votre compte, et collez les deux dans Provibr avec l'URL du panneau.

  • Hôte : l'URL complète du panneau, par exemple http://panel.example.com:8080. Le port 8080 est celui d'une installation neuve ; un panneau derrière un reverse proxy écoute sur 443, et il n'existe aucun port que Provibr puisse ajouter sans deviner.
  • Identifiant de client : l'identifiant du client OAuth2.
  • Secret de client : le secret qui appartient à ce client.
  • Empreinte TLS (facultatif) : uniquement pour un hôte https://, afin d'épingler le certificat.
Le secret de client s'affiche une seule fois, à la création du client. Copiez-le tout de suite : PufferPanel ne le réaffiche pas, et un secret copié à moitié donne une simple erreur d'authentification au lieu d'indiquer qu'il est incomplet.

Ce que le client peut faire dépend du compte auquel il appartient. Attribuez-lui un compte administrateur pour qu'il puisse créer et supprimer des serveurs.

Transport

Un PufferPanel neuf parle HTTP en clair sur le port 8080. Si le panneau est derrière TLS avec un certificat auto-signé, renseignez son empreinte ; l'agent fait alors confiance à ce seul certificat au lieu de désactiver la vérification. Lisez-la avec :

shell
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Les commandes et les sorties de terminal sont en anglais partout, dans le panneau comme dans ces pages. Un seul texte, une seule vérité : ce que vous lisez ici est littéralement ce que votre hôte affichera.

Laissez le champ vide pour un certificat d'une autorité publique, et aussi lorsque le panneau n'est accessible qu'en http : une empreinte à côté d'une adresse http est refusée, car il n'y a aucun certificat à épingler. Un panneau en http fonctionne, mais le secret de client et tout ce que fait l'intégration circulent alors en clair.

Modèles

PufferPanel construit un serveur à partir d'un modèle communautaire, comme minecraft ou factorio, plutôt que d'un egg numéroté. Provibr liste les modèles par nom ; la définition complète, avec ses variables, est récupérée à la commande, de sorte que l'éditeur de variables du plan retombe sur les valeurs par défaut du modèle.

Un modèle communautaire utilise par défaut un environnement hôte, qui exige des binaires qu'un hôte de panneau neuf n'a pas. Provibr bascule sur la variante docker du modèle, qui les embarque dans son image : un serveur qui, sinon, échouerait à se construire faute d'un binaire.

Plans

Un plan de jeu porte le nom du modèle et les limites de ressources. La commande passe par un plan et il n'y a pas de voie manuelle : PufferPanel exige la définition complète du modèle en ligne, ce qu'un catalogue fait précisément à votre place.

Placement

PufferPanel expose ses nœuds, mais pas leur mémoire, leur disque ni leur processeur. Provibr signale le nœud malgré tout, mais avec une capacité inconnue, car un panneau de jeu sans nœud n'est pas commandable.

Le moteur place sur un tel nœud sans le classer selon l'espace libre, car il n'y a rien à mesurer. Un panneau à plusieurs nœuds est choisi par ordre de nom, et non selon le nœud qui a le plus de place.

Cycle de vie

Créer, démarrer, arrêter, redémarrer, tuer, réinstaller et supprimer fonctionnent tous. La suppression arrête d'abord le serveur, car le démon refuse de retirer un conteneur en cours d'exécution.

Suspension

PufferPanel n'a pas de suspension propre. Lorsque Provibr suspend un serveur de jeu pour faire respecter une limite de licence, il arrête le conteneur et en bloque l'accès dans le panneau Provibr.

Comme le panneau n'impose pas la suspension, quiconque a un accès direct à l'installation PufferPanel peut redémarrer le serveur. Le blocage est une notion propre à Provibr, pas au panneau, et c'est ce qui rend honnête de dire que le fournisseur ne l'impose pas.

Ce que Provibr ne fait pas

Il n'y a pas de console : celle de PufferPanel repose sur du sondage et n'est pas un terminal en direct. Les graphiques s'arrêtent au processeur et à la mémoire, car c'est tout ce que renvoie le point de statistiques du panneau. Provibr ne gère ni le panneau, ni ses nœuds, ses fichiers, ses sauvegardes ou ses utilisateurs ; un serveur de jeu sur le panneau est l'intégration.