Atualizar uma definição de grupo de contêineres para uma frota de contêineres do Amazon GameLift Servers - 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á.

Atualizar uma definição de grupo de contêineres para uma frota de contêineres do Amazon GameLift Servers

Você pode atualizar a maioria das propriedades de uma definição de grupo de contêineres, incluindo as definições de contêineres individuais. As definições de grupos de contêineres têm um número de versão. Quando você atualiza uma definição de grupo de contêineres, o Amazon GameLift Servers salva a atualização e incrementa o número da versão da definição. Ao criar uma frota de contêineres, você pode especificar a versão da definição de um grupo de contêineres a implantar.

Depois de atualizar a definição de um grupo de contêineres, você pode implantar a nova versão em uma frota de contêineres nova ou existente.

Atualizar uma definição de grupo de contêineres do servidor de jogos

Este tópico descreve como atualizar uma definição de grupo de contêineres de servidores de jogos usando o console do Amazon GameLift Servers ou as ferramentas da AWS CLI. Para obter informações mais detalhadas sobre atributos opcionais, consulte Personalizar uma frota de contêineres do Amazon GameLift Servers.

Para atualizar uma definição de grupo de contêineres:

Console

No console do Amazon GameLift Servers, selecione a Região da AWS onde você deseja criar o grupo de contêineres.

Abra a barra de navegação esquerda do console e escolha Contêineres gerenciados: Definições de grupos. Na página de definição de grupos de Contêineres, escolha uma definição e uma versão do grupo de contêineres para atualizar.

Depois de salvar suas atualizações, você pode usar a nova versão para criar novas frotas de contêineres ou implantar as atualizações em uma frota de contêineres existente.

Etapa 1: Definir detalhes da definição do grupo de contêineres
  • Você pode atualizar as configurações de limite total de memória e vCPU.

Etapa 2: Adicionar definições de contêiner

Você pode usar o seguinte exemplo de atualização de definição de contêiner:

  • Atualizar definições de contêiner existentes.

  • Adicione novas definições de contêiner de suporte.

  • Remova as definições de contêiner de suporte.

  1. Você pode atualizar o URI da imagem de ECR. Certifique-se de atualizar a configuração da versão do SDK do Servidor para corresponder à nova imagem.

  2. Você pode atualizar o Intervalo de portas internas do contêiner conforme necessário. As alterações feitas nessas configurações podem afetar as configurações da porta de conexão de uma frota de contêineres quando essas alterações são implantadas em uma frota. Consulte mais detalhes em Configurar conexões de rede.

Etapa 3: Configurar dependências
Etapa 3: revisar e criar
  • Revise as atualizações de definição do seu grupo de contêineres. Use Editar para fazer alterações adicionais em qualquer seção. Ao terminar, escolha Criar para gerar uma nova versão da definição do grupo de contêineres.

    Se sua solicitação for bem-sucedida, o console exibirá a página de detalhes do novo recurso de definição de grupo de contêineres. Inicialmente, o status é COPYING, pois o Amazon GameLift Servers começa a tirar instantâneos de todas as imagens de contêineres do grupo. Quando essa fase for concluída, o status da definição do grupo de contêineres será alterado para READY. Uma definição de grupo de contêineres deve estar no status READY antes que você possa criar uma frota de contêineres com ela.

AWS CLI

Ao usar a AWS CLI para criar ou atualizar uma definição de grupo de contêineres, mantenha suas configurações de definição de contêiner em um arquivo de JSON separado. Você pode referenciar o arquivo no comando da CLI. Consulte Criar um arquivo JSON de definição de contêiner para obter exemplos de esquemas.

Ao atualizar uma definição, você só precisa especificar os valores que deseja atualizar. O Amazon GameLift Servers retém todos os valores que você não inclui na sua solicitação de atualização. Se você estiver alterando uma definição de contêiner. No entanto, ao alterar a definição de um contêiner, forneça um conjunto completo.

Para atualizar uma definição de grupo de contêineres

Para atualizar uma nova definição de grupo de contêineres, use o comando da update-container-group-definition CLI. Para obter mais informações sobre este comando, consulte update-container-group-definition na referência de comandos da AWS CLI.

exemplo: grupo de contêineres de servidores de jogos

Você pode especificar uma versão de definição de grupo de contêineres ao recuperar, atualizar ou excluir uma definição de grupo de contêineres ou ao criar ou atualizar uma frota de contêineres. Cada definição de grupo de contêineres tem uma propriedade de versão. Além disso, o valor ARN da definição especifica o número da versão.

Este exemplo ilustra uma solicitação para mudar para a definição de um grupo de contêineres de servidores de jogos. Ele pressupõe que você tenha criado um arquivo JSON com as definições de contêiner desse grupo. Este exemplo usa o valor ARN para o nome da definição e especifica que a atualização é para a versão 1.

aws gamelift update-container-group-definition \ --name arn:aws:gamelift:us-west-2:111122223333:containergroupdefinition/MyAdventureGameContainerGroup:1 \ --operating-system AMAZON_LINUX_2023 \ --container-group-type GAME_SERVER \ --total-memory-limit-mebibytes 4096 \ --total-vcpu-limit 1 \ --container-definitions file://SimpleServer.json

Clonar uma definição de grupo de contêineres

Você pode usar o console do Amazon GameLift Servers para clonar uma definição de grupo de contêineres existente.

Para clonar um grupo de contêineres
  1. No console do Amazon GameLift Servers, vá para o painel de navegação à esquerda e escolha Grupos de contêineres.

  2. Na página de listagem de grupos de contêineres, selecione o grupo de contêineres existente que você deseja clonar. Depois de selecionar um grupo de contêineres, o botão Clonar fica ativo.

  3. Escolha Clonar. Essa ação abre o assistente de criação de grupos de contêineres com configurações pré-preenchidas.

  4. Insira um novo nome para o grupo de contêineres clonados. Um grupo de contêineres na mesma região deve ter nomes exclusivos.

  5. Percorra o grupo de contêineres e as páginas de definição de contêineres, revise e Crie o novo grupo de contêineres.