Conectar-se remotamente às instâncias da frota do Amazon GameLift Servers

1. No console do Amazon GameLift Servers, escolha EC2 gerenciado ou Contêineres gerenciados no painel de navegação e, em seguida, Frotas.

2. Escolha o ID da frota que contém a instância que deseja acessar.

3. Na página de detalhes da frota, escolha a guia Instâncias para ver todas as instâncias de computação da frota.

4. Selecione a instância com a qual deseja se conectar e escolha Conectar. Isso exibe a caixa de diálogo Conectar à instância, que informa sobre os detalhes da conexão e permite que você visualize o script que será usado para se conectar à sua instância. Confirme escolhendo Conectar novamente.

5. Na caixa de diálogo de conexão, escolha Executar para criar uma nova sessão SSM. O sistema autentica sua sessão por meio do AWS Key Management Service (AWS KMS) e abre um terminal no seu navegador.

As instruções a seguir descrevem como concluir essas tarefas usando a CLI da AWS. É necessário saber o ID da frota da instância à qual você deseja se conectar.

1. Obtenha o nome da computação. Obtenha uma lista de todas os recursos de computação ativos na frota. Chame list-compute com um ID ou ARN de frota. Para uma frota de localização única, especifique somente o identificador da frota. Para uma frota com vários locais, especifique o identificador da frota e um local. Com frotas EC2 gerenciadas, list-compute retorna uma lista de instâncias da frota, e a propriedade ComputeName é o ID da instância. Localize o recurso de computação que deseja acessar.

   Solicitação

   aws gamelift list-compute \
     --fleet-id  "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa" \
     --location ""sa-east-1"

   Resposta

   {
     "ComputeList": [
       {
         "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
         "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
         "ComputeName": "i-0abc12d3e45fa6b78",
         "IpAddress": "00.00.000.00",
         "DnsName": "b08444ki909kvqu6zpw3is24x5pyz4b6m05i3jbxvpk9craztu0lqrbbrbnbkks.uwp57060n1k6dnlnw49b78hg1rw4rcz7.us-west-2.amazongamelift.com",
         "ComputeStatus": "Active",
         "Location": "sa-east-1",
         "CreationTime": "2023-07-09T22:51:45.931000-07:00",
         "OperatingSystem": "AMAZON_LINUX_2023",
         "Type": "c4.large"
       }
     ]
   }

2. Localize a versão do SDK do servidor. Para obter essas informações, é necessário consultar a compilação que está implantada na frota. A versão do SDK do servidor é uma propriedade de compilação.

   1. Chame describe-fleet-attributes com um ID ou ARN de frota para obter o ID e o ARN de compilação da frota.

   2. Chame describe-build com o ID ou ARN de compilação para obter a versão do SDK do servidor de compilação.

      Por exemplo:

      Solicitação

   aws gamelift describe-fleet-attributes /
     --fleet-ids  "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"

   Resposta

   {
     "FleetAttributes": [
       {
         "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
         "ComputeType": "EC2",
         "BuildId": "build-3333cccc-44dd-55ee-66ff-00001111aa22",
         . . .
       }
     ]
   }

   Solicitação

   aws gamelift describe-build /
     --build-id "build-3333cccc-44dd-55ee-66ff-00001111aa22"

   Resposta

   "Build": {
     "BuildId": "build-1111aaaa-22bb-33cc-44dd-5555eeee66ff", 
     "Name": "My_Game_Server_Build_One", 
    "OperatingSystem": "AMAZON_LINUX_2023",
   
     "ServerSdkVersion": "5.1.1",
     . . .
   }

1. Solicite credenciais de acesso para a instância. Chame get-compute-access com o ID da frota e o nome da computação da instância à qual você quer se conectar. O Amazon GameLift Servers retorna um conjunto de credenciais temporárias para acessar a instância. Por exemplo:

   Solicitação

   aws gamelift get-compute-access \
   --compute-name i-11111111a222b333c \
   --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa
   --region us-west-2

   Resposta

   {
     "ComputeName": " i-11111111a222b333c ",
     "Credentials": {
       "AccessKeyId": " ASIAIOSFODNN7EXAMPLE ",
       "SecretAccessKey": " wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY ",
       "SessionToken": " AQoDYXdzEJr...<remainder of session token>"
     },
     "FleetArn": " arn:aws:gamelift:us-west-2::fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa ",
     "FleetId": " fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa "
   }

