Săriți la conținut

Documentație

PufferPanel

Conectați o instalare PufferPanel și Provibr creează, controlează și importă servere de joc pe ea. Această pagină descrie prin ce se deosebește PufferPanel de celelalte panouri de joc.

Credențiale OAuth2

PufferPanel se autentifică cu un client OAuth2 (un ID de client și un secret de client), nu cu o cheie API. Creați unul în panou, în contul dumneavoastră, și lipiți-le pe amândouă în Provibr, împreună cu adresa panoului.

  • Gazdă: adresa completă a panoului, de exemplu http://panou.example.com:8080. Portul 8080 este cel implicit al unei instalări noi; un panou în spatele unui reverse proxy folosește 443, și nu există niciun port pe care Provibr să-l poată completa fără să ghicească.
  • ID de client: identificatorul clientului OAuth2.
  • Secret de client: secretul care aparține acelui client.
  • Amprentă TLS (opțional): numai pentru o gazdă https://, pentru a fixa certificatul.
Secretul de client se afișează o singură dată, la crearea clientului. Copiați-l imediat: PufferPanel nu îl mai afișează, iar un secret copiat pe jumătate dă o eroare de autentificare obișnuită, în loc să vă spună că este incomplet.

Ce poate face clientul depinde de contul căruia îi aparține. Atribuiți-i un cont de administrator, ca să poată crea și șterge servere.

Transport

Un PufferPanel nou folosește HTTP simplu pe portul 8080. Dacă panoul este în spatele TLS cu un certificat autosemnat, completați amprenta acestuia; agentul are atunci încredere doar în acel certificat, în loc să dezactiveze verificarea. Citiți-o cu:

shell
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Comenzile și ieșirea din terminal sunt în engleză peste tot, în panou și în aceste pagini. Un singur text, un singur adevăr: ce citiți aici este literalmente ce va afișa gazda dumneavoastră.

Lăsați câmpul gol pentru un certificat de la o autoritate publică și, de asemenea, când panoul este accesibil doar prin http: o amprentă lângă o adresă http este respinsă, pentru că nu există niciun certificat de fixat. Un panou pe http simplu funcționează, dar secretul de client și tot ce face integrarea circulă atunci necriptat.

Șabloane

PufferPanel construiește un server dintr-un șablon al comunității (minecraft, factorio și așa mai departe) în loc de un egg numerotat. Provibr enumeră șabloanele după nume; definiția completă, cu variabilele ei, se preia la comandă, astfel că editorul de variabile al planului revine la valorile implicite ale șablonului.

Un șablon al comunității folosește implicit un mediu gazdă, care are nevoie de binare pe care o gazdă de panou nouă nu le are. Provibr trece la varianta docker a șablonului, care le aduce în imaginea sa: un server care altfel nu s-ar construi din cauza unui binar lipsă.

Planuri

Un plan de joc poartă numele șablonului și limitele de resurse. Comanda trece printr-un plan și nu există cale manuală: PufferPanel cere definiția completă a șablonului inline, exact ceea ce un catalog face în locul dumneavoastră.

Plasare

PufferPanel își expune nodurile, dar nu memoria, discul sau procesorul lor. Provibr raportează totuși nodul (un panou de joc fără niciun nod nu poate fi comandat), dar cu capacitate necunoscută.

Motorul plasează pe un astfel de nod fără a-l clasa după spațiul liber, pentru că nu există nimic de măsurat. Un panou cu mai multe noduri este ales după ordinea numelor, nu după nodul cu cel mai mult spațiu.

Ciclu de viață

Crearea, pornirea, oprirea, repornirea, oprirea forțată, reinstalarea și ștergerea funcționează toate. Ștergerea oprește mai întâi serverul, pentru că daemonul refuză să înlăture un container în execuție.

Suspendare

PufferPanel nu are o suspendare proprie. Când Provibr suspendă un server de joc (pentru a impune o limită de licență), oprește containerul și blochează accesul la el în panoul Provibr.

Deoarece panoul nu impune suspendarea, oricine are acces direct la instalarea PufferPanel poate porni din nou serverul. Blocarea este un concept al Provibr, nu al panoului, și tocmai de aceea este cinstit să spui că furnizorul nu o impune.

Ce nu face Provibr

Nu există consolă: cea a PufferPanel se bazează pe sondare și nu este un terminal în timp real. Nu există nici grafice dincolo de procesor și memorie, pentru că atât raportează punctul de statistici al panoului. Provibr nu gestionează panoul, nodurile, fișierele, copiile de rezervă sau utilizatorii lui; un server de joc pe panou este integrarea.