Criar uma compilação com arquivos no Amazon S3 - Amazon GameLift Servers

Criar uma compilação com arquivos no Amazon S3

É possível armazenar os arquivos de compilação no Amazon S3 e enviá-los para o Amazon GameLift Servers a partir daí. Ao criar sua compilação, você especifica o local do bucket do S3 e o Amazon GameLift Servers recupera os arquivos de compilação diretamente do Amazon S3.

Para criar um recurso de compilação

  1. Armazene os arquivos de compilação no Amazon S3. Crie um arquivo .zip contendo os arquivos de compilação empacotados e faça upload deles para um bucket do S3 na sua Conta da AWS. Anote o rótulo do bucket e o nome do arquivo; você precisará deles ao criar uma compilação do Amazon GameLift Servers.

  2. Dê ao Amazon GameLift Servers acesso aos arquivos de compilação. Crie um perfil do IAM seguindo as instruções em Acesse um arquivo de compilação do jogo no Amazon S3. Após ter criado a função, anote o nome do recurso da Amazon (ARN) da nova função, você precisará disso ao criar uma compilação.

  3. Criar uma compilação. Use o console do Amazon GameLift Servers ou a AWS CLI o para criar um registro de compilação. Você deve ter a PassRole permissão, conforme descrito emExemplos de permissão do IAM para o Amazon GameLift Servers.

Console

  1. No console do Amazon GameLift Servers, no painel de navegação, escolha Hospedagem, Compilações.

  2. Na página Compilações, escolha Criar compilação.

  3. Na página Criar compilação, em Configurações de compilação, faça o seguinte:

    1. Em Nome, insira um nome de script.

    2. Em Versão, insira uma versão. Como você pode atualizar o conteúdo de uma compilação, os dados da versão podem ajudá-lo a monitorar as atualizações.

    3. Em SO (Sistema operacional), escolha o sistema operacional da versão do seu servidor de jogos. Não é possível atualizar esse valor posteriormente.

    4. Em Compilaação de servidor de jogo, insira o URI do S3 do objeto de compilação que você carregou no Amazon S3 e escolha a versão do objeto. Caso não se lembre do URI e da versão do objeto do Amazon S3, escolha Browse S3 e pesquise o objeto de construção.

    5. Para o perfil do IAM, escolha a função criada para dar ao Amazon GameLift Servers acesso ao seu bucket do S3 e ao objeto de compilação.

  4. (Opcional) Em Tags, adicione tags à compilação inserindo pares de Chave e Valor.

  5. Escolha Criar.

O Amazon GameLift Servers atribui uma ID ao nova compilação e carrega o arquivo .zip designado. Visualize a nova compilação, incluindo o status, na página Compilações.

AWS CLI

Para definir a nova compilação e fazer upload dos arquivos de compilação do servidor, use o comando create-build.

  1. Abra uma janela de linha de comando e alterne para um diretório em que você possa usar a AWS CLI.

  2. Digite o comando create-build:

    aws gamelift create-build \
    --name user-defined name of build \
    --server-sdk-version server SDK for Amazon GameLift Servers version \
    --operating-system supported OS \
    --build-version user-defined build number \
    --storage-location "Bucket"=S3 bucket label,"Key"=Build .zip file name,"RoleArn"=Access role ARN} \
    --region region name

    • name – Um nome descritivo para a nova compilação

    • server-sdk-version – A versão do SDK do servidor Amazon GameLift Servers usada para integrar seu servidor de jogos ao Amazon GameLift Servers. Se você não fornecer um valor, o Amazon GameLift Servers usa o valor padrão 4.0.2.

    • operating-system – O ambiente de runtime da compilação do servidor de jogo. Especifique um valor de OS. Não é possível atualizá-lo mais tarde.

    • build-version – Os detalhes da versão dos arquivos de compilação. Essas informações podem ser úteis porque cada nova versão do seu servidor de jogos requer um novo recurso de compilação.

    • storage-location

      • Bucket – O nome do bucket do S3 que contém a compilação. Por exemplo: "my_build_files".

      • Key – O nome do arquivo .zip que contém os arquivos de compilação. Por exemplo, "my_game_build_7.0.1, 7.0.2".

      • RoleARN – O ARN atribuído ao perfil do IAM criado. Pro exemplo: "arn:aws:iam::111122223333:role/GameLiftAccess". Para visualizar um exemplo de política, consulte Acesse um arquivo de compilação do jogo no Amazon S3.

    • region – Crie a compilação na Região AWS onde você planeja implantar frotas. Se você estiver implantando o jogo em várias Regiões, crie uma compilação em cada região.

      nota

      É recomendável verificar sua região padrão atual usando o configure get comando. Para alterar sua região padrão, use o comando configure set.

    Exemplo

    aws gamelift create-build \
    --operating-system WINDOWS_2022 \
    --storage-location "Bucket"="my_game_build_files","Key"="mygame_build_101.zip","RoleArn"="arn:aws:iam::111122223333:role/gamelift" \
    --name "My Game Nightly Build" \
    --build-version "build 101" \
    --region us-west-2

  3. Para visualizar a nova compilação, use o comandodescribe-build.