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.
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.
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:
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Lă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.
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.
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.
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ă.