Configurar testes locais com o Amazon GameLift Servers Anywhere

Para criar a frota Anywhere

1. Crie um local personalizado para a estação de trabalho local. (AWS CLI ou console). Um local personalizado é simplesmente um rótulo para o recurso de computação que você planeja incluir na frota Anywhere. Os nomes de locais personalizados devem começar com custom-. Por exemplo: custom-my_laptop. Consulte Criar uma política personalizada.

2. Crie uma frota Anywhere (AWS CLI ou console). Nesta etapa, crie o recurso de frota com o local personalizado para a estação de trabalho local. Consulte Criar uma frota Anywhere.

   Anote o valor do ID ou ARN da nova frota. Você precisará desse valor na próxima etapa.

3. Registre a estação de trabalho local como uma computação de frota (somente a AWS CLI). Uma frota Anywhere precisa ter pelo menos um recurso de computação para hospedar os servidores de jogos. Consulte Adicionar um recurso de computação à frota. Para adicionar uma computação à frota, você precisa das seguintes informações:

   • Um nome de recurso de computação. Cada recurso de computação em uma frota deve ter um nome exclusivo.

   • O identificador da frota Anywhere. Você pode usar o FleetID ou o FleetArn.

   • As informações de conexão do recurso de computação. Especifique um IpAddress ou DnsName. É assim que o Amazon GameLift Servers e os clientes de jogos se conectarão aos servidores de jogos.

   • Um local personalizado na frota Anywhere.

   Anote o valor de retorno do GameLiftServiceSdkEndpoint. Você precisará desse valor ao atualizar o servidor de jogos para funcionar em uma frota Anywhere.

Como preparar o servidor de jogos para uma frota Anywhere

1. Obtenha um token de autenticação. O servidor de jogos deve incluir um token de autenticação em cada comunicação com o serviço do Amazon GameLift Servers. Os tokens de autenticação do Amazon GameLift Servers têm curta duração e devem ser atualizados regularmente.

   Como prática recomendada, crie um script para concluir as seguintes tarefas:

   • Chame a ação get-compute-auth-token da AWS CLI.

   • Armazene o valor do token retornado onde os processos do servidor de jogos possam recuperá-lo, como em uma variável de ambiente na computação local.

   Instale o script com o servidor de jogos no recurso de computação. Defina o script para ser executado antes de iniciar o primeiro processo do servidor de jogos. Enquanto os processos do servidor de jogos estiverem ativos, execute o script regularmente para manter um token de autenticação válido. Todos os processos do servidor de jogos no recurso de computação podem usar o mesmo token de autenticação.

2. Atualize seu código de servidor de jogos de Amazon GameLift Servers. Ao integrar o código do servidor de jogos ao SDK do servidor para o Amazon GameLift Servers, você adicionou uma chamada à ação InitSdk(). Quando o servidor de jogos é executado em uma frota Anywhere, essa chamada requer parâmetros adicionais do servidor. Para obter mais informações, consulte Inicializar o processo do servidor e SDK 5.x do servidor para Amazon GameLift Servers para a linguagem de desenvolvimento. Os parâmetros do servidor são:

   • webSocketUrl: defina esse parâmetro para o valor GameLiftServiceSdkEndpoint, que é retornado quando você registra uma computação na frota.

   • hostId: defina esse parâmetro com o nome da computação especificada ao registrar uma computação na frota do Anywhere.

   • fleetId: defina esse parâmetro para o ID da frota Anywhere.

   • authToken: defina esse parâmetro como o token, que é retornado em resposta a uma solicitação para recuperar um token de autenticação para uma computação.

   • processId: defina esse parâmetro para identificar um processo do servidor de jogos que está sendo executado na computação local. Cada processo simultâneo do servidor de jogos deve ter um ID de processo exclusivo.

   Os valores dos parâmetros do servidor que cada processo do servidor de jogos usa precisam ser específicos para a computação da frota do Anywhere em que o processo está sendo executado. Para obter detalhes sobre como obter os valores apropriados para um cálculo, consulte Adicionar um recurso de computação à frota. Como prática recomendada, defina webSocketUrl, hostId, fleetId e authToken como variáveis de ambiente na computação local. Todos os processos do servidor executados na computação usarão esses valores.

3. Instale a versão do servidor de jogos na computação local. Inclua todas as dependências necessárias para executar o servidor de jogos.

4. Inicie um ou mais processos do servidor de jogos em execução na computação local. Quando o processo do servidor de jogos chama a ação ProcessReady() do SDK do servidor, o processo está pronto para hospedar uma sessão de jogo.

1. Apague a GameSession existente. Se o processo do servidor de jogos travar ou não chamar ProcessEnding(), o Amazon GameLift Servers apagará a GameSession depois que o servidor de jogos parar de enviar verificações de integridade.

2. Gere uma nova compilação de servidor de jogos. Faça alterações no servidor de jogos e empacote uma versão revisada.

3. Atualize a compilação do servidor de jogos na computação local. Sua frota Anywhere anterior ainda está ativa e seu laptop ainda está registrado como um recurso computacional na frota.

4. Obtenha um token de autorização atualizado. Chame o comando get-compute-auth-token da CLI e armazene o token na computação local.

5. Inicie um ou mais processos do servidor de jogos em execução na computação local. Quando o processo do servidor de jogos chama ProcessReady(), ele está pronto para ser usado para testes.