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á.

Tutorial: Integração rápida com o Amazon GameLift Servers invólucro

Bem-vindo ao tutorial de integração do. Amazon GameLift Servers Neste tutorial, você implanta rapidamente seu servidor de jogos para ser hospedado em uma frota de recursos computacionais baseados em nuvem. Use este tutorial para evitar o trabalho de integrar o SDK do servidor ao código do jogo e, Amazon GameLift Servers em vez disso, implante seu jogo com a funcionalidade mínima para se comunicar com o Amazon GameLift Servers serviço e executar sessões de jogo. Você configurará uma solução básica de hospedagem e a usará para experimentar toda a gama de recursos, como escalonamento automático e matchmaking. Também é uma ótima maneira de hospedar um protótipo do seu jogo como parte de uma demonstração ao vivo ou para testes.

Principais benefícios desse método de integração:

Pré-requisitos

Antes de começar, verifique se você tem:

Visão geral

Neste tutorial, você irá:

Etapa 1: Obtenha e construa o invólucro do servidor de jogos

Use os comandos a seguir para obter a fonte do wrapper do servidor de jogos e criar o wrapper. Esses comandos usam SSH, mas você também pode acessar diretamente o repositório do Github.

Windows

> git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
> cd amazon-gamelift-servers-game-server-wrapper
> powershell -file .\build.ps1
            

Mac e Linux

$ git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
$ cd amazon-gamelift-servers-game-server-wrapper
$ make
            

Em uma compilação bem-sucedida, um diretório “de saída” é adicionado aoamazon-gamelift-servers-game-server-wrapper. Nesse diretório, há três pastas, uma para cada opção de frota de hospedagem compatível, que contêm um conjunto de artefatos de construção. Neste tutorial, você está implantando em EC2 frotas gerenciadas, então você usará a pasta. gamelift-servers-managed-ec2

Etapa 2: Prepare a versão do seu servidor de jogo

Nesta etapa, você prepara os arquivos de compilação do servidor de jogos para serem enviados para o. Amazon GameLift Servers

Crie o diretório do jogo

Agora, prepare um diretório de jogo em sua máquina local. Esse diretório deve conter todos os arquivos que você precisa para executar seu servidor de jogosAmazon GameLift Servers. Isso inclui o wrapper do servidor do jogo, a compilação do servidor do jogo e o config.yaml que faz o wrapper funcionar com o servidor do jogo.

Use as seguintes etapas:

Um exemplo de estrutura de diretórios terá a seguinte aparência:

gamelift-servers-managed-ec2
│-- config.yaml
│-- amazon-gamelift-servers-game-server-wrapper
│-- MyGame
│   │-- server-executable.exe
│   │-- my-game-settings
│   │ ......
            

Etapa 3: configurar a embalagem para sua frota

Amazon GameLift Serversgerencia o ciclo de vida das instâncias computacionais de uma frota, criando novas instâncias com a criação do servidor instalada e reciclando instâncias conforme necessário. O serviço gerencia o ciclo de vida do processo do servidor de jogos que é executado em cada instância. Uma EC2 frota gerenciada pode ter instâncias em vários locais para oferecer suporte aos jogadores onde quer que estejam.

Edite o arquivo config.yaml para configurar o wrapper para registro, configuração de portas e inicialização do servidor.

Exemplo de configuração:

log-config:
  wrapper-log-level: debug
game-server-logs-dir: ./game-server-logs
ports:
  gamePort: 37016
game-server-details:
  executable-file-path: ./MyGame/my-server-executable
game-server-args:
  - arg: "--port"
    val: "{{.gameport}}"
    pos: 0
        

Etapa 4: faça o upload da versão do servidor do jogo

Agora você concluiu todos os elementos necessários da compilação do servidor de jogos (wrapper do servidor de jogos, config.yaml e arquivos do servidor de jogos) e está pronto para fazer o upload da compilação do jogo para hospedagem. Amazon GameLift Servers A maneira mais rápida de fazer o upload da versão do seu jogo é usando o AWS CLI comandoupload-build, conforme mostrado no exemplo a seguir.

Fazendo o upload de uma versão de jogo com o Windows:

aws gamelift upload-build \
    --name gamelift-test-2025-03-11-1 \
    --build-version gamelift-test-2025-03-11-1 \
    --build-root out/windows/amd64/gamelift-servers-managed-ec2 \
    --operating-system WINDOWS_2016 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

Ao criar a compilação, registre a ID da compilação da resposta da API para usá-la na criação da frota.

Etapa 5: criar a EC2 frota gerenciada

As etapas a seguir descrevem uma configuração mínima da frota, para que você possa começar a trabalhar o mais rápido possível.

Para criar sua frota:

Etapa 6: criar e conectar-se a uma sessão de jogo

Quando o status da sua frota mostra Ativo, isso significa que os servidores do jogo estão prontos e aguardando para hospedar uma sessão de jogo. Para iniciar uma sessão de jogo, faça uma solicitação de sessão de jogo ao Amazon GameLift Servers serviço. Aqui, você usará o AWS CLI para fazer essa solicitação.

