Amazon 생성 GameLift Anywhere 플릿 - Amazon GameLift

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon 생성 GameLift Anywhere 플릿

이 주제에서는 Amazon을 생성하는 방법을 설명합니다. GameLift Anywhere 플릿. Anywhere 플릿을 사용하면 핵심 Amazon GameLift 게임 세션 관리 기능을 사용하는 동시에 자체 컴퓨팅 리소스로 게임 세션을 호스팅할 수 있습니다. 온프레미스 하드웨어 또는 기타 클라우드 기반 리소스를 위한 Anywhere 플릿을 생성합니다.

모든 플릿은 하이브리드 호스팅 솔루션에서 Amazon GameLift 관리형 플릿과 함께 일반적으로 사용됩니다. 또한 Amazon 에서 호스팅하기 위한 게임을 개발할 때 유용한 테스트 환경을 제공합니다 GameLift. Amazon을 통합하는 시기와 방법에 대해 자세히 알아보려면 다음 주제를 참조하세요. GameLift Anywhere 를 게임 호스팅 솔루션으로 플릿:

Anywhere 플릿은 자체 관리형이므로 플릿을 설정하려면 몇 가지 추가 작업이 필요합니다. Anywhere 플릿이 게임 세션과 플레이어를 호스팅할 수 있도록 준비하려면 다음 작업을 완료해야 합니다.

시작하기 전에

Anywhere 플릿을 생성하기 전에 다음 작업을 수행합니다. 자세한 지침은 Amazon GameLift Anywhere를 통한 호스팅을 위한 개발 로드맵 또는 섹션을 참조하세요Amazon과의 하이브리드 호스팅을 위한 개발 로드맵 GameLift.

  • 게임 서버 코드를 Amazon GameLift 서버 SDK 버전 5.x(또는 그 이상)와 통합합니다. 모든 게임 통합 작업을 완료할 필요는 없으며 게임 서버 빌드에 필요한 작업만 완료할 필요는 없습니다. 일반적인 방법은 로컬 머신을 Anywhere 플릿으로 설정하고 명령줄 인터페이스를 사용하여 게임 서버 통합을 테스트하는 것입니다( 참조Amazon을 사용하여 로컬 테스트 설정 GameLift Anywhere). 추가 구성 요소(예: Amazon GameLift 지원 게임 클라이언트)를 개발 시 통합할 수 있습니다.

  • Anywhere 플릿 컴퓨팅에 설치할 게임 서버 소프트웨어를 패키징합니다. 패키지에는 통합 게임 서버 빌드와 게임 서버를 실행하는 데 필요한 모든 지원 소프트웨어가 포함되어야 합니다.

  • Amazon GameLift Agent를 Anywhere 플릿과 함께 사용할지 여부를 결정합니다. 에이전트는 Amazon 에서 사용할 서버 프로세스 및 컴퓨팅 관리와 관련된 일부 주요 작업을 자동화하는 온컴퓨트 프로세스 관리 도구입니다 GameLift. 자세한 내용은 Amazon GameLift Agent 작업 단원을 참조하십시오.

사용자 지정 위치 생성

사용자 지정 위치를 생성하여 컴퓨팅 리소스의 물리적 위치를 나타냅니다. Anywhere 플릿을 생성할 때는 사용자 지정 위치가 하나 이상 이미 정의되어 있어야 합니다. 언제든지 추가 사용자 지정 위치를 생성하고 기존 플릿에 추가할 수 있습니다.

사용자 지정 위치를 생성하려면

Amazon GameLift 콘솔 또는 AWS Command Line Interface (AWS CLI)를 사용하여 사용자 지정 위치를 생성합니다.

Console

Amazon GameLift 콘솔 에서 탐색 창을 사용하여 위치 페이지를 엽니다. 위치 생성을 선택하여 생성 대화 상자를 엽니다.

  1. 대화 상자에 위치 이름 을 입력합니다. 모범 사례로 컴퓨팅 리소스 세트의 의미 있는 위치를 설명하는 이름을 사용합니다. 지리적 위치, 데이터 센터 이름 또는 기타 위치 식별자일 수 있습니다. Amazon은 사용자 지정 위치의 이름을 custom-와 함께 GameLift 추가합니다.

  2. (선택 사항) 사용자 지정 위치에 태그를 추가합니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 목적, 소유자 또는 환경별로 분류하려는 AWS 리소스에 태그를 할당합니다. 추가하려는 각 추가 태그에 대해 새 태그 추가를 선택합니다.

  3. 생성(Create)을 선택합니다.

