ドキュメント

サポート

Cloud Code

Open Unity Dashboard

Cloud Code

Unity Gaming Services CLI

Use the Unity Gaming Services command-line interface to create, deploy, and manage Cloud Code modules.
読み終わるまでの所要時間 2 分最終更新 21日前
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 コマンドラインのドキュメント を参照してください。
注
ノート: 
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 ドキュメントを参照してください。 ソリューションをデプロイする場合、それらはデプロイ前に自動的にコンパイルおよび圧縮されます。結果はローカル一時フォルダー (例えば 
<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>