Documentação
Pterodactyl
O Pterodactyl é a integração de painel de jogos. Um servidor de jogos é um contentor construído a partir de uma receita e não de uma imagem de sistema operativo, por isso quase tudo nele difere de uma máquina virtual, incluindo o facto de a consola ser o principal e não um extra.
Duas chaves, não uma
O Pterodactyl divide a sua API em duas, e o Provibr precisa das duas metades. Fazem trabalhos diferentes e uma não pode substituir a outra.
- Chave de aplicação: criar, suspender, reinstalar, eliminar e ler. Começa por ptla_.
- Chave de cliente: controlo de energia, medições de utilização e a consola. Começa por ptlc_.
- Host: o endereço do painel. Não é preenchida nenhuma porta: um painel do Pterodactyl é um site normal atrás de um proxy inverso.
Definições
Um único campo opcional: o endereço de e-mail que fica proprietário dos servidores que o Provibr cria. Deixe-o vazio e o proprietário passa a ser a conta por trás da chave de cliente. Indique um endereço que ainda não exista no painel e é criada uma conta para ele.
As palavras que o Pterodactyl usa
- Egg
- A receita de construção: que imagens de contentor podem ser usadas, o comando de arranque, e as suas próprias variáveis. Um egg é o que se escolhe em vez de um sistema operativo.
- Nest
- Um grupo de eggs. É uma etiqueta; o egg é o que é realmente referenciado.
- Nó
- Uma máquina que executa o Wings, o daemon que faz funcionar os contentores. Se não escolher nenhum, é escolhido o nó com mais memória livre, saltando os nós em manutenção e os nós que não são públicos.
- Alocação
- O endereço e a porta em que um servidor escuta. O painel distribui-os a partir da sua própria lista; o Provibr não atribui endereços aqui, porque seria uma promessa que não pode cumprir.
Planos de jogos
Um plano de jogos é onde o contentor inteiro é descrito, e é a única forma de encomendar um servidor de jogos. Não há formulário de encomenda manual para isso, porque há demasiada coisa que tem de encaixar para ser escrita de cada vez.
- Um egg numa integração, com o nest registado como etiqueta.
- Opcionalmente, uma imagem de contentor e um comando de arranque. Deixados vazios, decide o egg.
- Valores de variáveis que substituem as predefinições do egg. Todas as variáveis que o egg tem são enviadas, incluindo as que o cliente nunca vê, porque o painel recusa uma criação a que falte um campo.
- Memória, swap, disco, CPU e peso de E/S. Zero significa sem limite para a memória, o swap, o disco e o CPU.
- Quantas bases de dados, alocações adicionais e cópias de segurança o servidor pode ter.
O que pode fazer
Iniciar, parar, reiniciar, forçar a paragem, suspender, retomar, atualizar o estado, reinstalar e eliminar. Aqui, a diferença entre as opções mais suaves e as mais duras conta mais do que noutros sítios.
- «Parar» envia para a consola o comando de paragem do próprio egg, para que o jogo encerre como espera.
- «Forçar a paragem» para o contentor de imediato. Tudo o que ainda não foi escrito no disco perde-se, e o painel pede confirmação.
- «Suspender» para o servidor e bloqueia o acesso ao seu proprietário. Os ficheiros mantêm-se. É também o que a plataforma usa quando ultrapassa o limite da sua licença.
- «Reinstalar» executa novamente o contentor de instalação do egg. O que isso faz aos ficheiros existentes é escolha do egg e não nossa, e a confirmação di-lo.
Consola
A consola é um terminal no contentor em execução, retransmitido do Wings, através do seu agente, até ao seu navegador. Vê a saída da consola, as mudanças de estado e a utilização; pode enviar comandos. Está descrita com mais pormenor na página da consola.
Adotar servidores que já existem
O separador de importação lista os servidores no painel com os seus limites e o seu estado, incluindo os que o Provibr já conhece, que são mostrados mas não selecionáveis. Os servidores importados contam para a sua capacidade exatamente como os que encomendou.
Bom saber
- Gerir o próprio painel, ou os seus nós, não existe. O Provibr constrói, executa e remove servidores num painel que continua a ser seu.
- As cópias de segurança, as bases de dados e as alocações adicionais são limites definidos no plano; usá-las acontece no próprio painel de jogos. As contagens vêm com a sondagem.
- O painel guarda em cache os seus números de utilização durante cerca de vinte segundos, e o Provibr sonda mais ou menos com o mesmo ritmo. O processador, a memória e o disco estão sempre certos; uma leitura repetida pode mostrar uma taxa de rede de zero onde houve tráfego.
- O Pterodactyl 1.x não comunica a sua própria versão através da API, por isso o teste de ligação deixa esse campo vazio. Isso não é uma falha.