Unity Gaming Services CLI

Use the Unity Gaming Services command-line interface to create, deploy, and manage Cloud Code modules.

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

最終更新 7ヶ月前

Unity Gaming Services CLI を使用して、Cloud Code モジュールを操作できます。CLI を使用して、コマンドラインから Cloud Code モジュールを作成、デプロイ、管理できます。

前提条件

CLI を深く掘り下げて調べるには、Unity Gaming Services CLI の使用の準備ガイドのステップに従います。

このガイドに従うには、最初に以下のアクションを実行する必要があります。

UGS CLI をインストールします。

プロジェクト ID と環境を以下のように設定します。

ugs config set project-id <your-project-id>

ugs config set environment-name <your-environment-name>

Cloud Code と環境管理に必要なロールでサービスアカウントを設定します。認証の取得を参照してください。

CLI の使用

すべてのコマンドとオプションの完全なリファレンスについては、Cloud Code コマンドラインのドキュメントを参照してください。

注

ノート:

ugs cloud-code modules

コマンドは

ugs cc m

としても使用可能です。

注

ノート: CLI は現在モジュールのカスタムタグをサポートしておらず、それらは無視されます。カスタムのキーと値のペアをモジュールにアタッチする場合は、Cloud Code API を使用します。

モジュールの作成

サンプルモジュールでソリューションをローカルに作成するには、

new-file

コマンドを実行します。


ugs cloud-code modules new-file <module-name> <module-directory>

コマンドにより、サンプルモジュールとともに新しいソリューションが作成されます。

ソリューションをそのまま使用することも、ニーズに合わせて変更することもできます。

注

ノート: ストレージ制限が適用されます。Cloud Code 制限を確認してください。

モジュールのデプロイ

Deploy

コマンドにより、Cloud Code モジュールをリモート環境にデプロイできます。コマンドでは、

.ccm

形式の事前コンパイルされたモジュールと、デプロイ前に自動的にコンパイルおよび圧縮される C# ソリューションの両方がサポートされます。

デフォルトでは、デプロイはソリューションの

Release

ビルド設定に基づいて行われます。サイズを減らすため、この設定にはテストプロジェクトなど余分な内容を加えないことをお勧めします。ビルド設定の詳細については、Rider または Visual Studio のドキュメントを参照してください。

一度に複数のモジュールをデプロイするには、複数のファイルパスを指定するか、複数のファイルを含むディレクトリを指定します。


ugs deploy <path-to-ccm-file> <path-to-sln-file>


ugs deploy <path-to-directory>

C# ソリューションのデプロイ

C# ソリューションをデプロイできます。また、デプロイ前に自動的にコンパイルおよび圧縮できます。

コンパイルをサポートするには、ソリューションにメインプロジェクトの公開プロファイルが含まれている必要があります。

公開プロファイルの作成方法については、特定の IDE ドキュメントを参照してください。

JetBrains Rider - 公開プロファイル
Visual Studio - ASP.NET Core アプリケーションデプロイ用の Visual Studio 公開プロファイル (.pubxml)
Visual Studio - Visual Studio for Mac を使用したフォルダーへの公開

ソリューションをデプロイする場合、それらはデプロイ前に自動的にコンパイルおよび圧縮されます。結果はローカル一時フォルダー (例えば

<temp-folder>/<solution-name>

) に保存されます。

C# ソリューションをデプロイするには、

.sln

ファイルへのパスをコマンドへの引数として指定します。


ugs deploy <path-to-sln-file>

注意

重要: 現在、ソリューションデプロイはソリューションごとに 1 つのメインプロジェクトのみをサポートします。メインプロジェクトは、公開プロファイルを含むプロジェクトです。複数のモジュールを含むソリューションはデプロイできません。また、このソリューションのすべてのプロジェクトが、フォルダー階層内のソリューションファイルの下にあることを確認します。ソリューションを構造化する方法を理解するには、モジュール構造を参照してください。

事前コンパイルされたモジュールのデプロイ

事前コンパイルされたモジュールをデプロイするには、

.ccm

ファイルへのパスをコマンドへの引数として指定します。


ugs deploy <path-to-ccm-file>

注

ノート: ほとんどのユースケースでは、ソリューションのデプロイワークフローを使用できます。より高度なワークフローとしては、事前コンパイル済みのモジュールをパッケージ化してデプロイできます。モジュールを

.ccm

ファイルに圧縮する方法については、コードのパッケージ化を参照してください。

環境の同期

1 つの環境からすべてのモジュールを移動し、それらを別の環境にデプロイできます。

以下のコマンドを実行して、現在の環境内のすべてのモジュールのアーカイブを生成します。


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>

ドキュメント

Development

User Acquisition

Monetization

産業