Unity Gaming Services CLI
Use the Unity Gaming Services command-line interface to create, deploy, and manage Cloud Code modules.
読み終わるまでの所要時間 2 分最終更新 6ヶ月前
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>
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 - ASP.NET Core アプリケーションデプロイ用の Visual Studio 公開プロファイル (.pubxml)
- Visual Studio - Visual Studio for Mac を使用したフォルダーへの公開
ソリューションをデプロイする場合、それらはデプロイ前に自動的にコンパイルおよび圧縮されます。結果はローカル一時フォルダー (例えば ) に保存されます。
<temp-folder>/<solution-name>C# ソリューションをデプロイするには、 ファイルへのパスをコマンドへの引数として指定します。
.slnugs deploy <path-to-sln-file>
注意
重要: 現在、ソリューションデプロイはソリューションごとに 1 つのメインプロジェクトのみをサポートします。メインプロジェクトは、公開プロファイルを含むプロジェクトです。複数のモジュールを含むソリューションはデプロイできません。また、このソリューションのすべてのプロジェクトが、フォルダー階層内のソリューションファイルの下にあることを確認します。ソリューションを構造化する方法を理解するには、モジュール構造 を参照してください。
事前コンパイルされたモジュールのデプロイ
事前コンパイルされたモジュールをデプロイするには、 ファイルへのパスをコマンドへの引数として指定します。
.ccmugs 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>