Use o seguinte para criar uma sessão de jogo:

aws gamelift create-game-session \
--fleet-id <FLEET_ID> \
--game-properties '[{"Key": "exampleProperty", "Value": "exampleValue"}]' \
--maximum-player-session-count 3 \
--region us-west-2
        

Você também pode passar propriedades personalizadas do jogo para o executável do servidor. Consulte os argumentos do servidor de jogo no README para obter detalhes. Ao receber a create-game-session chamada, eles Amazon GameLift Servers informam o wrapper para iniciar o executável do servidor do jogo e iniciar uma sessão de jogo. O que está nele config.yaml afeta a configuração do servidor do jogo e os parâmetros de inicialização definidos no console determinam a configuração da sessão de jogo em si.

Exemplo de formato para adicionar propriedades do jogo:

defaultArgs:
        - arg: "--port"
          val: "{{.GamePort}}"
          pos: 0
        - arg: "--ipAddress"
          val: "{{.IpAddress}}"
          pos: 1
        - arg: "--gameSessionId"
          val: "{{.GameSessionId}}"
          pos: 2
        

Etapa 7: Gerencie e monitore sua frota

Agora que sua frota de servidores de jogos está configurada e uma sessão de jogo foi iniciada, você pode gerenciá-la e monitorá-la no Amazon GameLift Servers console. A melhor maneira de fazer isso é na página de detalhes da frota, onde você pode editar os detalhes da frota ou alterar o dimensionamento e a capacidade da frota na guia Escalonamento. Consulte a seção a seguir sobre como escalar seus servidores de jogos.

Escolha a guia Métricas para visualizar gráficos que descrevem o monitoramento das métricas de atividade e hardware. Para obter detalhes sobre os gráficos de métricas, escolha o link Informações ao lado do ID da sua frota. Além disso, embora você possa monitorar de perto seus servidores de jogos na guia Métricas, você também pode adicionar alarmes a essas métricas no CloudWatch painel.

Para navegar até o CloudWatch painel a partir do console:

Etapa 8: escale seus servidores de jogos

Para a próxima etapa, você configura o escalonamento automático. Com o escalonamento automático, você escala dinamicamente a capacidade da sua frota em resposta à atividade do servidor do jogo. Conforme os jogadores chegam e iniciam as sessões de jogo, o escalonamento automático adiciona mais instâncias e, à medida que a demanda dos jogadores diminui, o escalonamento automático libera instâncias não utilizadas. Essa é uma forma eficaz de minimizar seus recursos e custos de hospedagem e, ao mesmo tempo, proporcionar uma experiência de jogador tranquila e rápida.

Ao se preparar para o lançamento do jogo, você deve configurar o escalonamento automático para suas frotas. O escalonamento automático é recomendado como uma forma eficaz de minimizar seus recursos e custos de hospedagem e, ao mesmo tempo, proporcionar uma experiência de jogador tranquila e rápida.

Para configurar manualmente a capacidade da frota

Para configurar manualmente a capacidade da frota

Para usar o escalonamento automático baseado em metas

Para usar o escalonamento automático baseado em metas

O escalonamento automático baseado em metas (rastreamento de metas) vincula o escalonamento da frota à porcentagem de sessões de jogo disponíveis. À medida que os jogadores começam a jogar seu jogo e as sessões de jogo disponíveis diminuem, ele responde adicionando automaticamente mais instâncias à frota.

O escalonamento automático baseado em regras oferece um controle mais granular, como a capacidade de vincular o escalonamento a outras métricas da frota e definir limites personalizados e respostas de escalabilidade. Ele oferece opções poderosas, mas também requer o uso da CLI e testes significativos para entender como as regras personalizadas se comportam em ação. Este tutorial se concentra em primeiro configurar a abordagem baseada em metas.

Solução de problemas comuns

A seguir estão os problemas comuns que você pode encontrar ao executar seus servidores e sessões de jogo. Quando o servidor ou a sessão do jogo não estão funcionando corretamente, a primeira etapa é verificar os registros, o que pode revelar um dos problemas descritos abaixo para novas implantações ou jogos em produção.

O seguinte geralmente é revelado nos registros:

Para ver os registros de eventos da sua Amazon GameLift Servers frota

Para ver os registros de eventos da sua Amazon GameLift Servers frota

Para ver os registros da sessão do jogo

Para ver os registros da sessão do jogo

Para ver os registros da sessão do jogo com a CLI, use a GetGameSessionLogURL API. Amazon GameLift Serversarmazena automaticamente os registros por 14 dias.

Você também pode configurar CloudWatch os registros da Amazon para sua frota. Isso fornece recursos adicionais de registro e integração com outros serviços AWS de monitoramento.

Para acesso aos registros em tempo real ou períodos de retenção estendidos por meio de CloudWatch:

Próximas etapas