2. Exporte as credenciais de acesso (opcional). Você pode exportar as credenciais para variáveis de ambiente e usá-las para configurar a CLI da AWS para o usuário padrão. Para obter mais detalhes, consulte Variáveis de ambiente para configurar a CLI da AWS no Guia do usuário da AWS Command Line Interface.

   export AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
   export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   export AWS_SESSION_TOKEN=AQoDYXdzEJr...<remainder of session token>

3. Conecte-se à instância da frota. Inicie uma sessão de SSM com a instância à qual você deseja se conectar. Inclua a região da AWS ou o local da instância. Para obter mais informações, incluindo como configurar o SSM e o plug-in SSM, consulte Iniciar uma sessão (CLI da AWS) no Guia do usuário do Amazon EC2 Systems Manager.

   A solicitação de início de sessão usará automaticamente as credenciais que você adquiriu na Etapa 1.

   aws ssm start-session \
   --target i-11111111a222b333c \
   --region us-west-2 \

   nota

   Se você receber um erro de acesso negado, talvez tenha uma variável de ambiente AWS_PROFILE configurada para um perfil AWS, o que faz com que a CLI da AWS use as credenciais incorretas para acesso remoto. Para resolver, cancele temporariamente a variável de ambiente AWS_PROFILE. Como alternativa, você pode criar um perfil AWS personalizado para as credenciais de acesso remoto e adicionar o parâmetro da linha de comando --profile à sua solicitação start-session.

1. Solicite credenciais de acesso para a instância. Quando tiver um ID de instância, use o comando get-instance-access para solicitar credenciais de acesso. Se bem-sucedido, o Amazon GameLift Servers retornará o sistema operacional da instância, o endereço IP e um conjunto de credenciais (nome de usuário e chave secreta). O formato de credenciais depende do sistema operacional da instância. Use as instruções a seguir para recuperar credenciais de RDP ou SSH.

   • Para instâncias do Windows – Para se conectar a uma instância do Windows, o RDP requer um nome de usuário e uma senha. A solicitação get-instance-access retorna esses valores como strings simples, de maneira que você possa usar os valores retornados como estão. Exemplo de credenciais:

     "Credentials": {
         "Secret": "aA1bBB2cCCd3EEE", 
         "UserName": "gl-user-remote"
     }

   • Para instâncias do Linux – para se conectar a uma instância do Linux, o SSH requer um nome de usuário e uma chave privada. O emite chaves privadas RSA e as retorna como uma única string, com o caractere de nova linha () indicando quebras de linha. Para tornar a chave privada utilizável, siga estas etapas: (1) converter a string em um arquivo .pem e (2) definir permissões para o novo arquivo. Exemplo de credenciais retornadas:

     "Credentials": {
         "Secret": "-----BEGIN RSA PRIVATE KEY-----nEXAMPLEKEYKCAQEAy7WZhaDsrA1W3mRlQtvhwyORRX8gnxgDAfRt/gx42kWXsT4rXE/b5CpSgie/\nvBoU7jLxx92pNHoFnByP+Dc21eyyz6CvjTmWA0JwfWiW5/akH7iO5dSrvC7dQkW2duV5QuUdE0QW\nZ/aNxMniGQE6XAgfwlnXVBwrerrQo+ZWQeqiUwwMkuEbLeJFLhMCvYURpUMSC1oehm449ilx9X1F\nG50TCFeOzfl8dqqCP6GzbPaIjiU19xX/azOR9V+tpUOzEL+wmXnZt3/nHPQ5xvD2OJH67km6SuPW\noPzev/D8V+x4+bHthfSjR9Y7DvQFjfBVwHXigBdtZcU2/wei8D/HYwIDAQABAoIBAGZ1kaEvnrqu\n/uler7vgIn5m7lN5LKw4hJLAIW6tUT/fzvtcHK0SkbQCQXuriHmQ2MQyJX/0kn2NfjLV/ufGxbL1\nmb5qwMGUnEpJaZD6QSSs3kICLwWUYUiGfc0uiSbmJoap/GTLU0W5Mfcv36PaBUNy5p53V6G7hXb2\nbahyWyJNfjLe4M86yd2YK3V2CmK+X/BOsShnJ36+hjrXPPWmV3N9zEmCdJjA+K15DYmhm/tJWSD9\n81oGk9TopEp7CkIfatEATyyZiVqoRq6k64iuM9JkA3OzdXzMQexXVJ1TLZVEH0E7bhlY9d8O1ozR\noQs/FiZNAx2iijCWyv0lpjE73+kCgYEA9mZtyhkHkFDpwrSM1APaL8oNAbbjwEy7Z5Mqfql+lIp1\nYkriL0DbLXlvRAH+yHPRit2hHOjtUNZh4Axv+cpg09qbUI3+43eEy24B7G/Uh+GTfbjsXsOxQx/x\np9otyVwc7hsQ5TA5PZb+mvkJ5OBEKzet9XcKwONBYELGhnEPe7cCgYEA06Vgov6YHleHui9kHuws\nayav0elc5zkxjF9nfHFJRry21R1trw2Vdpn+9g481URrpzWVOEihvm+xTtmaZlSp//lkq75XDwnU\nWA8gkn6O3QE3fq2yN98BURsAKdJfJ5RL1HvGQvTe10HLYYXpJnEkHv+Unl2ajLivWUt5pbBrKbUC\ngYBjbO+OZk0sCcpZ29sbzjYjpIddErySIyRX5gV2uNQwAjLdp9PfN295yQ+BxMBXiIycWVQiw0bH\noMo7yykABY7Ozd5wQewBQ4AdSlWSX4nGDtsiFxWiI5sKuAAeOCbTosy1s8w8fxoJ5Tz1sdoxNeGs\nArq6Wv/G16zQuAE9zK9vvwKBgF+09VI/1wJBirsDGz9whVWfFPrTkJNvJZzYt69qezxlsjgFKshy\nWBhd4xHZtmCqpBPlAymEjr/TOlbxyARmXMnIOWIAnNXMGB4KGSyl1mzSVAoQ+fqR+cJ3d0dyPl1j\njjb0Ed/NY8frlNDxAVHE8BSkdsx2f6ELEyBKJSRr9snRAoGAMrTwYneXzvTskF/S5Fyu0iOegLDa\nNWUH38v/nDCgEpIXD5Hn3qAEcju1IjmbwlvtW+nY2jVhv7UGd8MjwUTNGItdb6nsYqM2asrnF3qS\nVRkAKKKYeGjkpUfVTrW0YFjXkfcrR/V+QFL5OndHAKJXjW7a4ejJLncTzmZSpYzwApc=\n-----END RSA PRIVATE KEY-----", 
         "UserName": "gl-user-remote"
     }

     Ao usar a CLI da AWS, é possível gerar automaticamente um arquivo .pem, incluindo os parâmetros --query e --output à sua solicitação get-instance-access.

     Para definir permissões no arquivo .pem, execute o comando a seguir:

     $ chmod 400 MyPrivateKey.pem

