다음을 통해 공유

연습: PowerShell/API를 사용하여 빌드 배포

  • 아티클

이 항목에서는 Windows Runner C# 샘플을 기반으로 Windows 10 개발 디바이스의 PowerShell에서 Windows OS VM용 빌드를 배포/만드는 방법을 설명합니다.

참고 항목

PlayFab 멀티 플레이어 서버를 사용 및 확인하려면 이 기능을 사용으로 설정해야 합니다. 게임 관리자 방법을 사용하여 이 기능을 사용하는 것이 좋습니다. 자세한 내용은 PlayFab 서버 기능 사용을 참조하세요.

필수 구성 요소

다음 단계를 완료했는지 확인합니다.

1. 타이틀 ID 및 개발자 비밀 키 받기

  • PlayFab 타이틀 ID 받기

    • PlayFab.com에서 개발자 계정으로 로그인합니다.
    • 게임 관리자에서 내 스튜디오 및 타이틀 페이지로 이동합니다. 게임 타이틀을 찾고 PlayFab 게임 타이틀 ID를 받습니다.

  • 타이틀의 개발자 비밀 키 받기

    • 게임 관리자에서 타이틀 > 설정(톱니바퀴 아이콘)을 선택합니다.
    • 타이틀 설정을 선택한 다음 비밀 키 탭을 선택하여 개발자 비밀 키를 받습니다.

비밀 키에 대한 자세한 내용은 비밀 키 관리를 참조하세요.

2. PlayFab 멀티 플레이어 PowerShell 모듈 설치

관리자 권한으로 Windows Powershell을 열고 다음 명령을 실행하여 PlayFabMultiplayer API 모듈을 설치합니다. 이 새 PlayFabMultiplayer API 모듈은 사용되지 않는 멀티 플레이어 PowerShell 모듈을 대체합니다.

이전에 PlayFab 멀티 플레이어 PowerShell 모듈을 설치한 경우, 다음 명령을 사용하여 제거합니다. 새 모듈로 전환하려면 매핑 명령을 참조하여 새 해당 명령을 찾으세요.

Uninstall-Package PlayFabMultiplayer

이 새 모듈에서는 명령과 인수가 모두 다릅니다. 각 명령에 대한 자세한 설명서는Cmdlet 설명서를 참조하세요.

Install-Module -Name PlayFabMultiplayerApi

팁

모듈을 설치하기 전에 먼저 Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser을(를) 사용하여 실행 정책을 설정해야 할 수 있습니다. 자세한 내용은 PowerShell 실행 정책을 참조하세요.

3. 타이틀용 EntityToken 얻기

PowerShell 창에서 타이틀 ID와 연결된 개발자 키를 사용하여 다음 명령을 실행합니다.

Set-PfTitle -TitleID "mytitleID" -SecretKey "mysecretkey"

4. 자산 업로드

Windows 서버를 배포할 때 관리형 Windows 컨테이너를 사용합니다. PlayFab 멀티 플레이어 게임 서버 빌드를 자산으로 업로드하면 됩니다.

FilePath 플래그의 값을 winrunnerSample.zip 로컬 파일 위치로 업데이트합니다. 이 파일의 위치를 모르는 경우 여기 지침에 따라 파일을 가져옵니다.

New-PfAsset -FilePath C:\windowsRunnerCSharp.zip -AssetName windowsRunnerCSharp.zip

5. 빌드 만들기

이제 자산을 업로드했으므로 빌드를 만들 수 있습니다. 다음 명령을 실행합니다.

아래 코드에서는 EastUS 지역의 Standard_D2as_v4 VM을 사용합니다. 사용하려는 VM 및 지역에 따라 문자열을 바꿉니다.

$vmSize = "Standard_D2as_v4"

$regions = @( @{ StandbyServers = 1; MaxServers = 1; Region = 'EastUS'; ScheduledStandbySettings = $NULL } )

$ports = @( @{ Name = 'game_port'; Num = 3600; Protocol = 'TCP' } )

$gameAssets = @( @{ FileName = 'windowsRunnerCSharp.zip'; MountPath = 'C:\Assets' } )

$buildResponse = New-PfBuild -BuildName PSTest_build -ContainerFlavor ManagedWindowsServerCore -StartMultiplayerServerCommand 'C:\Assets\WindowsRunnerCSharp.exe' -GameAssetReferences $gameAssets -VMSize $vmSize -MultiplayerServerCountPerVM 1 -Ports $ports -RegionConfigurations $regions

# All PlayFabMultiplayerApi cmdlets return objects, so we can pass the returned object to ConvertTo-Json for human readability.
$buildResponse | ConvertTo-Json -depth 5

빌드가 성공적인지 확인

몇 초 후에 PowerShell 또는 ListBuildSummaries API를 통해 만든 빌드가 표시됩니다.

다음 명령을 실행하여 빌드가 배포되었는지 확인할 수도 있습니다.

Get-PfBuild | ConvertTo-Json -depth 5

참고 항목