ゲームマネージャーを使用したビルドの配置

[アーティクル]
07/14/2023

この記事では、ゲームマネージャーを使用して VM のビルドを展開/作成するための一般的な手順を示します。

ビルドを初めて展開する場合は、Windows Runner C# サンプル、またはWrapper サンプルの使用をお勧めします。どちらも、実際にサーバーをデプロイするために必要なすべてのアセットが含まれています。

注意

PlayFab Multiplayer Servers を使用して表示するには、ゲームマネージャーから機能を有効にする必要があります。手順については、「PlayFab サーバー機能を有効にする」を参照してください。

各パラメーターに使用できる値の詳細については、「ビルド定義」を参照してください。

ゲームマネージャーを使用してデプロイする手順

ゲームマネージャーにサインインする
[マイスタジオとタイトル] ページに移動し、ゲームタイトルを選択してダッシュボードを表示します
「マルチプレイヤー>サーバーページ」に移動し、右上にある[新しいビルド]を選択して新しいビルドを作成します
ビルドの詳細とともに始め、説明的な文字列をビルド名として使用します。
開発中は、Dasv4 など、制限付き無料扱いのサーバーを選択します。価格の詳細については、「PlayFab マルチプレイヤーサーバーの課金」を参照してください。
コンピューターごとのサーバーに必要な値を設定します

次の図は、info セクションで使用される値を示しています。
次に、サーバーの詳細部分が表示され、この部分では、Windows または Linux の何れかのOS の種類を 1 つ選択する必要があります。そしてあなたが選んで決定した OS に基づいて、プロセスまたはコンテナーの何れかのサーバーの種類を選択します。

注意

Linux プラットフォームの場合は、独自のコンテナーイメージを作成する必要があります。詳細については、「Linux コンテナーイメージを作成してデプロイする」を参照してください。コンテナーイメージを既にアップロードしている場合は、[イメージ] ドロップダウンに表示されます。これを使用するには、イメージを選択します。

OS の種類を選択したら、サーバーの種類を選択できます。 OS/サーバーの種類に基づいて、次の機能を有効にできます。

仮想マシンメトリックプレビュー: これを有効にすると、CPU、メモリ、ネットワークなどのシステムレベルのメトリックを確認できます。詳細については、VM のパフォーマンスメトリック (プレビュー) に関する記事をお読みください。
Windows Core Preview: テストビルドで最新バージョンの Windows オペレーティングシステムをテストして、新しいオペレーティングシステムでゲームがどのように実行されるのか確認できます。詳細については、「Windows OS のパッチレベルの更新プログラム」を参照してください。
Automatic Crash Dump Collection: Windows コンテナー サーバータイプの自動クラッシュダンプ収集機能を有効化できます。完全、ミニ、またはカスタムのダンプの取得を選び決定できます。詳細については、「クラッシュダンプの自動収集の有効化」をご覧ください。

プロセスモード用サーバーの詳細

次の図は、Windows をプラットフォームとして選択し、かつ Process ベースのサーバータイプとするときに [OS] セクションで使用される値を示しています。 Linux プロセスベースのサーバーを使用するオプションもあります。 OS とサーバータイプとして Windows プロセスが選択されているサーバーの詳細

コンテナーモードのサーバーの詳細

次の図は、プラットフォームとして Linux を選択したが、コンテナーベースのサーバータイプを使用する場合に、OS セクションで使用される値を示しています。 Windows コンテナーベースのサーバーを使用するオプションもあります。 OS とサーバータイプとして Linux コンテナーが選択されているサーバーの詳細

ビルドのアセット

資産で、[アップロード] を選択します。コンパイル済みの PlayFab マルチプレイヤーサーバービルドを含むフォルダーに移動し、アップロードする .zip パッケージを選択します。

Windows サーバーの資産

Windows プラットフォームの場合は、PlayFab ゲームサーバービルドを資産としてアップロードする必要があります。 PlayFab ゲームサーバービルドを作成する方法については、「ゲームサーバービルドの作成」を参照してください。資産をアップロードして、Windows コンテナーイメージを変更、カスタマイズします。 Windows サーバー内のアセットのマウントパスは、C ドライブにルートが置かれる必要があります。

Windows コンテナーサーバー用の資産

Windows サーバーのアセットは C ドライブに存在する必要があります。さもなければ、API がエラーを返す可能性があります。マウントパスはコンテナーのみ必要です。

注意

プロセスベースのサーバーのマウントパスは指定しません。

Linux サーバーのアセット

Linux プラットフォームでは、ゲームサーバーをコンテナーイメージの一部に含めることができるので、アセットのアップロードはオプションです。ただし、引き続きゲームサーバーが必要です。アップロードするコンテナー内でマウントパスが有効であることを確かめて下さい。

