ローカルデプロイの自動化

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

読み終わるまでの所要時間 1 分

最終更新 1日前

このガイドでは、Unity Gaming Services (UGS) 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 の Deploy コマンドで十分です。

詳細については、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
```
ターゲットは
```
Module
```
ディレクトリを
```
OutDir
```
ディレクトリから削除します。
```
PublishModule
```
ターゲットはモジュールを
```
Module
```
ディレクトリに公開し、必要なアセンブリを生成します。
```
ZipModule
```
ターゲットは
```
Module
```
ディレクトリを圧縮します。
```
DeployModule
```
ターゲットは、モジュールを Cloud Code サービスにデプロイします。

Ready to Run コンパイル (任意)

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

産業