Documentação

PufferPanel

Ligue uma instalação do PufferPanel e o Provibr cria, controla e importa servidores de jogo nela. Esta página descreve em que o PufferPanel difere dos outros painéis de jogo.

Credenciais OAuth2

O PufferPanel autentica-se com um cliente OAuth2 e não com uma chave de API: um ID de cliente e um segredo de cliente. Crie um no painel, na sua conta, e cole ambos no Provibr juntamente com o URL do painel.

Anfitrião: o URL completo do painel, por exemplo http://painel.example.com:8080. A porta 8080 é a predefinida de uma instalação nova; um painel atrás de um proxy inverso usa a 443, e não há porta que o Provibr possa acrescentar sem adivinhar.
ID de cliente: o identificador do cliente OAuth2.
Segredo de cliente: o segredo que pertence a esse cliente.
Impressão digital TLS (opcional): apenas para um anfitrião https://, para fixar o certificado.

O segredo de cliente é mostrado uma vez, ao criar o cliente. Copie-o de imediato: o PufferPanel não o volta a mostrar, e um segredo copiado a meio dá um erro de autenticação normal em vez de indicar que está incompleto.

O que o cliente pode fazer segue a conta a que pertence. Atribua-lhe uma conta de administrador, para que possa criar e remover servidores.

Transporte

Um PufferPanel novo usa HTTP simples na porta 8080. Se o painel estiver atrás de TLS com um certificado autoassinado, indique a sua impressão digital; o agente confia então apenas nesse certificado em vez de desligar a verificação. Leia-a com:

shell

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

Os comandos e a saída do terminal estão em inglês em todo o lado, no painel e nestas páginas. Um só texto, uma só verdade: o que aqui se lê é literalmente o que o seu host vai devolver.

Deixe o campo vazio para um certificado de uma autoridade pública, e também quando o painel só estiver acessível por http: uma impressão digital ao lado de um endereço http é recusada, porque não há certificado a fixar. Um painel em http simples funciona, mas o segredo de cliente e tudo o que a integração faz viajam então sem cifra.

Modelos

O PufferPanel constrói um servidor a partir de um modelo da comunidade, como o minecraft ou o factorio, em vez de um egg numerado. O Provibr lista os modelos por nome; a definição completa, com as suas variáveis, é obtida ao encomendar, pelo que o editor de variáveis do plano recorre aos valores predefinidos do modelo.

Um modelo da comunidade usa por predefinição um ambiente de anfitrião, que precisa de binários que um anfitrião de painel novo não tem. O Provibr muda para a variante docker do modelo, que os leva na sua imagem: um servidor que, de outro modo, não se construiria por um binário em falta.

Planos

Um plano de jogo leva o nome do modelo e os limites de recursos. A encomenda passa por um plano e não há via manual: o PufferPanel exige a definição completa do modelo em linha, que é exatamente o que um catálogo trata por si.

Colocação

O PufferPanel expõe os seus nós, mas não a sua memória, disco ou CPU. O Provibr comunica o nó mesmo assim, mas com capacidade desconhecida, porque um painel de jogo sem nó nenhum não pode ser encomendado.

O motor coloca num nó desses sem o ordenar por espaço livre, porque não há nada a medir. Um painel com vários nós é escolhido por ordem de nome, não por qual tem mais espaço.

Ciclo de vida

Criar, iniciar, parar, reiniciar, forçar a paragem, reinstalar e eliminar funcionam todos. Eliminar para o servidor primeiro, porque o daemon recusa-se a remover um contentor em execução.

Suspensão

O PufferPanel não tem uma suspensão própria. Quando o Provibr suspende um servidor de jogo para fazer cumprir um limite de licença, o contentor é parado e o acesso a ele fica bloqueado no painel Provibr.

Como o painel não impõe a suspensão, qualquer pessoa com acesso direto à instalação do PufferPanel pode voltar a iniciar o servidor. O bloqueio é um conceito do Provibr, não do painel, e é isso que torna honesto dizer que o fornecedor não o impõe.

O que o Provibr não faz

Não há consola: a do PufferPanel baseia-se em sondagem e não é um terminal ao vivo. Os gráficos de utilização ficam-se pelo CPU e pela memória, porque é tudo o que o ponto de estatísticas do painel comunica. O Provibr não gere o painel, os seus nós, ficheiros, cópias de segurança ou utilizadores; um servidor de jogo no painel é a integração.

AnteriorPelican SeguinteGameAP