アセットをアップロードする場合:

C:\Assets を設定するか、マウントパスとして別のパスを選択します
C:\Assets\YourGameServerBuild.exe を Start コマンドとして設定します

開始コマンドと共にある MPS 上の新しいビルドのアセットセクション。

ネットワーク設定

ネットワークの場合は、ポート番号、名前、プロトコルを設定します。

コンテナーサーバータイプのポートの設定

コンテナーサーバータイプを使用している場合は、ポート番号を指定する必要があります。

たとえば、コンテナーサーバータイプの Game Manager では、次を指定できます:

ポート名: "gameServerPort"
ポート番号: 7777
プロトコル: UDP

Game Manager におけるコンテナーサーバータイプ向けのネットワーク設定

次に、コードで次のような操作を行います

int port = 7777; // since you already know the port
GameServer gs = new GameServer(port);
gs.start();

注意

コンテナーモードでは、各ゲームサーバーは独自のネットワーク名前空間で実行されます。これが、すべてのゲームサーバーが同じポートをリッスンできる理由です。コンテナーポートは、仮想マシン上のポートに動的かつ一意にマップされます。ただし、プロセスモードについては、すべてのゲームサーバーが同じネットワーク名前空間で実行されます。すべてのゲームサーバーが同じポートをリッスンすると競合が発生します。それが、GSDK から ServerListeningPort を取得する必要がある理由です。

プロセスサーバータイプのポートの設定

プロセスサーバータイプについては、GSDK を使用してポート番号を取得する必要があります。ビルド定義の一部としてポート番号を含めません。

プロセスサーバータイプに関する Game Manager のネットワーク設定

次に、コードで次のようなことを行いたいと思います:

var gsc = GameServerSDK.GetConnectionInfo();

var gp = gsc.Where(x=>x.Name=="gameServerPort").Single();

GameServer gs = new GameServerPort(gp.ServerListeningPort);

完全なサンプルコードを表示するには、GSDK/CSharp/GSDK_CSharp_Standard の GameServerConnectionInfo.cs に移動します。GSDK からポートを取得する上記のコードサンプルは、コンテナーモードでも機能します。

コマンドを開始する

コンテナーベースのサーバーの開始コマンド

開始コマンドは、要求された全ての引数を含めたゲームの実行ファイルへの絶対パス (マウントパスを含む) にする必要があります。たとえば、開始コマンドは、C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2 のようになります。 "C:\Assets" の部分を開始コマンドの絶対パスに追加する必要があるのは、それが Windows コンテナーベースのサーバーである場合のみです。それは、ゲームアセットの展開元ディレクトリだからです。

Windows プロセスベースサーバーの開始コマンド

開始コマンドは、アップロードされたアセット内の相対パスです。実行可能ファイルがアセットフォルダ内に直接ある場合は、<yourGameServerBuild.exe> を使用できます。別のフォルダー (例えば GameDirectory など) 内にある場合、開始コマンドは gameDirectory/YourGameServerBuild.exe のようになります。

[領域] で、サーバーを展開する領域を選択します。次に、スタンバイサーバーの数と最大サーバー数を指定します。
[保存] を選択して、展開プロセスを開始します。ビルドのホームページが取得されます。ビルドには、次の図に示すように、Deploying 状態が表示されます。

数分で、ビルドはDeployed 状態になります。これは、サーバーが展開され、割り当て可能なことを意味します。ゲームサーバーの割り当ての詳細については、こちらをご覧頂くことが可能で、そこではMpsAllocatorSample を使用してサーバーの割り当てを検証することができます。

領域情報の構成

ビルドを展開した後も、次のパラメーターを変更できます。

リージョン
スタンバイサーバー
最大サーバー数

領域設定の構成方法

[サーバー]>[ビルド] ページに移動します
変更するビルドを選択します
[リージョン] タブで、[リージョン別のサーバー] セクションに移動します
領域の追加/削除とサーバー番号の変更

ゲームマネージャーで展開されたビルド

ヒント

開発中に、VM コア時間の使用を回避するために、未使用または異常なリージョンをシャットオフします。コア時間の使用は、VM の起動時に開始され、VM がシャットオフされるまで続行されます。リージョンのターゲットスタンバイサーバーが 0 に達するか、リージョンが削除されない限り、リージョン内の VM は自動的にシャットオフされません。

VM をシャットダウンしています

VM をシャットダウンするには 3 つの方法があります

リージョンのターゲットスタンバイを 0 に設定すると、このリージョンの VM のみがシャットダウンされます。
ビルドから特定のリージョンを削除します。
ビルド全体を削除すると、このビルドのすべてのリージョンにわたって VM がシャットダウンされます。

次の方法で共有

ゲームマネージャーを使用したビルドの配置