AWS CLI

create-location 명령을 사용하여 사용자 지정 위치를 생성합니다. 로 시작해야 하는 location-name 값을 제공합니다custom-. 모범 사례로 컴퓨팅 리소스 세트의 의미 있는 위치를 설명하는 이름을 사용합니다. 지리적 위치, 데이터 센터 이름 또는 기타 위치 식별자일 수 있습니다.

aws gamelift create-location \ --location-name custom-location-1

출력

{ "Location": { "LocationName": "custom-location-1", "LocationArn": "arn:aws:gamelift:us-east-1:111122223333:location/custom-location-1" } }

Anywhere 플릿 생성

소유한 컴퓨팅 리소스 집합에 대한 Anywhere 플릿을 생성합니다. 새 Anywhere 플릿이 비어 있기 시작합니다. 플릿을 등록하여 플릿에 컴퓨팅을 추가합니다.

생성 시 새로운 Anywhere 플릿은 에서 NEW로 플릿 상태를 빠르게 이동합니다ACTIVE. 플릿이 에 도달한 후 플릿에 컴퓨팅을 추가할 수 있습니다ACTIVE.

Anywhere 플릿을 생성하려면

Amazon GameLift 콘솔 또는 AWS Command Line Interface (AWS CLI)를 사용하여 Anywhere 플릿을 생성합니다.

Console

Amazon GameLift 콘솔 에서 탐색 창을 사용하여 플릿 페이지를 엽니다. 플릿 생성을 선택하여 플릿 생성 워크플로를 시작합니다.

1단계 컴퓨팅 유형 선택

Anywhere 옵션을 선택하고 Next를 선택합니다.

2단계 플릿 세부 정보 정의

이 단계에서는 몇 가지 키 플릿 전체 설정을 지정합니다.

  1. 플릿 세부 정보 섹션을 작성합니다.

    1. 플릿 이름 을 입력합니다. 플릿 목록을 볼 때 플릿 유형을 더 쉽게 식별할 수 있도록 플릿 이름 지정 패턴을 사용하는 것이 좋습니다.

    2. 플릿에 대한 간단한 설명을 제공합니다.

  2. 필요에 따라 이러한 선택적 추가 세부 정보를 설정합니다. 나중에 이러한 플릿 설정을 업데이트할 수 있습니다.

    1. 프로덕션 또는 사전 프로덕션 테스트를 위해 플릿을 생성할 때 이 설정을 사용하여 플릿의 컴퓨팅에 대한 시간당 비용 값을 지정합니다. Amazon은 게임 세션 배치 프로세스 중에 이 정보를 사용하여 비용에 따라 호스팅 리소스를 선택할 GameLift 수 있습니다.

    2. 이 플릿 및 기타 플릿의 지표 데이터를 결합하려면 지표 그룹 이름을 지정합니다. 함께 결합하려는 모든 플릿에 동일한 지표 그룹 이름을 사용합니다. 지표 그룹의 지표를 보고 집계된 데이터를 확인합니다.

  3. 사용자 지정 위치에 선택적 태그를 추가합니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 목적, 소유자 또는 환경별로 분류하려는 AWS 리소스에 태그를 할당합니다. 추가하려는 각 추가 태그에 대해 새 태그 추가를 선택합니다.

  4. 워크플로를 계속하려면 다음을 선택합니다.

3단계 사용자 지정 위치 선택

이 단계에서는 이 플릿에 추가할 컴퓨팅의 물리적 위치를 식별합니다. 지금 하나 이상의 위치를 지정하고 필요에 따라 나중에 위치를 추가하거나 제거할 수 있습니다.

  1. 사용자 지정 위치 에서 플릿의 컴퓨팅에 대해 하나 이상의 위치를 선택합니다. 목록에는 현재 선택한 에 정의된 모든 사용자 지정 위치가 포함됩니다 AWS 리전. 플릿에 추가할 새 사용자 지정 위치를 정의하려면 위치 생성을 선택합니다.

  2. 워크플로를 계속하려면 다음을 선택합니다.

4단계 검토 및 생성

플릿을 생성하기 전에 설정을 검토합니다.

새 플릿을 배포할 준비가 되면 생성을 선택합니다. Amazon은 GameLift 즉시 플릿 활성화 프로세스를 시작하여 고유한 ID를 할당하고 플릿을 NEW 상태로 전환합니다. 플릿 페이지에서 플릿의 진행 상황을 추적할 수 있습니다.

AWS CLI

