Skip to main content
빌드 별칭(build alias)은 빌드 위에 있는 관리 계층으로, RequestMultiplayerServer 호출을 제어된 방식으로 여러 빌드에 걸쳐 분산시킬 수 있게 해줍니다. 이는 빌드 간 업그레이드 및 아래에 나열된 여러 시나리오의 단순성과 신뢰성을 개선할 수 있습니다. 별칭은 각 빌드 ID의 가중치와 함께 빌드 ID 목록을 지정하여 이를 달성합니다. 가중치는 해당 빌드로 전달되어야 하는 할당 호출의 비율을 나타냅니다.

하위 호환성이 있는 안전한 배포

이는 게임 서버를 업데이트하고 있고 소매 클라이언트가 두 서버 모두와 호환되는 빌드 간 업그레이드에 대한 가장 일반적인 시나리오입니다. 클라이언트는 별칭 1을 참조하며, 다음과 같은 구성을 갖습니다:
  • Build 1: Weight = 1
Build 2가 생성되면 별칭 1은 다음과 같이 변경됩니다:
  • Build 1: Weight = 8
  • Build 2: Weight = 2
모든 새 서버 요청이 Build 2에 의해 처리될 때까지 가중치를 점진적으로 변경할 수 있습니다. 이 시점에서 Build 1의 가중치는 0이고 별칭에서 제거될 수 있습니다. 별칭의 일반적인 사용 사례는 클라이언트 호환성 버전 및 게임 모드에 별칭을 연동하는 것입니다. 예를 들면 “DeathMatch client 2.2 RETAIL”입니다. 별칭을 사용하면 이 경험을 지원하는 빌드를 지속적으로 업데이트하면서 이 상위 수준 추상화를 관리할 수 있습니다. 별칭은 또한 필요한 경우 빌드를 롤백하기 쉽게 만듭니다.

하위 호환되지 않는 배포

이 경우 현재 게임 클라이언트가 이전 서버 빌드와 호환되지 않기 때문에 게임 클라이언트를 업데이트하는 동시에 게임 서버를 업데이트하려고 합니다. 하나의 빌드에서 다른 빌드로의 전환은 다음과 같이 수행됩니다: 이전 클라이언트는 별칭 1을 참조하며, 다음과 같습니다:
  • Build 1: Weight = 1
Build 2가 생성되면 새 클라이언트는 별칭 2를 참조하며, 다음과 같습니다:
  • Build 2: Weight = 1
이 시나리오에서 별칭은 빌드와 유사하게 사용되며, 다중화 기능은 사용되지 않습니다.

하위 호환성이 있는 블라스트 배포

이는 하위 호환성이 있는 빌드 간 업그레이드 시나리오와 유사하지만 수요 동작에서 더 갑작스러운 전환이 있습니다. 하나의 빌드에서 다른 빌드로의 전환은 다음과 같이 수행됩니다: 클라이언트는 별칭 1을 참조하며, 다음과 같습니다:
  • Build 1: Weight = 1
Build 2가 생성되면 별칭 1은 다음과 같이 변경됩니다:
  • Build 1: Weight = 0
  • Build 2: Weight = 1

하위 호환성이 있는 배포 테스트

게임 서버를 업데이트하고 싶고 클라이언트 버전이 두 서버 모두와 호환되지만, 모든 플레이어에게 대규모로 배포하기 전에 두 번째 버전을 테스트하고 싶은 경우입니다. 하나의 빌드에서 다른 빌드로 테스트하고 전환하는 방법은 다음과 같습니다: 클라이언트는 별칭 1을 참조하며, 다음과 같습니다:
  • Build 1: Weight = 1
Build 2가 생성되면. 테스트 클라이언트는 별칭 2를 참조하며, 다음과 같습니다:
  • Build 2: Weight = 1
Build 2가 검증되면. 별칭 1은 다음과 같이 변경됩니다:
  • Build 1: Weight = 8
  • Build 2: Weight = 2
점진적으로 Build 2에 더 많은 가중치가 부여되고 모든 트래픽을 흡수합니다.

다른 빌드 및 지역으로의 대체

별칭은 여러 빌드에 걸친 대체를 허용함으로써 멀티플레이어 서버 배포를 더 탄력적으로 만들 수 있습니다. 예를 들어, 빌드 별칭을 대상으로 하는 할당 요청이 EastUS를 지역 #1로, West US를 지역 #2로 순위를 매긴다고 가정해 보겠습니다. 이 빌드 별칭은 Build 1과 Build 2 두 빌드에 유사한 가중치를 제공합니다. 특정 할당에 대해 Build 1이 선택된다고 가정합니다.
  1. East US의 Build 1에 대한 할당이 시도됩니다.
  2. #1이 실패하면 East US의 Build 2에 대한 할당이 시도됩니다.
  3. #2가 실패하면 WestUS의 Build 1에 대한 할당이 시도됩니다.
  4. #3이 실패하면 WestUs의 Build 2에 대한 할당이 시도됩니다.
특히 한 빌드에서 다른 빌드로 점진적으로 업그레이드할 때, 이 대체 동작은 빌드 중 하나에 문제가 있어도 플레이어가 가장 낮은 지연 시간의 서버를 얻을 수 있도록 최적화되어 있습니다.

PlayFab REST API로 빌드 별칭 관리

이제 Game Manager에서 빌드 별칭을 관리할 수 있습니다. 시작하려면 빌드 개요 페이지를 참조하세요.
  1. API를 사용하여 빌드 별칭을 만듭니다. API:
    샘플 본문:
    샘플 응답:
    Build Alias Id는 응답의 일부로 제공됩니다.
  2. 빌드 별칭의 매개 변수를 업데이트합니다. API:
    샘플 본문:
    샘플 응답:
  3. 빌드 별칭을 삭제합니다. API:
    샘플 본문:
  4. 빌드 별칭을 나열합니다. API:
    샘플 응답:

빌드 별칭을 사용하여 할당

빌드 별칭을 사용하여 할당하려면 RequestMultiplayerServer 호출에서 빌드 별칭 ID를 지정하기만 하면 됩니다. API:
샘플 본문:
마지막 수정일 2026년 8월 25일