Trabalhe com o Amazon GameLift Servers agente - Amazon GameLift Servers

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhe com o Amazon GameLift Servers agente

O Amazon GameLift Servers agente supervisiona a execução dos processos do servidor de jogos em suas Amazon GameLift Servers frotas. Implantado em cada computação de uma frota, o Agent fornece gerenciamento automatizado de processos, gerenciamento de hospedagem e registro em log para a computação. Para usar o Agente, você deve ter sua compilação de servidor de jogos integrada ao SDK do servidor para a Amazon GameLift Servers versão 5.x ou posterior.

O Amazon GameLift Servers Agente está disponível externamente para uso com Amazon GameLift Servers frotas que não são frotas gerenciadas EC2. ( EC2 As frotas gerenciadas lidam com as tarefas do agente automaticamente.) Você pode optar por operar Amazon GameLift Servers frotas, incluindo frotas em qualquer lugar, com ou sem o agente. Sem o Agent, será necessário uma solução alternativa para realizar as tarefas necessárias.

Quando implantado em um computador, o Amazon GameLift Servers Agente deve ser iniciado antes que qualquer processo do servidor do jogo seja iniciado. No início, o Agent realiza as seguintes tarefas:

  • Registra a computação com uma frota Amazon GameLift Servers Anywhere usando a RegisterComputeAPI.

  • Chama a GetComputeAuthTokenAPI para buscar um token de autorização e o armazena para uso pelos processos do servidor que estão sendo executados na computação.

  • Define a variável de ambiente de WebSocket URL para a computação e estabelece uma WebSocket conexão com o Amazon GameLift Servers serviço.

  • Solicita a versão mais recente da configuração de tempo de execução da frota do Amazon GameLift Servers serviço.

  • Inicia e interrompe os processos do servidor de acordo com as instruções de configuração de tempo de execução.

O código-fonte e as instruções de criação do Amazon GameLift Servers Agente estão disponíveis no Amazon GameLift ServersAgente GitHub.

Sobre o Agent

O Amazon GameLift Servers Agente foi projetado para lidar com as seguintes tarefas para suas frotas:

Gerenciamento de processos

  • Inicia novos processos do servidor conforme definido nas instruções de tempo de execução. O Agent pode usar uma configuração de tempo de execução personalizada que é implantada com o Agent. Como alternativa, é possível fornecer uma RuntimeConfiguration como parte da definição da frota. Essa abordagem tem a vantagem de permitir a modificação da configuração de tempo de execução da frota a qualquer momento. O Agente solicita periodicamente configurações de tempo de execução atualizadas do Amazon GameLift Servers serviço.

  • Monitora as ativações dos processos do servidor e encerra os processos quando eles não são ativados a tempo.

  • Envia batimentos cardíacos para. Amazon GameLift Servers Se o Agent não enviar heartbeats, a computação poderá ser marcada como obsoleta.

  • Relata Amazon GameLift Servers quando um processo do servidor termina. Amazon GameLift Serversusa essas informações para monitorar a disponibilidade do servidor de jogos para o posicionamento da sessão de jogo.

  • Emite eventos de frota para processos de servidor, incluindo:

    • SERVER_PROCESS_INVALID_PATH: os parâmetros de inicialização do processo do servidor de jogos foram configurados incorretamente.

    • SERVER_PROCESS_TERMINATED_UNHEALTHY: o processo do servidor de jogos não relatou uma verificação de integridade válida dentro de 3 minutos após a ativação e, portanto, foi encerrado.

    • SERVER_PROCESS_FORCE_TERMINATED: o processo do servidor de jogos não foi encerrado corretamente após o envio de OnProcessTerminate() dentro de 30 segundos.

    • SERVER_PROCESS_CRASHED: um processo do servidor de jogos travou por algum motivo.

Gerenciamento de computação

  • Recebe mensagens do Amazon GameLift Servers serviço para desligar a computação.

  • Solicita que a computação seja encerrada por. Amazon GameLift Servers

Registro em log

  • Carrega registros em um bucket do Amazon S3 em AWS sua conta.