create-fleet 명령을 사용하여 컴퓨팅 유형의 플릿을 생성합니다ANYWHERE. 이름과 하나 이상의 사용자 지정 위치를 제공합니다. Amazon은 현재 기본값에 Anywhere 플릿 리소스를 GameLift 생성합니다 AWS 리전 (또는 -- 리전 태그를 추가하여 다른 를 지정할 수 있습니다 AWS 리전).

다음 예제 요청은 최소 필수 설정으로 새 플릿을 생성합니다. FleetNamecustom-location를 사용자 정보로 바꿉니다.

aws gamelift create-fleet \ --name FleetName \ --compute-type ANYWHERE \ --locations "Location=custom-location"

응답의 예

{ "FleetAttributes": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "Name": "HardwareAnywhere", "CreationTime": "2023-02-23T17:57:42.293000+00:00", "Status": "ACTIVE", "MetricGroups": [ "default" ], "CertificateConfiguration": { "CertificateType": "DISABLED" }, "ComputeType": "ANYWHERE" } }

생성 시 새로운 Anywhere 플릿은 플릿 상태로 빠르게 이동합니다ACTIVE. 플릿이 에 도달한 후 플릿에 컴퓨팅을 추가할 수 있습니다ACTIVE.

응답에는 플릿 위치가 포함되지 않습니다. describe-fleet-attributes 및 를 호출하여 전체 플릿 세부 정보를 검색할 수 있습니다describe-fleet-location-attributes.

플릿에 컴퓨팅 추가

플릿에 컴퓨팅 리소스를 추가하고 게임 세션을 호스팅할 준비를 하려면 다음 작업을 수행합니다.

  • 플릿에 컴퓨팅을 등록합니다. 등록은 Amazon에 GameLift 플릿의 일부인 물리적 호스팅 리소스를 알려줍니다.

  • 컴퓨팅에 대한 인증 토큰을 요청합니다. 컴퓨팅에서 실행되는 각 게임 서버는 Amazon GameLift 서비스에 연결하기 위해 이 토큰이 필요합니다. 인증 토큰은 일시적이므로 정기적으로 새로 고쳐야 합니다.

참고

Amazon GameLift Agent로 게임 서버 소프트웨어를 배포하는 경우 이 단계를 건너뛸 수 있습니다. 에이전트는 각 컴퓨팅을 자동으로 등록하고 컴퓨팅에 유효한 인증 토큰을 유지합니다. Amazon GameLift Agent 작업을 참조하세요.

를 사용하거나 Amazon용 에 AWS CLI 프로그래밍 방식으로 호출하여 컴퓨팅을 등록하고 인증 토큰을 AWS SDK 요청할 수 있습니다 GameLift. Amazon GameLift 콘솔에서는 이러한 작업을 사용할 수 없습니다.

모범 사례로 각 컴퓨팅에 시작 스크립트를 추가하여 이러한 두 작업을 모두 자동화하는 것이 좋습니다. 시작 스크립트는 register-computeget-compute-auth-token 명령을 모두 자동으로 호출합니다. 또한 작업을 자동화하여 컴퓨팅 수명 기간 동안 인증 토큰을 정기적으로 새로 고치고 종료 시 컴퓨팅 등록을 취소할 수 있습니다.

각 시작 작업은 컴퓨팅에 저장해야 하는 컴퓨팅별 값을 반환합니다. 컴퓨팅에서 게임 서버 프로세스가 시작되면 Amazon GameLift 서비스와의 연결을 초기화할 때 이러한 값을 서버 파라미터로 전달해야 합니다(서버 SDK 참조ServerParameters의 참조). 이러한 컴퓨팅별 값(또는 저장된 위치)을 환경 변수로 설정하는 것이 좋습니다. Amazon GameLift Agent를 사용하는 경우 이 작업이 처리됩니다. 컴퓨팅별 값은 다음과 같습니다.

  • register-compute 는 에 대한 값을 반환합니다GameLiftServiceSdkEndpoint. 이 값을 webSocketUrl 서버 파라미터로 설정합니다.

  • compute-auth-token 는 인증 토큰을 반환합니다. 이 값을 authToken 서버 파라미터로 설정합니다.

AWS CLI

다음 지침은 를 사용하여 각 요청을 수동으로 제출하는 방법을 설명합니다 AWS CLI.

컴퓨팅을 등록하려면

