Product, Sandbox, and Deployment IDs

개발자 포털의 제품 관리 툴에 대한 개요입니다.

6 분 소요

제품은 에픽 온라인 서비스(Epic Online Services, EOS) 내의 디플로이와 샌드박스를 포함하는 게임이나 기타 소프트웨어 프로젝트를 말합니다. EOS에 여러 제품을 등록할 수 있으며, 각 제품은 별도의 샌드박스 세트를 유지합니다. 제품을 생성할 때마다 라이브 환경에 새로운 공개 샌드박스가 자동으로 할당됩니다.

예시:

  • 조직 - 에픽게임즈
    • 제품 - 재즈 잭래빗
      • 샌드박스 - Development
        • 디플로이 - DevGame01
      • 샌드박스 - Staging
        • 디플로이 - QATestGame01
        • 디플로이 - AlphaGame
        • 디플로이 - BetaGame
      • 샌드박스 - Live
        • 디플로이 - LiveGame

개발자 포털 사이드 패널의 내 제품(Your Product) 에서 제품을 생성하고 각 제품을 관리할 수 있습니다. 선택한 제품의 사이드 패널에서 제품 세팅(Product Settings) 을 찾을 수 있습니다. 제품마다 별도의 제품 세팅 세트가 있습니다.

디폴트 탭은 제품에 대한 일반 정보를 제공합니다.

세팅설명
제품 ID(Product ID)프로젝트 생성 시 할당되는 고유 식별자입니다. 한 번 할당되면 변경할 수 없습니다.
제품 이름(Product Name)제품의 표시명입니다. 필드에 새 이름을 입력한 후 이름 변경(Change Name) 을 클릭하면 변경할 수 있습니다. 그러면 제품 슬러그가 자동으로 업데이트됩니다.
제품 슬러그(Product Slug)제품 ID에 추가되어 제품을 빠르게 식별할 수 있도록 도와주는 짧은 이름입니다. 제품 이름을 바꿀 때 자동으로 업데이트됩니다.
제품 표지 이미지(Product Cover Image)제품 페이지에 표시되는 표지 이미지입니다. 새 이미지를 업로드하고 이미지 저장(Save Image) 버튼을 클릭하면 변경됩니다.
SDK 크리덴셜(SDK Credentials)제품의 전체 SDK 크리덴셜입니다. 이 정보를 조직 외부에 공유해서는 안 됩니다.

환경(샌드박스 및 디플로이)

환경은 제품의 샌드박스와 디플로이를 포함합니다. 개발자 포털(Developer Portal) 에서 제품 세팅(Product Settings) > 환경(Environments) 을 선택하면 제품의 샌드박스와 디플로이를 확인 및 관리할 수 있습니다.

예시:

  • 조직 - 에픽게임즈
    • 제품 - 재즈 잭래빗
      • 샌드박스 - 개발
        • 디플로이 - DevGame01
      • 샌드박스 - Staging
        • 디플로이 - QATestGame01
        • 디플로이 - AlphaGame
        • 디플로이 - BetaGame
      • 샌드박스 - Live
        • 디플로이 - LiveGame

샌드박스

샌드박스는 제품의 하이레벨 배포 환경을 나타내며, 스토어 관련 정보, 모드 환경설정, 제품의 특정 디플로이에 대한 진입점이 포함되어 있습니다. 각 샌드박스의 디플로이ID 제공자를 구성할 수 있습니다.

새 EOS 제품은 기본적으로 Live 라는 하나의 사전 정의된 공개 샌드박스를 포함합니다.

에픽게임즈 스토어와 통합되는 EOS 제품에는 3개의 사전 정의된 샌드박스 Live , Stage , Dev 가 포함됩니다. Live 는 공개인 반면 StageDev 는 비공개입니다.

에픽게임즈 스토어 파트너의 경우 플레이어 그룹을 사용하여 외부 사용자 ID에도 비공개 샌드박스 및 디플로이에 대한 액세스 권한을 부여할 수 있습니다.

디플로이

디플로이는 제품의 특정 배포를 나타내며 진행 상황, 업적, 통계, 매치메이킹, 기타 게임플레이 관련 사용자 정보를 저장합니다. 샌드박스의 디플로이(Deployments) 를 클릭하면 디플로이를 구성할 수 있습니다. 각 디플로이는 하나의 샌드박스에만 어태치될 수 있습니다. 서로 다른 두 샌드박스에 유사한 디플로이를 구성하려면 샌드박스마다 따로 디플로이를 생성해야 합니다.

디플로이(Deployments) 모달 슬라이드에서 특정 샌드박스의 디플로이를 생성, 편집, 아카이브할 수 있습니다.

생성한 각 디플로이에는 자동으로 고유 식별자가 할당됩니다. 이 디플로이 IDSDK 초기화에 필요하며, 해당 디플로이의 제품 세션 데이터에 액세스하도록 구성됩니다. 샌드박스 수준에 저장된 정보 또한 디플로이 ID로 얻을 수 있습니다.

디플로이의 사용 사례

