> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CloudScript 빠른 시작

> Game Manager에서 PlayFab CloudScript JavaScript 파일을 업로드, 수정 및 호출한 다음, Unity 게임 클라이언트나 PlayStream 액션에서 호출합니다.

CloudScript는 전용 서버에 대한 빠르고 안전하며 확장 가능한 대안을 제공합니다. 사용자 지정 JavaScript는 PlayFab 머신에 직접 존재하며 실행됩니다.

<Note>
  [Azure Functions를 사용하는 CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart)는 더 많은 언어를 지원하며 개선된 디버깅 워크플로를 제공합니다.
</Note>

여기에서 코드는 게임 클라이언트에 의해 *직접* 호출되거나 PlayStream 액션을 통해 간접적으로 호출될 수 있습니다. 또한 CloudScript 메서드는 PlayFab의 [Server](/services/playfab/api-references) API 세트에 완전히 액세스할 수 있습니다.

이 빠른 시작에서는 PlayFab Game Manager에서 CloudScript 파일을 업로드하고 관리하는 방법에 대해 설명합니다.

<Note>
  [사용자 지정 CloudScript 작성](/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript) 자습서는 CloudScript 코드 자체를 작성하는 방법에 대해 다룹니다.
</Note>

이 문서를 읽을 때 다음 사항에 유의하세요.

* PlayFab의 기본 사항에 익숙해야 합니다.
* 표시된 **C#** 샘플은 PlayFab Unity SDK 사용에 해당합니다.
* JavaScript 샘플은 PlayFab CloudScript 서비스 사용에 해당합니다.

## 첫 번째 CloudScript 리비전

타이틀을 만든 후, PlayFab은 자동으로 예제 스크립트를 첫 번째 리비전으로 포함합니다. 이 리비전에는 CloudScript 학습 및 테스트에 사용할 수 있는 여러 메서드가 포함됩니다.

이러한 함수를 보려면:

* [Game Manager](https://developer.playfab.com/)를 엽니다.
* 타이틀을 선택합니다.
* 왼쪽 사이드바에서 **Automation**을 선택합니다.

**HelloWorld**와 같은 여러 CloudScript 메서드가 표시되어야 합니다. 이 메서드는 **Hello PLAYERID** 메시지를 로그에 기록하며, **PLAYERID**는 현재 플레이어의 PlayFab ID입니다.

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-cloudscript.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=c97908f94559bbfd9d2b48d955d581a2" alt="Game Manager - Automation - CloudScript" width="1366" height="900" data-path="images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-cloudscript.png" />

## 자체 리비전 업로드

Game Manager를 통해 자체 사용자 지정 메서드를 업로드할 수 있습니다. 업로드하는 각 파일은 새 리비전을 만듭니다. 업로드 중에 PlayFab 서비스는 CloudScript에 대해 구문 오류에 대한 간단한 LINT 검사를 실행합니다.

오류를 찾으면:

* 오류 메시지가 표시됩니다.
* 오류를 수정하고 **SUBMIT**을 다시 선택합니다.
* 기본적으로, 새 업로드는 **DEPLOY REVISION # TO LIVE** 링크를 선택하여 배포해야 합니다. 이를 통해 여러 버전의 CloudScript로 업데이트하거나 롤백할 수 있습니다.

주황색 **UPLOAD NEW REVISION** 버튼을 처음 누르면, 로컬 컴퓨터에서 파일을 업로드할 수 있는 파일 선택기가 표시됩니다.

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-upload-cloudscript.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=68f6073c262ee7022e2d177b9ef0b0d8" alt="Game Manager - Upload CloudScript file" width="392" height="250" data-path="images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-upload-cloudscript.png" />

여러 리비전을 추가한 후에는 드롭다운을 사용하여 제출된 리비전 중 *어떤* 것이 라이브 상태가 될지 선택할 수 있습니다.

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-cloudscript-select-revision.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=cd0cb0ba3694a687309320bb0dd9b208" alt="Game Manager - Upload CloudScript - select revision" width="1366" height="771" data-path="images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-cloudscript-select-revision.png" />

## GitHub 통합

CloudScript 리비전을 관리하는 데 GitHub를 사용할 수도 있습니다. GitHub 계정이 있어야 하고 로그인되어 있어야 합니다.

* **USE GITHUB** 버튼(이전 스크린샷의 회색 버튼)을 선택합니다.
* 다음 창에는 주황색 **AUTHORIZE GITHUB ACCOUNT** 버튼이 있습니다.
* **GitHub**에서 새로운 빈 저장소를 만듭니다.
* PlayFab Game Manager의 **GitHub** 페이지로 돌아옵니다(탭 새로 고침).
* 이 시점에서 **GitHub** 저장소를 선택하고 타이틀에 바인딩할 수 있어야 합니다.

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-addons-github.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=dbc72c3437b55c738803cf6cb013ae90" alt="Game Manager - Addons - GitHub" width="1366" height="909" data-path="images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-addons-github.png" />

GitHub에 바인딩되면 수동 업로드 옵션이 제거되고 "master" 브랜치에 대한 각 GitHub 커밋에 대해 새로운 CloudScript 리비전이 자동으로 생성됩니다.

*여러* 파일을 커밋하면, 하나의 PlayFab CloudScript 리비전으로 연결됩니다. 라이브 리비전 선택은 동일하게 유지됩니다. GitHub에 대한 새 커밋은 위에서 설명한 대로 Game Manager에서 라이브로 설정해야 합니다.

## 결론

CloudScript를 사용하면 PlayFab에 파일을 업로드하고 서버에서 코드를 실행할 수 있습니다. 왼쪽 사이드바의 **Automation** 옵션에서 CloudScript 파일을 관리할 수 있습니다. 자신의 컴퓨터에서 수동으로 파일을 업로드하거나 타이틀을 GitHub 계정에 바인딩할 수 있습니다.

이 빠른 시작은 코드 파일을 관리하고 PlayFab에 업로드하는 방법을 다룹니다.

더 많은 질문이 있는 경우, [사용자 지정 CloudScript 작성 자습서](/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript)에서 CloudScript 코드 파일을 작성하는 방법에 대해 자세히 설명합니다.


## Related topics

- [CloudScript](/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript/index.md)
- [Azure Functions를 사용하는 PlayFab CloudScript 빠른 시작 가이드](/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md)
- [Title Data 빠른 시작](/ko/services/playfab/live-service-management/game-configuration/titledata/quickstart.md)
- [플레이어 데이터 빠른 시작](/ko/services/playfab/player-progression/player-data/quickstart.md)
- [CloudScript를 통해 읽기 전용 또는 내부 플레이어 데이터 수정](/ko/services/playfab/player-progression/player-data/how-to-modify-read-only-internal-player-data.md)