Dokumentation

PufferPanel

Verbinden Sie eine PufferPanel-Installation, und Provibr erstellt, steuert und importiert Gameserver darauf. Diese Seite beschreibt, worin sich PufferPanel von den anderen Gamepanels unterscheidet.

OAuth2-Zugangsdaten

PufferPanel authentifiziert sich mit einem OAuth2-Client statt mit einem API-Schlüssel: einer Client-ID und einem Client-Secret. Erstellen Sie einen im Panel unter Ihrem Konto und fügen Sie beide zusammen mit der Panel-URL in Provibr ein.

Host: die vollständige Panel-URL, zum Beispiel http://panel.example.com:8080. Port 8080 ist die Vorgabe einer frischen Installation; ein Panel hinter einem Reverse-Proxy läuft auf 443, und es gibt keinen Port, den Provibr ohne Raten ergänzen könnte.
Client-ID: die Kennung des OAuth2-Clients.
Client-Secret: das Geheimnis, das zu diesem Client gehört.
TLS-Fingerabdruck (optional): nur bei einem https://-Host, um das Zertifikat zu pinnen.

Das Client-Secret wird einmal angezeigt, beim Erstellen des Clients. Kopieren Sie es sofort: PufferPanel zeigt es danach nicht mehr, und ein halb kopiertes Secret ergibt einen gewöhnlichen Authentifizierungsfehler, statt zu melden, dass es unvollständig ist.

Was der Client darf, richtet sich nach dem Konto, zu dem er gehört. Geben Sie ihm ein Administratorkonto, damit er Server anlegen und entfernen kann.

Transport

Ein frisches PufferPanel spricht einfaches HTTP auf Port 8080. Steht das Panel hinter TLS mit einem selbstsignierten Zertifikat, tragen Sie dessen Fingerabdruck ein; der Agent vertraut dann diesem einen Zertifikat, statt die Prüfung abzuschalten. Auslesen mit:

shell

openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Befehle und Terminal-Ausgaben sind überall auf Englisch, im Panel und auf diesen Seiten. Ein Text, eine Wahrheit: Was Sie hier lesen, ist wörtlich das, was Ihr Host zurückschreibt.

Lassen Sie das Feld leer bei einem Zertifikat einer öffentlichen Stelle und auch, wenn das Panel nur über http erreichbar ist. Ein Fingerabdruck neben einer http-Adresse wird abgelehnt, denn es gibt kein Zertifikat zum Pinnen. Ein Panel auf einfachem http funktioniert, aber das Client-Secret und alles, was die Integration tut, reisen dann unverschlüsselt.

Vorlagen

PufferPanel baut einen Server aus einer Community-Vorlage wie minecraft oder factorio statt aus einem nummerierten Egg. Provibr listet die Vorlagen nach Namen auf; die vollständige Definition mit ihren Variablen wird beim Bestellen abgerufen, sodass der Variablen-Editor des Plans auf die Vorgaben der Vorlage zurückfällt.

Eine Community-Vorlage steht standardmäßig auf einer Host-Umgebung, die Binärdateien braucht, die ein frischer Panel-Host nicht hat. Provibr wechselt zur Docker-Variante der Vorlage, die sie in ihrem Image mitbringt. Sonst würde der Server mit einem Missing-Binary-Fehler nicht bauen.

Pläne

Ein Gameplan trägt den Vorlagennamen und die Ressourcengrenzen. Bestellt wird über einen Plan, und es gibt keinen manuellen Weg: PufferPanel verlangt die vollständige Vorlagendefinition inline, und genau das nimmt Ihnen ein Katalog ab.

Platzierung

PufferPanel zeigt seine Nodes, aber nicht deren Speicher, Festplatte oder CPU. Provibr meldet die Node trotzdem, aber mit unbekannter Kapazität, denn ein Gamepanel ohne Node ist nicht bestellbar.

Die Engine platziert auf einer solchen Node, ohne sie nach freiem Platz zu ordnen, denn es gibt nichts zu messen. Ein Panel mit mehreren Nodes wird nach Namensreihenfolge gewählt, nicht danach, welche Node am meisten Platz hat.

Lebenszyklus

Erstellen, Starten, Stoppen, Neustarten, Kill, Neuinstallieren und Löschen funktionieren alle. Löschen stoppt den Server zuerst, weil der Daemon einen laufenden Container nicht entfernt.

Sperren

PufferPanel hat keine eigene Sperre. Sperrt Provibr einen Gameserver, um eine Lizenzgrenze durchzusetzen, stoppt es den Container und sperrt den Zugriff darauf im Provibr-Panel.

Weil das Panel die Sperre nicht durchsetzt, kann jeder mit direktem Zugang zur PufferPanel-Installation den Server wieder starten. Die Sperre ist ein Provibr-Begriff, kein Panel-Begriff, und deshalb ist es ehrlich, zu sagen, dass der Anbieter sie nicht durchsetzt.

Was Provibr nicht tut

Eine Konsole gibt es nicht: Die von PufferPanel ist poll-basiert und kein Live-Terminal. Diagramme reichen nicht über CPU und Speicher hinaus, denn mehr meldet der Stats-Endpunkt des Panels nicht. Provibr verwaltet weder das Panel noch seine Nodes, Dateien, Backups oder Benutzer; ein Gameserver auf dem Panel ist die Integration.

ZurückPelican WeiterGameAP