PufferPanel

PufferPanel si autentica con un client OAuth2 anziché con una chiave API: un ID client e un secret client. Ne crei uno nel pannello, sotto il suo account, e incolli entrambi in Provibr insieme all’URL del pannello.

• Host: l’URL completo del pannello, per esempio http://panel.example.com:8080. La porta 8080 è quella predefinita di un’installazione nuova; un pannello dietro un reverse proxy usa la 443, e non esiste una porta che Provibr possa aggiungere senza indovinare.
• ID client: l’identificatore del client OAuth2.
• Secret client: il segreto che appartiene a quel client.
• Impronta TLS (facoltativa): solo per un host https://, per fissare il certificato.

Ciò che il client può fare dipende dall’account a cui appartiene. Gli assegni un account amministratore, così può creare e rimuovere server.

Un PufferPanel nuovo usa HTTP in chiaro sulla porta 8080. Se il pannello è dietro TLS con un certificato autofirmato, indichi la sua impronta; l’agente si fida allora solo di quel certificato invece di disattivare la verifica. La legga con:

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

Lasci il campo vuoto con un certificato di un’autorità pubblica, e anche quando il pannello è raggiungibile solo via http: un’impronta accanto a un indirizzo http viene rifiutata, perché non c’è alcun certificato da fissare. Un pannello in http funziona, ma il secret client e tutto ciò che fa l’integrazione viaggiano allora in chiaro.

PufferPanel costruisce un server da un modello della community, come minecraft o factorio, anziché da un egg numerato. Provibr elenca i modelli per nome; la definizione completa, con le sue variabili, viene recuperata all’ordine, così l’editor delle variabili del piano ripiega sui valori predefiniti del modello.

Un piano di gioco porta il nome del modello e i limiti di risorse. L’ordine passa da un piano e non c’è una via manuale: PufferPanel esige la definizione completa del modello in linea, ed è esattamente ciò che un catalogo fa al posto suo.

PufferPanel espone i suoi nodi, ma non la loro memoria, il disco o la CPU. Provibr segnala comunque il nodo, con capacità sconosciuta, perché un pannello di gioco senza nodo non è ordinabile.

Creare, avviare, arrestare, riavviare, forzare l’arresto, reinstallare ed eliminare funzionano tutti. L’eliminazione arresta prima il server, perché il daemon rifiuta di rimuovere un container in esecuzione.

PufferPanel non ha una sospensione propria. Quando Provibr sospende un server di gioco per far rispettare un limite di licenza, arresta il container e ne blocca l’accesso nel pannello Provibr.

Non c’è console: quella di PufferPanel si basa sul polling e non è un terminale dal vivo. I grafici si fermano a CPU e memoria, perché è tutto ciò che l’endpoint delle statistiche del pannello riporta. Provibr non gestisce il pannello, i suoi nodi, i file, i backup o gli utenti; un server di gioco sul pannello è l’integrazione.