Amazon GameLift Servers Anywhereでローカルテストを設定する

Anywhere フリートを作成するには

1. ワークステーション用のカスタムロケーションを作成します。(AWS CLI またはコンソール)。カスタムロケーションは、Anywhere フリートに含める予定のコンピューティングリソースのラベルにすぎません。カスタムロケーション名は custom- で始まる必要があります。例: custom-my_laptop。「カスタムロケーションを作成する」を参照してください。

2. Anywhere フリート (AWS CLI またはコンソール) を作成します。この手順では、ローカルワークステーションのカスタムロケーションを使用してフリートリソースを作成します。「Anywhere フリートを作成する」を参照してください。

   新しいフリートの ID または ARN 値をメモします。この値は次のステップで必要になります。

3. ローカルワークステーションをフリートコンピューティングとして登録します (AWS CLI のみ)。ゲームサーバーをホストするには、Anywhere フリートに少なくとも 1 つのコンピューティングリソースが必要です。「フリートにコンピューティングを追加する」を参照してください。フリートにコンピューティングを追加するには、次の情報が必要です。

   • コンピューティング名。フリート内の各コンピューティングには、一意の名前が必要です。

   • Anywhere フリート識別子。FleetID または FleetArn のいずれかを使用できます。

   • コンピューティングの接続情報。IpAddress または DnsName のいずれかを指定します。これは、Amazon GameLift Servers とゲームクライアントがゲームサーバーに接続する方法です。

   • Anywhere フリート内のカスタムロケーション。

   GameLiftServiceSdkEndpoint の戻り値をメモします。Anywhere フリートで実行するようにゲームサーバーを更新するときは、この値が必要です。

Anywhere フリート用にゲームサーバーを準備する

1. 認証トークンを取得します。ゲームサーバーには、 Amazon GameLift Serversサービスとのすべての通信に認証トークンを含める必要があります。Amazon GameLift Servers認証トークンは有効期間が短く、定期的に更新する必要があります。

   ベストプラクティスとして、スクリプトを作成して次のタスクを完了します。

   • AWS CLI アクション get-compute-auth-token を呼び出します。

   • ローカルコンピューティングの環境変数など、ゲームサーバープロセスが取得できるトークンの戻り値を保存します。

   ゲームサーバーと一緒にスクリプトをコンピューティングにインストールします。最初のゲームサーバープロセスを開始する前に、実行するスクリプトを設定します。ゲームサーバープロセスがアクティブな間は、スクリプトを定期的に実行して有効な認証トークンを維持します。コンピューティング上のすべてのゲームサーバープロセスは、同じ認証トークンを使用できます。

2. Amazon GameLift Servers ゲームサーバーコードを更新します。ゲームサーバーコードをサーバー SDK for Amazon GameLift Servers と統合すると、アクション InitSdk() への呼び出しが追加されます。ゲームサーバーを Anywhere フリートで実行する場合、この呼び出しには、追加のサーバーパラメータが必要です。詳細については、開発言語に該当する「サーバープロセスを初期化する」および「サーバー SDK 5.x for Amazon GameLift Servers」を参照してください。サーバーパラメータは次のとおりです。

   • webSocketUrl – このパラメータを、フリートにコンピューティングを登録したときに返される GameLiftServiceSdkEndpoint 値に設定します。

   • hostId – このパラメータを、Anywhere フリートにコンピューティング登録した時に指定されるコンピューティング名に設定します。

   • fleetId – このパラメータを Anywhere フリートの ID に設定します。

   • authToken – このパラメータを、コンピューティングの認証トークンを取得するリクエストに応答して返されるトークンに設定します。

   • processId – このパラメータを設定して、ローカルコンピューティングで実行されているゲームサーバープロセスを特定します。同時ゲームサーバープロセスごとに一意のプロセス ID が必要です。

   各ゲームサーバープロセスが使用するサーバーパラメータ値は、プロセスが実行されている Anywhere フリートコンピューティングに固有である必要があります。コンピューティングに適切な値を取得する方法の詳細については、「フリートにコンピューティングを追加する」を参照してください。ベストプラクティスとして、webSocketUrl、hostId、fleetId、および authToken をローカルコンピューティングの環境変数として設定します。コンピューティングで実行されるすべてのサーバープロセスは、これらの値を使用します。

3. ローカルコンピューティングにゲームサーバービルドをインストールします。ゲームサーバーの実行に必要なすべての依存関係を含めます。

4. ローカルコンピューティングで実行されている 1 つ以上のゲームサーバープロセスを開始します。ゲームサーバープロセスがサーバー SDK アクション ProcessReady() を呼び出すと、プロセスはゲームセッションをホストする準備が整います。

1. 既存の GameSession をクリーンアップします。ゲームサーバープロセスがクラッシュした場合または、ProcessEnding() を呼び出さない場合は、ゲームサーバーがヘルスチェックの送信を停止した後に、Amazon GameLift Servers が GameSession をクリーンアップします。

2. 新しいゲームサーバービルドを生成します。ゲームサーバーを変更し、改訂されたビルドをパッケージ化します。

3. ローカルコンピューティングでゲームサーバービルドを更新します。以前の Anywhere フリートはまだアクティブで、ラップトップはフリート内のコンピューティングリソースとして登録されたままです。

4. 更新された認証トークンを取得します。get-compute-auth-token CLI コマンドを呼び出し、トークンをローカルコンピューティングに保存します。

5. ローカルコンピューティングで実行されている 1 つ以上のゲームサーバープロセスを開始します。ゲームサーバープロセスが ProcessReady() を呼び出すと、テストに使用する準備が整います。