를 호출register-compute하여 컴퓨팅을 등록합니다. 컴퓨팅을 추가할 플릿의 ID를 식별합니다. 의미 있는 이름, IP 주소, 위치 등의 컴퓨팅 정보를 제공합니다. 컴퓨팅의 위치는 플릿과 이미 연결된 사용자 지정 위치여야 합니다. 다른 사용자 지정 위치를 사용하려면 Amazon GameLift 콘솔을 사용하여 플릿을 업데이트하거나 명령을 호출 AWS CLIcreate-fleet-locations하여 플릿에 사용자 지정 위치를 추가합니다.

다음 예에서는 컴퓨팅 및 플릿의 자리 표시자 값을 바꿉니다. Anywhere 플릿을 생성하면 fleet-id 값이 반환됩니다. describe-fleet-attributes 및 를 호출하여 전체 플릿 세부 정보를 검색할 수 있습니다describe-fleet-location-attributes.

aws gamelift register-compute \ --compute-name HardwareAnywhere \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --ip-address 10.1.2.3 \ --location custom-location-1

출력 예시

{ "Compute": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-west-2:111122223333:compute/HardwareAnywhere", "IpAddress": "10.1.2.3", "ComputeStatus": "Active", "Location": "custom-location-1", "CreationTime": "2023-02-23T18:09:26.727000+00:00", "GameLiftServiceSdkEndpoint": "wss://us-west-2.api.amazongamelift.com" } }

인증 토큰을 요청하려면

를 호출get-compute-auth-token하여 유효한 인증 토큰을 요청합니다. 컴퓨팅을 등록합니다. 플릿 ID와 컴퓨팅 이름을 식별합니다.

다음 예에서는 컴퓨팅 및 플릿의 자리 표시자 값을 바꿉니다. Anywhere 플릿을 생성하면 fleet-id 값이 반환됩니다. 를 호출하여 전체 플릿 세부 정보를 검색할 수 있습니다describe-fleet-attributes. 컴퓨팅 정보를 찾으려면 플릿 IDlist-compute로 를 호출하여 플릿에 등록된 모든 컴퓨팅을 확인합니다.

aws gamelift get-compute-auth-token \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --compute-name HardwareAnywhere

출력 예시

{ "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-east-1:111122223333:compute/HardwareAnywhere", "AuthToken": "0c728041-3e84-4aaa-b927-a0fb202684c0", "ExpirationTimestamp": "2023-02-23T18:47:54+00:00" }

게임 서버 시작

Anywhere 플릿을 생성하고 플릿에 하나 이상의 컴퓨팅을 추가하면 게임 서버 실행을 시작할 준비가 된 것입니다.

1단계 게임 서버 소프트웨어 설치

게임 서버 빌드와 모든 종속 소프트웨어를 Anywhere 플릿의 각 컴퓨팅에 설치합니다. 게임 서버 빌드는 Amazon GameLift 서버 SDK 버전 5.x(또는 그 이상)와 Amazon GameLift 서비스와 통신하는 데 필요한 최소 기능과 통합되어야 합니다.

2단계 컴퓨팅에서 게임 서버를 실행할 수 있도록 준비

각 컴퓨팅이 등록되어 있고 유효한 인증 토큰이 있는지 확인합니다. 스크립트를 사용하여 이러한 작업을 관리하는 경우 게임 서버 프로세스를 시작하기 전에 각 컴퓨팅에서 스크립트가 실행되는지 확인하세요.

Amazon GameLift Agent를 게임 서버 소프트웨어와 함께 배포한 경우 에이전트 실행 파일이 시작되는지 확인합니다.

3단계 게임 서버 프로세스 시작

컴퓨팅에서 게임 서버 실행 파일의 인스턴스를 실행합니다. 게임 서버 빌드가 제대로 통합되면 게임 서버 프로세스는 유효한 서버 파라미터 세트를 InitSDK() 사용하여 서버 SDK 작업을 호출합니다. 서버 프로세스가 게임 세션을 호스팅할 준비가 되면 를 호출합니다ProcessReady().

참고

Amazon GameLift Agent와 함께 게임 서버 소프트웨어를 배포한 경우 이 단계를 건너뛸 수 있습니다. 에이전트는 사용자가 제공한 런타임 지침에 따라 게임 서버 프로세스를 자동으로 시작합니다.

활성화 및 활성 서버 프로세스에 대한 서버 프로세스 지표를 확인하여 진행 상황을 모니터링할 수 있습니다. Amazon GameLift 플릿 지표을 참조하세요. 게임 서버 프로세스가 초기화되지 않는 경우 프로세스가 실행 중인 컴퓨팅에 적합한 서버 파라미터 값을 검색하고 있는지 확인합니다.