Ir para o conteúdo

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.
Crie as duas chaves com a sessão iniciada como administrador. A chave de cliente de uma conta normal não vê os servidores de outras pessoas, e o teste de ligação di-lo em vez de deixar que se descubra mais tarde.
A troca das duas chaves é detetada antes de sair seja o que for do seu host, porque cada uma tem o seu próprio prefixo.

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 peso de E/S é a exceção: aí, zero não é sem limite. O painel só aceita um valor entre 10 e 1000, e um zero passa silenciosamente a 500.

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.
Nenhum resultado é aceite apenas sob palavra. O Pterodactyl confirma a maioria das alterações com uma resposta vazia, por isso cada uma destas ações termina por voltar a ler o servidor e comunicar o que realmente encontrou.

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.