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.
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 :
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Laissez 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.
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.
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.
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.