Unity Gaming Services CLI
Use the Unity Gaming Services command-line interface to create, deploy, and manage Cloud Code modules.
읽는 시간 1분최근 업데이트: 6달 전
Unity Gaming Services CLI를 사용하여 Cloud Code 모듈과 상호 작용할 수 있습니다. CLI를 사용하면 커맨드 라인에서 Cloud Code 모듈을 생성, 배포, 관리할 수 있습니다.
필수 조건
CLI에 대해 자세히 알아보려면 Unity Gaming Services CLI 시작하기 가이드에 나와 있는 단계를 따르십시오.
이 가이드를 따르려면 먼저 다음 작업을 완료해야 합니다.
-
다음과 같이 프로젝트 ID와 환경을 구성합니다.
ugs config set project-id <your-project-id>
ugs config set environment-name <your-environment-name>
CLI 사용
커맨드와 옵션이 모두 나와 있는 레퍼런스가 필요한 경우, Cloud Code 커맨드 라인 기술 자료를 참고하십시오.
참고
참고: 커맨드는 으로도 사용할 수 있습니다.
ugs cloud-code modulesugs cc m참고
참고: 현재 CLI에서는 모듈에 대한 커스텀 태그를 지원하지 않으므로 이러한 태그는 무시됩니다. 커스텀 키-값 페어를 모듈에 연결하려면 Cloud Code API를 사용합니다.
모듈 생성
샘플 모듈이 포함된 솔루션을 로컬에서 생성하기 위해 다음과 같이 커맨드를 실행할 수 있습니다.
new-fileugs cloud-code modules new-file <module-name> <module-directory>
이 커맨드는 샘플 모듈이 포함된 새로운 솔루션을 만듭니다.
솔루션을 그대로 사용하거나 필요에 맞게 수정할 수 있습니다.
참고
참고: 스토리지 제한 사항이 적용됩니다. Cloud Code 제한 사항을 확인하십시오.
모듈 배포
Deploy.ccm기본적으로 배포는 솔루션의 빌드 구성을 기반으로 합니다. 이 구성에는 크기를 축소하기 위한 테스트 프로젝트 등의 추가 콘텐츠를 포함하지 않아야 합니다. 빌드 구성에 관한 자세한 내용은 Rider나 Visual Studio의 기술 자료를 참고하십시오.
Release한 번에 여러 모듈을 배포하려면 다음과 같이 다수의 파일 경로를 제공하거나 여러 파일이 포함된 디렉토리를 제공합니다.
ugs deploy <path-to-ccm-file> <path-to-sln-file>
ugs deploy <path-to-directory>
C# 솔루션 배포
C# 솔루션을 배포하고 배포 전에 자동으로 컴파일하고 압축할 수 있습니다.
컴파일을 지원하려면 솔루션에 메인 프로젝트에 대한 퍼블리시 프로필이 포함되어야 합니다.
퍼블리시 프로필 생성 방법에 대해 알아보려면 관련 IDE 기술 자료를 참고하십시오.
- JetBrains Rider - 퍼블리시 프로필
- Visual Studio - Visual Studio ASP.NET Core 앱 배포용 퍼블리시 프로필(.pubxml)
- Visual Studio - Visual Studio(Mac용)를 사용해 폴더에 퍼블리시
솔루션을 배포하면 배포 전에 자동으로 컴파일과 압축이 이루어집니다. 결과는 로컬 임시 폴더에 저장됩니다(예: ).
<temp-folder>/<solution-name>C# 솔루션을 배포하려면 커맨드의 인수로 파일의 경로를 제공합니다.
.slnugs deploy <path-to-sln-file>
경고
중요: 현재 솔루션 배포에서는 솔루션당 하나의 메인 프로젝트만 지원합니다. 메인 프로젝트는 퍼블리시 프로필이 포함된 프로젝트입니다. 여러 모듈이 포함된 솔루션은 배포할 수 없습니다. 또한 이 솔루션의 모든 프로젝트가 폴더 계층 구조의 솔루션 파일에 속해 있어야 합니다. 솔루션의 구조를 만드는 방법을 알아보려면 모듈 구조를 참고하십시오.
사전 컴파일된 모듈 배포
사전 컴파일된 모듈을 배포하려면 커맨드의 인자로 파일의 경로를 제공합니다.
.ccmugs 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>
참고
참고: 는 기본적으로 환경을 덮어쓰지 않습니다. 임포트 전에 기존 모듈을 삭제하려는 경우 플래그를 사용하십시오.
Import--reconcile모듈 가져오기
배포한 단일 모듈에 대한 정보를 얻으려면 다음과 같은 커맨드를 실행합니다.
ugs cloud-code modules get <module-name>
모듈 이름은 .ccm 아카이브에 포함된 .NET 클래스 라이브러리의 이름입니다. 다음과 같은 커맨드를 실행하여 현재 Cloud Code에 배포된 모든 모듈을 나열할 수도 있습니다.
ugs cloud-code modules list
모듈 삭제
모듈을 삭제하려면 다음과 같은 커맨드를 실행합니다.
ugs cloud-code modules delete <module-name>