Zum Inhalt springen

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.
Legen Sie beide Keys an, während Sie als Administrator angemeldet sind. Der Client-Key eines gewöhnlichen Kontos sieht die Server anderer Leute nicht, und der Verbindungstest sagt das, statt es Sie später entdecken zu lassen.
Die beiden Keys zu vertauschen wird bemerkt, bevor etwas Ihren Host verlässt, denn jeder hat sein eigenes Präfix.

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.
Das IO-Gewicht ist die Ausnahme: Dort bedeutet null nicht unbegrenzt. Das Panel akzeptiert nur einen Wert zwischen 10 und 1000, und eine Null wird stillschweigend zu 500.

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.
Kein Ergebnis wird auf sein Wort hin geglaubt. Pterodactyl bestätigt die meisten Änderungen mit einer leeren Antwort; jede dieser Aktionen endet deshalb damit, den Server zurückzulesen und zu melden, was tatsächlich vorgefunden wurde.

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.