2. Abra uma porta para a conexão remota. É possível acessar instâncias em frotas do Amazon GameLift Servers por meio de qualquer porta autorizada na configuração da frota. Você pode visualizar as configurações de porta da frota usando o comando describe-fleet-port-settings.

   Como melhor prática, recomendamos só abrir portas para acesso remoto quando você precisar delas e fechá-las quando terminar. Não é possível atualizar as configurações da porta depois de criar uma frota e antes que ela esteja ativa. Se ocorrer algum problema, recrie a frota com as portas configuradas como abertas.

   Use o comando update-fleet-port-settings para adicionar uma configuração de porta para a conexão remota (como 22 para SSH ou 3389 para RDP). Para o valor do intervalo de IPs, especifique os endereços IP dos dispositivos que você pretende usar para se conectar (convertidos em formato CIDR). Exemplo:

   $ AWS gamelift update-fleet-port-settings
       --fleet-id  "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa" 
       --inbound-permission-authorizations "FromPort=22,ToPort=22,IpRange=54.186.139.221/32,Protocol=TCP"

   O exemplo a seguir abre a porta 3389 em uma frota do Windows

   $ AWS gamelift update-fleet-port-settings
   --fleet-id  "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa" 
       --inbound-permission-authorizations "FromPort=3389,ToPort=3389,IpRange=54.186.139.221/32,Protocol=TCP"

3. Abra um cliente de conexão remota. Use Área de Trabalho Remota para Windows ou SSH para instâncias do Linux. Conecte-se à instância usando o endereço IP, a configuração de porta e as credenciais de acesso.

   Exemplo de SSH:

   ssh -i MyPrivateKey.pem gl-user-remote@192.0.2.0