Săriți la conținut

Documentație

Pelican

Pelican vă rulează serverele de jocuri: un egg descrie din ce este construit un server, un nod îl poartă, o alocare îi dă adresa. Provibr ajunge la el dintr-un agent aflat în propria dumneavoastră rețea, așa că panoul nu are nevoie de niciun port de intrare și nu se instalează nimic pe el.

Două chei API

Pelican are două API-uri cu două chei diferite, iar Provibr are nevoie de amândouă. Ele vin din două ecrane diferite și amândouă trebuie să aparțină unui cont cu drepturi de administrator.

  • Cheia de aplicație, din Admin → API Keys. Începe cu papp_ și administrează serverele: creare, suspendare, reinstalare, ștergere. Dați-i acces de citire și scriere la Server, Node, Allocation, User și Egg.
  • Cheia de client, din propriul dumneavoastră Profile → API Keys. Începe cu pacc_ și poartă comenzile de alimentare, cifrele de utilizare live și consola.
Copiați cheia de client chiar în clipa în care apare. Pelican o afișează o singură dată, iar lista păstrează după aceea doar un identificator scurt, iar acel identificator este acceptat drept cheie, așa că lipirea lui vă dă o simplă eroare de autentificare, în loc de un indiciu că ați copiat lucrul greșit. Cheia de aplicație poate fi citită din nou din listă, în întregime.
Nu există nicio alternativă din linia de comandă: Pelican nu livrează nicio comandă artisan pentru cheile API, așa că ambele se creează prin interfața web.

Ce completați

Patru câmpuri, iar doar ultimul este opțional.

  • Adresa panoului, de exemplu https://panel.example.com. Adăugați un port doar dacă panoul chiar rulează pe unul; în spatele unui reverse proxy răspunde pe portul implicit al schemei sale.
  • Cheia de aplicație, care începe cu papp_.
  • Cheia de client, care începe cu pacc_.
  • Amprenta TLS a panoului, necesară doar când certificatul lui este autosemnat.
Aveți grijă care cheie merge în care câmp. Pelican acceptă o cheie de client și pe API-ul de administrare, așa că inversarea celor două nu produce o eroare pe care s-o puteți vedea: prefixul este singurul lucru care le deosebește, iar Provibr îl verifică pe ambele părți tocmai din acest motiv.

Certificat autosemnat

Dacă panoul prezintă un certificat autosemnat, completați-i amprenta. Agentul are atunci încredere în acel singur 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ă, precum și atunci când panoul este accesibil doar prin http: o amprentă alături de o adresă http este refuzată, pentru că nu există niciun certificat de fixat. Un panou pe http simplu funcționează, dar ambele chei circulă atunci necriptate prin rețeaua dumneavoastră.

Egg-urile și variabilele lor

Un server este construit dintr-un egg: o imagine Docker, o comandă de pornire și un set de variabile pe care egg-ul le definește el însuși. Provibr citește lista din panoul dumneavoastră, așa că formularul de comandă oferă egg-urile pe care le aveți cu adevărat, în loc să ceară un număr.

Provibr refuză o comandă atunci când o variabilă pe care egg-ul o marchează ca obligatorie este lăsată goală, chiar dacă panoul însuși ar accepta-o. Este intenționat: Pelican creează oricum serverul, iar containerul cade apoi la prima pornire, ceea ce este un răspuns mult mai prost decât un câmp care se face roșu.

Planuri

Un plan de jocuri conține egg-ul, imaginea, comanda de pornire și limitele pe care le primește un server. Legați-l de una sau mai multe integrări Pelican și devine comandabil.

Memoria, discul și CPU acceptă 0 pentru nelimitat, iar limita de CPU se numără în procente dintr-un nucleu: 100 este un nucleu întreg, 200 sunt două. Greutatea I/O merge de la 0 la 1000, iar 500 este valoarea obișnuită.

Pe ce nod ajunge un server

Pelican raportează câtă memorie și cât CPU are fiecare nod și cât din acestea este deja distribuit. Provibr le folosește pe amândouă: un server nou merge pe un nod cu loc pentru el și este refuzat cu un motiv când niciun nod nu are.

Cifrele pe care le raportează panoul sunt propria lui contabilitate, nu o măsurătoare: adună limitele serverelor de pe un nod, inclusiv ale celor care încă se instalează. Un nod poate așadar să pară plin în timp ce de fapt rulează puțin.

Ce puteți face cu un server

Întreaga viață a unui server de jocuri, din panou sau prin API:

  • Creați-l dintr-un plan și ștergeți-l când clientul pleacă.
  • Porniți-l, opriți-l, reporniți-l și forțați oprirea.
  • Suspendați-l și ridicați-i suspendarea, ceea ce se întâmplă automat și când un cont își depășește limita.
  • Reinstalați-l, ceea ce rulează din nou scriptul de instalare al egg-ului lui.

Consola

Un server de jocuri se conduce din consola lui: comenzi, jucători și linia de jurnal care explică o cădere. Rulează în panou prin aceeași conexiune spre exterior ca tot restul, așa că nu există niciun port separat și nicio a doua autentificare.

Servere care există deja

Serverele pe care le-ați creat în afara Provibr sunt lăsate în pace. Le puteți importa pentru a apărea în panou și pentru a se socoti la capacitatea dumneavoastră, aceasta fiind calea de a muta un panou existent fără a reconstrui nimic.

Importarea nu atinge serverul; doar începe să îl socotească. Până când îl importați, Provibr nu îl va nici administra, nici tarifa.

Ce nu face această integrare

Fișierele, backupurile, bazele de date și programările rămân în panoul Pelican, la fel și administrarea panoului și a nodurilor lui. Provibr acoperă viața unui server și consola lui, nu administrarea panoului dumneavoastră.

Pelican este el însuși încă în beta, iar API-ul lui se schimbă de la o versiune la alta. Provibr este testat pe 1.0.0, iar panoul nu oferă nicio cale de a întreba ce versiune rulează, așa că o actualizare care schimbă un răspuns apare ca o eroare, nu ca un avertisment dinainte. Citiți notele de lansare înainte de a actualiza un panou cu care vorbește Provibr.