# Unity Gaming Services CLI

> Manage UGS configuration from the command line.

[UGS(Unity Gaming Services) CLI](https://services.docs.unity.com/guides/ugs-cli/latest/general/overview)는 Unity Gaming Services 구성을 관리, 테스트하고 배포할 수 있는 다양한 툴을 갖춘 커맨드 라인 인터페이스입니다. CLI는 Unity Dashboard에 확장 가능하고 자동화할 수 있는 대안을 제공하여 팀의 워크플로와 생산성 개선에 기여할 수 있습니다.

## 시작하기##get-started

UGS CLI를 시작하려면 다음 기술 자료를 참고하십시오.

* UGS CLI를 설치하고 사용하려면 [시작하기 기술 자료](https://services.docs.unity.com/guides/ugs-cli/latest/general/get-started/install-the-cli)를 따릅니다.
* Deployments를 사용하는 방법에 대한 [샘플](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md)을 검색합니다.
* GS CLI를 CI/CD 툴의 일부로 연동하는 방법에 대한 예제는 다음과 같습니다.
  * [Unity Build Automation](https://services.docs.unity.com/guides/ugs-cli/latest/general/samples/ci-cd-pipeline-usage/unity-build-automation/)
  * [GitHub Action](https://services.docs.unity.com/guides/ugs-cli/latest/general/samples/ci-cd-pipeline-usage/github-actions)
  * [Jenkins](https://services.docs.unity.com/guides/ugs-cli/latest/general/samples/ci-cd-pipeline-usage/jenkins)
  * [Docker](https://services.docs.unity.com/guides/ugs-cli/latest/general/samples/ci-cd-pipeline-usage/docker)

전체 기술 자료는 [UGS CLI](https://services.docs.unity.com/guides/ugs-cli/latest/general/overview) 기술 자료를 참고하십시오.

## 지원되는 서비스 및 사용 사례##supported-services-and-use-cases

### 배포##deployments

Deployments는 UGS에 Config as Code 워크플로를 도입합니다. CLI를 사용하여 deploy 커맨드로 파일 구성을 배포할 수 있으며, 이를 통해 자동 빌드 파이프라인(CI/CD)에 연동할 수 있습니다.

Deployments 기능은 [Remote Config](https://forum.unity.com/threads/remote-config-authoring-tool-from-the-editor-pre-release.1353494/), [Cloud Code](https://forum.unity.com/threads/cloud-code-js-authoring-tool-from-the-editor-pre-release.1353491/)와 같은 패키지를 통해 Unity 에디터에서도 지원됩니다. CLI는 엔진에 구애받지 않는 개발자와 자동 빌드 워크플로를 위한 Deployments 기능을 제공합니다.

Deployments로 다음을 수행할 수 있습니다.

* Cloud Code와 Remote Config를 위한 로컬 구성을 사용합니다.
* 게임 클라이언트 코드 옆에 서비스 구성을 추가합니다.
* 서비스 구성(예: 브랜치, 병합, 비교, 태그)에 Git과 유사한 워크플로를 적용합니다.
* [Unity 개발 환경](./service-environments.md)을 저장소 브랜치에 매핑하고 독립적으로 작업합니다.
* CLI 또는 [Deployment 창](https://docs.unity3d.com/Packages/com.unity.services.deployment@latest/index.html?subfolder=/manual/deployment_window.html)을 통해 파일 구성을 수동으로 배포합니다.
* 자동 배포를 위해 CI/CD 파이프라인에 배포 단계를 추가합니다.

### Deployments에 지원되는 서비스##supported-services-for-deployments

* [Cloud Code 스크립트](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-cloud-code-script)
* [Cloud Code C# 모듈](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-cloud-code-module)
* [Remote Config](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-remote-config)
* [Economy](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-economy)
* [Leaderboards](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-leaderboards)
* [Triggers](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-triggers)
* [액세스](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-access)
* [Matchmaker](https://github.com/Unity-Technologies/unity-gaming-services-cli/blob/main/Samples/Deploy/instructions.md#deploy-matchmaker)

### CLI에 지원되는 서비스##supported-services-for-cli

* [액세스](https://services.docs.unity.com/guides/ugs-cli/latest/access/Access%20Command%20Line/overview/)

* [Cloud Code](https://services.docs.unity.com/guides/ugs-cli/latest/cloud-code/Cloud%20Code%20Command%20Line/overview)

* [Economy](https://services.docs.unity.com/guides/ugs-cli/latest/economy/Economy%20Command%20Line/overview/)

* [Leaderboards](https://services.docs.unity.com/guides/ugs-cli/latest/leaderboards/Leaderboards%20Command%20Line/overview)

* [Lobby](https://services.docs.unity.com/guides/ugs-cli/latest/lobby/Lobby%20Command%20Line/overview)

* [Matchmaker](https://services.docs.unity.com/guides/ugs-cli/latest/general/base-commands/deploy/)

* [Player/Unity Authentication](https://services.docs.unity.com/guides/ugs-cli/latest/player/Player%20Command%20Line/overview/)

* [Remote Config](https://services.docs.unity.com/guides/ugs-cli/latest/remote-config/Remote%20Config%20Command%20Line/overview)

* [Triggers](https://services.docs.unity.com/guides/ugs-cli/latest/triggers/Triggers%20Command%20Line/overview/)

* [환경](https://services.docs.unity.com/guides/ugs-cli/latest/general/base-commands/environment/add)

* [Cloud Save](https://services.docs.unity.com/guides/ugs-cli/latest/cloud-save/Cloud%20Save%20Command%20Line/overview/)

* [Multiplay Hosting](https://services.docs.unity.com/guides/ugs-cli/latest/game-server-hosting/Game%20Server%20Hosting%20Command%20Line/overview/)

* [Scheduler](https://services.docs.unity.com/guides/ugs-cli/latest/scheduler/Scheduler%20Command%20Line/overview/)