기술 자료

지원

Cloud Code

Cloud Code

Unity Gaming Services CLI

Use the Unity Gaming Services command-line interface to create, deploy, and manage Cloud Code modules.
읽는 시간 1분최근 업데이트: 한 달 전

Unity Gaming Services CLI를 사용하여 Cloud Code 모듈과 상호 작용할 수 있습니다. CLI를 사용하면 커맨드 라인에서 Cloud Code 모듈을 생성, 배포, 관리할 수 있습니다.

필수 조건

CLI에 대해 자세히 알아보려면 Unity Gaming Services CLI 시작하기 가이드에 나와 있는 단계를 따르십시오. 이 가이드를 따르려면 먼저 다음 작업을 완료해야 합니다.
  1. UGS CLI를 설치합니다.
  2. 다음과 같이 프로젝트 ID와 환경을 구성합니다.
    ugs config set project-id <your-project-id>

    ugs config set environment-name <your-environment-name>
  3. Cloud Code환경 관리에 필요한 역할을 사용하여 서비스 계정을 구성합니다. 인증 받기를 참고하십시오.

CLI 사용

커맨드와 옵션이 모두 나와 있는 레퍼런스가 필요한 경우, Cloud Code 커맨드 라인 기술 자료를 참고하십시오.

모듈 생성

샘플 모듈이 포함된 솔루션을 로컬에서 생성하기 위해 다음과 같이
new-file
커맨드를 실행할 수 있습니다.
ugs cloud-code modules new-file <module-name> <module-directory>
이 커맨드는 샘플 모듈이 포함된 새로운 솔루션을 만듭니다. 솔루션을 그대로 사용하거나 필요에 맞게 수정할 수 있습니다.

모듈 배포

Deploy
커맨드를 사용하여 Cloud Code 모듈을 원격 환경에 배포할 수 있습니다. 이 커맨드는
.ccm
포맷으로 사전 컴파일된 모듈과 배포 전에 자동으로 컴파일된 후 압축된 C# 솔루션을 모두 지원합니다.
기본적으로 배포는 솔루션의
Release
빌드 구성을 기반으로 합니다. 이 구성에는 크기를 축소하기 위한 테스트 프로젝트 등의 추가 콘텐츠를 포함하지 않아야 합니다. 빌드 구성에 관한 자세한 내용은 RiderVisual Studio의 기술 자료를 참고하십시오.
한 번에 여러 모듈을 배포하려면 다음과 같이 다수의 파일 경로를 제공하거나 여러 파일이 포함된 디렉토리를 제공합니다.
ugs deploy <path-to-ccm-file> <path-to-sln-file>
ugs deploy <path-to-directory>

C# 솔루션 배포

C# 솔루션을 배포하고 배포 전에 자동으로 컴파일하고 압축할 수 있습니다. 컴파일을 지원하려면 솔루션에 메인 프로젝트에 대한 퍼블리시 프로필이 포함되어야 합니다. 퍼블리시 프로필 생성 방법에 대해 알아보려면 관련 IDE 기술 자료를 참고하십시오. 솔루션을 배포하면 배포 전에 자동으로 컴파일과 압축이 이루어집니다. 결과는 로컬 임시 폴더에 저장됩니다(예:
<temp-folder>/<solution-name>
).
C# 솔루션을 배포하려면 커맨드의 인수로
.sln
파일의 경로를 제공합니다.
ugs deploy <path-to-sln-file>

사전 컴파일된 모듈 배포

사전 컴파일된 모듈을 배포하려면 커맨드의 인자로
.ccm
파일의 경로를 제공합니다.
ugs deploy <path-to-ccm-file>

환경 동기화

한 환경의 모든 모듈을 다른 환경에 옮겨 배포할 수 있습니다. 다음과 같은 커맨드를 실행하여 현재 환경에 있는 모든 모듈의 아카이브를 생성합니다.
ugs cloud-code modules export <out-dir> <file-name>
그러면 다음과 같은 커맨드를 실행하여 모듈을 임포트하고 다른 환경에 배포할 수 있습니다.
ugs cloud-code modules import <in-dir> <file-name> --environment-name <environment-name>

모듈 가져오기

배포한 단일 모듈에 대한 정보를 얻으려면 다음과 같은 커맨드를 실행합니다.
ugs cloud-code modules get <module-name>
모듈 이름은 .ccm 아카이브에 포함된 .NET 클래스 라이브러리의 이름입니다. 다음과 같은 커맨드를 실행하여 현재 Cloud Code에 배포된 모든 모듈을 나열할 수도 있습니다.
ugs cloud-code modules list

모듈 삭제

모듈을 삭제하려면 다음과 같은 커맨드를 실행합니다.
ugs cloud-code modules delete <module-name>