로컬 배포 자동화

Automate the deployment of your Cloud Code module with the Unity Gaming Services CLI or project file.

읽는 시간 1분

최근 업데이트: 7달 전

이 가이드에서는 UGS(Unity Gaming Services) CLI나 프로젝트 파일을 사용하여 Cloud Code 모듈의 배포를 자동화하는 방법을 보여 줍니다. 배포를 CI/CD 파이프라인에 연동하려면 CI/CD와 연동을 참고하십시오.

필수 조건

로컬 배포를 자동화하려면 Cloud Code 모듈과 UGS CLI가 필요합니다.

Cloud Code 모듈을 생성합니다.
CLI 설치(Unity Gaming Services CLI)의 단계에 따라 UGS CLI를 설치하고, 구성하고, 인증합니다.

UGS CLI로 자동화

UGS CLI는 솔루션을 배포하는 데 사용할 수 있는

deploy

커맨드를 제공합니다.

deploy

커맨드는 모듈을 압축하여 Cloud Code 서비스에 배포합니다. 배포하려면 프로젝트 디렉토리의 터미널에서 다음 커맨드를 실행합니다.


ugs deploy <path_to_solution>

참고

참고: 컴파일을 지원하려면 솔루션에 메인 프로젝트에 대한 퍼블리시 프로필이 포함되어야 합니다. 자세한 내용은 C# 솔루션 배포를 참고하십시오.

프로젝트 파일을 사용하여 자동화

빌드 시 프로젝트를 퍼블리시, 압축, 배포하도록 프로젝트 파일을 구성하는 경우 프로젝트 파일을 사용하여 Cloud Code 모듈의 배포를 자동화할 수 있습니다.

참고

참고: 이 작업은 고급 워크플로입니다. 대부분의 경우 UGS CLI 배포 커맨드만 사용해도 충분합니다.

자세한 내용은 프로젝트 파일 이해에 관한 Microsoft 가이드를 참고하십시오. 이 스크립트에서는 UGS CLI Deploy 커맨드를 사용합니다.

프로젝트 파일 구성

다음 프로젝트 파일 구성을 사용하여 Cloud Code 모듈의 배포를 자동화할 수 있습니다.


<Target Name="RemoveDirectory">    <RemoveDir Directories="$(OutDir)Module/" /> </Target><Target Name="PublishModule" DependsOnTargets="RemoveDirectory">    <Exec Command="dotnet publish -r linux-x64 --no-self-contained -o $(OutDir)Module/$(AssemblyName)" /></Target><Target Name="ZipModule" DependsOnTargets="PublishModule">    <ZipDirectory SourceDirectory="$(OutDir)Module/$(AssemblyName)" DestinationFile="$(OutDir)Module/$(AssemblyName).ccm" /></Target><Target Name="DeployModule" DependsOnTargets="ZipModule">    <Exec Command="ugs deploy $(OutDir)/Module/$(AssemblyName).ccm" /></Target>

위 구성을 프로젝트 파일에 복사하여 붙여 넣습니다.

```
RemoveDirectory
```
타겟이
```
OutDir
```
디렉토리에서
```
Module
```
디렉토리를 제거합니다.
```
PublishModule
```
타겟이 모듈을
```
Module
```
디렉토리에 퍼블리시하고 필요한 어셈블리를 생성합니다.
```
ZipModule
```
타겟이
```
Module
```
디렉토리를 압축합니다.
```
DeployModule
```
타겟이 모듈을 Cloud Code 서비스에 배포합니다.

R2R 컴파일(선택 사항)

R2R(Ready to Run) 컴파일은 Cloud Code 모듈의 콜드 스타트 시간을 개선하는 선택적 기능입니다. 이 옵션이 모듈에 미치는 영향을 확인하려면 [Ready to Run](./package-code.mdx#ready-to-run-r2r-compilation을 참고하십시오. Ready to Run 컴파일을 활성화하려면

PublishModule

타겟에

PublishReadyToRun

프로퍼티가 포함되도록 다음과 같이 수정합니다.


<Target Name="PublishModule" DependsOnTargets="RemoveDirectory">    <Exec Command="dotnet publish -r linux-x64  -p:PublishReadyToRun=true --no-self-contained -o $(OutDir)Module/$(AssemblyName)" /> </Target>

타겟 실행

타겟을 실행하려면 프로젝트 디렉토리의 터미널에서 다음 커맨드를 실행합니다.


msbuild /t:DeployModule

msbuild

커맨드를 찾을 수 없는 경우

msbuild

경로를

PATH

환경 변수에 추가해야 할 수도 있습니다.

참고

참고:

DeployModule

을 다른 타겟 이름으로 바꾸면 다른 타겟을 개별적으로 실행할 수 있습니다. 타겟은 서로 종속되어 있으므로 실행되는 모든 타겟은 자신이 종속된 타겟도 실행합니다.

예상 출력

배포가 성공하면 다음과 같은 출력이 표시됩니다.


Deployed:    ExampleModule.ccm

기술 자료

Development

User Acquisition

Monetization

산업 분야