디플로이는 개발, 테스트, 배포 프로세스에 또 다른 수준의 조직 및 분리를 제공할 수 있습니다. 다음 예시로 다양한 디플로이 사용 사례를 알아보세요.

단일 브랜치 디플로이
  • 개발, 테스트, 배포를 위해 Live 라는 단일 디플로이를 생성합니다.

    • Live 에 모든 개발 및 테스트 데이터가 남습니다.
  • (삭제 후) 2개의 디플로이 DevLive 를 생성합니다. Dev 디플로이에서 개발과 테스트를 진행하지만, Live 만 배포합니다.

    • Dev 에 모든 개발 및 테스트 데이터가 남지만, Live 에는 남지 않습니다.
단일 브랜치 베타 테스트 디플로이
  • 2개의 디플로이 DevLive 를 생성합니다. Dev 디플로이에서 개발과 내부 테스트를 진행하고, Live 디플로이에서 베타 테스트를 진행합니다. 그런 다음 Live 디플로이를 사용하여 게임을 배포합니다.

    • Dev 에 모든 개발 및 내부 테스트 데이터가 유지되지만, 베타나 Live 에는 남지 않습니다.
    • 모든 베타 테스트 데이터가 Live 에 남습니다.
  • (삭제 후) 3개의 디플로이 Dev , Beta , Live 를 생성합니다. Dev 디플로이에서 개발과 내부 테스트를 진행하고, Beta 디플로이에서 베타 테스트를 진행합니다. 그런 다음 Live 디플로이를 사용하여 게임을 배포합니다.

    • Dev 에 모든 개발 및 내부 테스트 데이터가 유지되지만, BetaLive 에는 남지 않습니다.
    • Beta 의 모든 데이터가 유지되지만, Live 에는 남지 않습니다.
별도의 개발 브랜치

예시:

  • Dev-Main
  • Dev-Release
  • Dev-Experimental
  • Dev-CoolFeature1
  • Dev-CoolFeature2
CI/CD 파이프라인

예시:

  • Dev-Latest
  • Dev-Stable
  • Dev-Staging
  • Live
별도의 개발 요구 사항

예시:

  • Dev-LongTermStableBuildForExternalPartner
  • Dev-MainBranchPlaytest
  • Dev-ReleaseBranchPlaytest

플레이어 그룹

플레이어 그룹(Player Groups) 에서는 비공개 샌드박스디플로이에 대한 외부 사용자의 액세스를 관리할 수 있습니다. 기본적으로 외부 사용자는 비공개 샌드박스와 디플로이에 액세스할 수 없으며, 플레이어 그룹으로 권한을 받아야 액세스할 수 있습니다. 예를 들어 QA 팀의 계정 ID를 그룹에 추가하면 QA 팀은 제품의 자체 비공개 버전을 테스트할 수 있습니다.

참고: 관련 제품에 액세스 권한이 있는 조직 사용자에게는 비공개 샌드박스나 디플로이에 대한 액세스 권한이 자동으로 부여됩니다.

개발자 포털(Developer Portal) 에서 제품 세팅(Product Settings) 대시보드의 플레이어 그룹(Player Groups) 탭을 선택하면 비공개 샌드박스와 디플로이에 대한 외부 사용자 액세스를 확인하고 관리할 수 있습니다.

새 플레이어 그룹 생성하기

새 플레이어 그룹을 생성하려면 새 그룹 생성(Create New Group) 을 클릭합니다. 생성하는 그룹마다 액세스를 허용할 외부 계정 ID 목록을 추가해야 합니다. 계정 ID는 지원되는 어느 ID 제공자에 속하든 무관합니다.

계정 ID 목록을 CSV 파일에서 임포트할 수도 있습니다. 여러 제공자에 속한 많은 ID를 입력해야 한다면 이 방법이 더 효율적일 수 있습니다.

많은 ID를 원활하게 임포트하기 위해 '목록 임포트(Import list)' 탭에서 올바른 파일 형식의 템플릿을 다운로드할 수도 있습니다. 다음은 플레이어 ID의 임포트 목록 예시입니다.

"identityProviderId","accountId","environment"
"apple","abcdef.0123456789abcdef0123456789abcdef.0123"
"discord","123456789012345678"
"epicgames","abcdef0123456789abcdef0123456789"
"gog","12345678901234567"
"google","123456789012345678901"
"itchio","1234567"
"nintendo_nsa_id","abcdef0123456789","<nintendo_env>"
"oculus","1234567890123456"
"openid","<determined_by_dev>"
"psn","1234567890123456789","<playstation_env>"
"steam","12345678901234567"
"xbl","1234567890123456"

플레이어 그룹을 적절한 ID에 할당한 후에는 그룹이 액세스할 수 있는 샌드박스와 디플로이를 선택합니다. 플레이어 그룹을 생성한 후에는 해당 그룹의 모든 외부 사용자가 선택된 비공개 샌드박스와 디플로이에 액세스할 수 있습니다.

플레이어 그룹(Player Groups) 탭에서 추가 옵션(More Options) 을 선택하여 언제든지 플레이어 그룹을 편집할 수 있습니다.