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á.
# Amazon GameLift ServersCrie um recurso de criação para hospedagem gerenciada
Ao criar uma compilação e fazer upload dos arquivos, você tem algumas opções:
+ [Criar uma compilação usando um diretório de arquivos](gamelift-build-cli-uploading-upload-build.md). Esse é a opção mais simples e o mais usada.
+ [Crie uma compilação com arquivos no Amazon Simple Storage Service (Amazon S3](gamelift-build-cli-uploading-create-build.md)). Com essa opção, é possível gerenciar as versões de compilação no Amazon S3.
Com ambos os métodos, o Amazon GameLift Servers cria um recurso de compilação com um ID de compilação exclusivo e outros metadados. A compilação começa no status **Inicializado**. Após o Amazon GameLift Servers adquirir os arquivos do servidor do jogo, a compilação passa para o status **Pronto**.
Quando a compilação estiver pronta, você poderá implantá-la em uma nova frota do Amazon GameLift Servers. Para obter mais informações, consulte [Crie uma EC2 frota Amazon GameLift Servers gerenciada](fleets-creating.md). Quando o Amazon GameLift Servers configura a nova frota, ele baixa os arquivos de compilação para cada instância da frota e instala os arquivos de compilação.
# Criar uma compilação usando um diretório de arquivos
Para criar uma compilação de jogo armazenada em qualquer local, incluindo um diretório local, use o [https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html) AWS CLI comando. Esse comando cria um registro de compilação no Amazon GameLift Servers e faz upload de arquivos de um local especificado por você.
**Envie uma solicitação de upload.** Em uma janela da linha de comando, insira o comando **upload-build** e os parâmetros a seguir.
```
aws gamelift upload-build \
--name user-defined name of build \
--operating-system supported OS \
--server-sdk-version server SDK for Amazon GameLift Servers version \
--build-root build path \
--build-version user-defined build number \
--region region name
```
+ **operating-system** – O ambiente de execução da construção do servidor de jogos. Especifique um valor de OS. Não é possível atualizá-lo mais tarde.
+ **server-sdk-version** – A versão do SDK do servidor do Amazon GameLift Servers à qual o servidor de jogos está integrado. Se você não fornecer um valor, o Amazon GameLift Servers usa o valor padrão `4.0.2`. Caso especifique uma versão incorreta do SDK do servidor, a compilação do servidor do jogo poderá falhar ao chamar o `InitSdk` para estabelecer uma conexão com o serviço do Amazon GameLift Servers.
+ **build-root** – O caminho do diretório dos arquivos de compilação.
+ **name** – Um nome descritivo para a nova compilação.
+ **build-version** – Os detalhes da versão dos arquivos de compilação.
+ **region**— A AWS região onde você deseja criar sua construção. Crie a compilação na Região 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**
Visualize sua região padrão atual usando o [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). Para alterar sua Região padrão, use o comando [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html).
*Exemplos*
```
aws gamelift upload-build \
--operating-system AMAZON_LINUX_2023 \
--server-sdk-version "5.0.0" \
--build-root "~/mygame" \
--name "My Game Nightly Build" \
--build-version "build 255" \
--region us-west-2
```
```
aws gamelift upload-build \
--operating-system WINDOWS_2022 \
--server-sdk-version "5.0.0" \
--build-root "C:\mygame" \
--name "My Game Nightly Build" \
--build-version "build 255" \
--region us-west-2
```
Em resposta à sua solicitação de upload, o Amazon GameLift Servers fornece o progresso do upload. Em um upload bem-sucedido, o Amazon GameLift Servers retorna o novo ID de registro de compilação. O tempo de upload depende do tamanho dos arquivos de jogo e da velocidade da conexão.
# 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 a localização do bucket do S3 e 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 carregue-o em um bucket do S3 no seu. Conta da AWS Anote o rótulo do bucket e o nome do arquivo. Você precisará deles ao criar uma Amazon GameLift Servers compilação.
1. **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](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc). 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.
1. **Criar uma compilação.** Use o Amazon GameLift Servers console ou o AWS CLI para criar um novo registro de compilação. Você deve ter a `PassRole` permissão, conforme descrito em[Exemplos de permissão do IAM para o Amazon GameLift Servers](gamelift-iam-policy-examples.md).
------
#### [ Console ]
1. No [console do Amazon GameLift Servers](https://console.aws.amazon.com/gamelift/), no painel de navegação, escolha **Hospedagem**, **Compilações**.
1. Na página **Compilações**, escolha **Criar compilação**.
1. Na página **Criar compilação**, em **Configurações de compilação**, faça o seguinte:
1. Em **Nome**, insira um nome de script.
1. 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.
1. Em **SO (Sistema operacional)**, escolha o sistema operacional da versão do seu servidor de jogos. Não é possível atualizar esse valor posteriormente.
1. 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.
1. Para o **perfil do IAM**, escolha o perfil criado para dar ao Amazon GameLift Servers acesso ao seu bucket do S3 e ao objeto de compilação.
1. (Opcional) Em **Tags**, adicione tags à compilação inserindo pares de **Chave** e **Valor**.
1. 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 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html).
1. Abra uma janela de linha de comando e alterne para um diretório em que você possa usar a AWS CLI.
1. 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\$1build\$1files".
+ **Key** – O nome do arquivo .zip que contém os arquivos de compilação. Por exemplo, "my\$1game\$1build\$17.0.1, 7.0.2".
+ **RoleARN** – O ARN atribuído ao perfil do IAM criado. Por 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](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc).
+ **region**— Crie a construção na AWS região em que 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 [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html) comando[https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). Para alterar sua região padrão, use o comando [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html).
*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
```
1. Para visualizar a nova compilação, use o comando[https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html).
------