Dokumentation
Pterodactyl
Pterodactyl ist die Game-Panel-Integration. Ein Gameserver ist ein Container, gebaut aus einem Rezept statt aus einem Betriebssystem-Image; fast alles an ihm unterscheidet sich deshalb von einer virtuellen Maschine, bis hin dazu, dass die Konsole die Hauptsache ist und keine Zugabe.
Zwei Keys, nicht einer
Pterodactyl teilt seine API in zwei Hälften, und Provibr braucht beide. Sie leisten unterschiedliche Arbeit, und keine kann für die andere einspringen.
- Application-Key: anlegen, stilllegen, neu installieren, löschen und lesen. Er beginnt mit ptla_.
- Client-Key: Ein- und Ausschalten, Verbrauchsmessungen und die Konsole. Er beginnt mit ptlc_.
- Host: die Adresse des Panels. Ein Port wird nicht für Sie eingesetzt: Ein Pterodactyl-Panel ist eine gewöhnliche Website hinter einem Reverse Proxy.
Einstellungen
Ein optionales Feld: die E-Mail-Adresse, der die von Provibr erstellten Server gehören. Lassen Sie es leer, gehören sie dem Konto hinter dem Client-Key. Geben Sie eine Adresse an, die es auf dem Panel noch nicht gibt, wird ein Konto dafür angelegt.
Die Begriffe von Pterodactyl
- Egg
- Das Bau-Rezept: welche Container-Images verwendet werden dürfen, der Startbefehl und die eigenen Variablen. Ein Egg wählen Sie anstelle eines Betriebssystems.
- Nest
- Eine Gruppe von Eggs. Es ist eine Bezeichnung; verwiesen wird tatsächlich auf das Egg.
- Node
- Eine Maschine, auf der Wings läuft, also der Daemon, der die Container betreibt. Wählen Sie keinen, wird der Node mit dem meisten freien Arbeitsspeicher genommen; Nodes in Wartung und nicht öffentliche Nodes werden übersprungen.
- Allocation
- Die Adresse und der Port, auf denen ein Server lauscht. Das Panel vergibt sie aus seiner eigenen Liste; Provibr weist hier keine Adressen zu, denn das wäre ein Versprechen, das es nicht halten kann.
Game-Pläne
Im Game-Plan wird der ganze Container beschrieben, und er ist der einzige Weg, einen Gameserver zu bestellen. Ein manuelles Bestellformular gibt es dafür nicht, weil zu vieles zusammenpassen muss, um es jedes Mal einzutippen.
- Ein Egg auf einer Integration, mit dem Nest als Bezeichnung festgehalten.
- Optional ein Container-Image und ein Startbefehl. Bleiben sie leer, entscheidet das Egg.
- Werte für Variablen, die die Standardwerte des Eggs überschreiben. Jede Variable, die das Egg hat, wird gesendet, auch die, die der Kunde nie sieht, denn das Panel lehnt ein Anlegen mit fehlendem Feld ab.
- Arbeitsspeicher, Swap, Festplatte, CPU und IO-Gewicht. Bei Arbeitsspeicher, Swap, Festplatte und CPU bedeutet null unbegrenzt.
- Wie viele Datenbanken, zusätzliche Allocations und Backups der Server haben darf.
Was Sie tun können
Starten, stoppen, neu starten, killen, stilllegen, fortsetzen, Status aktualisieren, neu installieren und löschen. Der Unterschied zwischen den sanfteren und den härteren Möglichkeiten zählt hier mehr als anderswo.
- Stoppen sendet den eigenen Stopp-Befehl des Eggs an die Konsole, damit das Spiel so herunterfährt, wie es das erwartet.
- Killen stoppt den Container sofort. Alles, was noch nicht auf die Festplatte geschrieben wurde, ist verloren, und das Panel fragt nach einer Bestätigung.
- Stilllegen stoppt den Server und sperrt seinen Besitzer aus. Die Dateien bleiben. Genau das verwendet die Plattform auch, wenn Sie Ihr Lizenzlimit überschreiten.
- Neu installieren lässt den Installationscontainer des Eggs erneut laufen. Was das mit vorhandenen Dateien macht, entscheidet das Egg und nicht wir; die Bestätigung sagt das auch.
Konsole
Die Konsole ist ein Terminal auf dem laufenden Container, von Wings über Ihren Agenten bis in Ihren Browser durchgereicht. Sie sehen Konsolenausgaben, Statusänderungen und Verbrauch; Sie können Befehle senden. Ausführlicher steht das auf der Konsolenseite.
Vorhandene Server übernehmen
Der Import-Tab listet die Server auf dem Panel mit ihren Limits und ihrem Zustand auf, auch die, die Provibr bereits kennt, die angezeigt, aber nicht auswählbar sind. Importierte Server zählen genauso auf Ihre Kapazität wie bestellte.
Wissenswertes
- Das Panel selbst oder seine Nodes zu verwalten gibt es nicht. Provibr baut, betreibt und entfernt Server auf einem Panel, das Sie betreiben.
- Backups, Datenbanken und zusätzliche Allocations sind Limits, die Sie im Plan setzen; genutzt werden sie im Game-Panel selbst. Die Anzahlen kommen mit der Abfrage mit.
- Das Panel hält seine Verbrauchszahlen etwa zwanzig Sekunden im Cache, und Provibr fragt in ungefähr demselben Takt ab. Prozessor, Arbeitsspeicher und Festplatte stimmen immer; eine wiederholte Ablesung kann eine Netzwerkrate von null zeigen, wo es Verkehr gab.
- Pterodactyl 1.x meldet seine eigene Version nicht über die API; der Verbindungstest lässt dieses Feld deshalb leer. Das ist kein Fehler.