Pelican

Pelican hat zwei APIs mit zwei verschiedenen Keys, und Provibr braucht beide. Sie stammen von zwei verschiedenen Bildschirmen, und beide müssen zu einem Konto mit Administratorrechten gehören.

• Der Application-Key, aus Admin → API Keys. Er beginnt mit papp_ und verwaltet Server: anlegen, sperren, neu installieren, löschen. Geben Sie ihm Lese- und Schreibrechte auf Server, Node, Allocation, User und Egg.
• Der Client-Key, aus Ihrem eigenen Profile → API Keys. Er beginnt mit pacc_ und trägt Ein-/Aus-Befehle, Live-Verbrauchszahlen und die Konsole.

Vier Felder, und nur das letzte ist optional.

• Die Adresse des Panels, zum Beispiel https://panel.example.com. Geben Sie nur dann einen Port an, wenn das Panel tatsächlich darauf läuft; hinter einem Reverse Proxy antwortet es auf dem Standardport seines Schemas.
• Der Application-Key, beginnend mit papp_.
• Der Client-Key, beginnend mit pacc_.
• Der TLS-Fingerprint des Panels, nur nötig, wenn sein Zertifikat selbstsigniert ist.

Wenn das Panel ein selbstsigniertes Zertifikat vorweist, tragen Sie seinen Fingerprint ein. Der Agent vertraut dann genau diesem einen Zertifikat, statt die Prüfung abzuschalten. Lesen Sie ihn aus mit:

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

Lassen Sie das Feld leer bei einem Zertifikat einer öffentlichen Zertifizierungsstelle und ebenso dann, wenn das Panel nur über http erreichbar ist. Ein Fingerprint neben einer http-Adresse wird abgelehnt, weil es kein Zertifikat gibt, auf das sich pinnen ließe. Ein Panel auf schlichtem http funktioniert zwar, aber beide Keys reisen dann unverschlüsselt über Ihr Netzwerk.

Ein Server wird aus einem Egg gebaut: ein Docker-Image, ein Startbefehl und ein Satz Variablen, die das Egg selbst festlegt. Provibr liest die Liste aus Ihrem Panel, das Bestellformular bietet also die Eggs an, die Sie tatsächlich haben, statt nach einer Nummer zu fragen.

Ein Game-Plan enthält das Egg, das Image, den Startbefehl und die Limits, die ein Server bekommt. Verknüpfen Sie ihn mit einer oder mehreren Pelican-Integrationen, und er wird bestellbar.

Arbeitsspeicher, Festplatte und CPU akzeptieren 0 für unbegrenzt, und das CPU-Limit zählt in Prozent eines Kerns: 100 ist ein voller Kern, 200 sind zwei. Das IO-Gewicht reicht von 0 bis 1000, und 500 ist der übliche Wert.

Pelican meldet, wie viel Arbeitsspeicher und wie viel CPU jeder Node hat und wie viel davon bereits vergeben ist. Provibr nutzt beides: Ein neuer Server geht auf einen Node, der Platz für ihn hat, und wird mit einer Begründung abgelehnt, wenn kein Node welchen hat.

Das ganze Leben eines Gameservers, vom Panel aus oder über die API:

• Ihn aus einem Plan anlegen und entfernen, wenn der Kunde geht.
• Starten, stoppen, neu starten und hart beenden.
• Sperren und wieder freigeben. Das geschieht auch automatisch, wenn ein Konto sein Limit überschreitet.
• Neu installieren, was das Installationsskript seines Eggs erneut ausführt.

Ein Gameserver wird über seine Konsole bedient: Befehle, Spieler und die Logzeile, die einen Absturz erklärt. Sie läuft im Panel über dieselbe ausgehende Verbindung wie alles andere, es gibt also keinen separaten Port und keine zweite Anmeldung.

Server, die Sie außerhalb von Provibr angelegt haben, bleiben unangetastet. Sie können sie importieren, damit sie im Panel erscheinen und auf Ihre Kapazität zählen, und so bringen Sie ein bestehendes Panel herüber, ohne etwas neu aufzubauen.

Dateien, Backups, Datenbanken und Zeitpläne bleiben im Pelican-Panel, ebenso die Verwaltung des Panels und seiner Nodes selbst. Provibr deckt das Leben eines Servers und seine Konsole ab, nicht die Administration Ihres Panels.