チュートリアル: Amazon GameLift Servers ラッパーを使用したクイックオンボーディング

Amazon GameLift Servers のオンボーディングチュートリアルへようこそ。このチュートリアルでは、クラウドベースのコンピューティングリソースのフリートでホストされるようにゲームサーバーを迅速にデプロイします。このチュートリアルを使用すると、Amazon GameLift Servers 用サーバー SDK をゲームコードに統合する作業をスキップし、代わりに最小限の機能でゲームをデプロイして Amazon GameLift Servers サービスと通信し、ゲームセッションを実行できます。基本的なホスティングソリューションを設定し、それを使用して、自動スケーリングやマッチメーキングなどの幅広い機能を体験します。また、ライブデモの一部としてゲームのプロトタイプをホストしたり、テストしたりするのにも最適です。

このオンボーディング方法の主な利点:

前提条件

開始する前に、以下を確認してください。

概要

このチュートリアルでは、次の作業を行います。

ステップ 1: ゲームサーバーラッパーを取得して構築する

次のコマンドを使用して、ゲームサーバーのラッパーソースを取得し、ラッパーを構築します。これらのコマンドは SSH を使用しますが、Github リポジトリに直接移動することもできます。

Windows

> git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
> cd amazon-gamelift-servers-game-server-wrapper
> powershell -file .\build.ps1
            

Mac と Linux

$ git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
$ cd amazon-gamelift-servers-game-server-wrapper
$ make
            

ビルドが成功すると、「out」ディレクトリが amazon-gamelift-servers-game-server-wrapper に追加されます。このディレクトリには、サポートされているホスティングフリートオプションごとに 1 つずつ、ビルドアーティファクトのセットを含む 3 つのフォルダがあります。このチュートリアルでは、マネージド EC2 フリートにデプロイするため、gamelift-servers-managed-ec2 フォルダを使用します。

ステップ 2: ゲームサーバービルドを準備する

このステップでは、Amazon GameLift Servers にアップロードするゲームサーバービルドファイルを準備します。

ディレクトリを作成します。

次に、ローカルマシンにゲームディレクトリを準備します。このディレクトリには、Amazon GameLift Servers でゲームサーバーを実行するために必要なすべてのファイルが含まれている必要があります。これには、ゲームサーバーラッパー、ゲームサーバービルド、およびラッパーをゲームサーバーと連携させる config.yaml が含まれます。

以下のステップを使用します。

ディレクトリ構造の例は次のようになります。

gamelift-servers-managed-ec2
│-- config.yaml
│-- amazon-gamelift-servers-game-server-wrapper
│-- MyGame
│   │-- server-executable.exe
│   │-- my-game-settings
│   │ ......
            

ステップ 3: フリートのラッパーを設定する

Amazon GameLift Servers はフリートのコンピューティングインスタンスのライフサイクルを管理し、サーバービルドがインストールされた新しいインスタンスをスピンアップし、必要に応じてインスタンスをリサイクルします。サービスは、各インスタンス上で実行されるゲームサーバープロセスのライフサイクルを管理します。マネージド EC2 フリートは、複数の場所にインスタンスを配置して、どこにいてもプレイヤーをサポートできます。

config.yaml ファイルを編集して、ログ記録、ポート設定、サーバー初期化用のラッパーを設定します。

設定例:

log-config:
  wrapper-log-level: debug
game-server-logs-dir: ./game-server-logs
ports:
  gamePort: 37016
game-server-details:
  executable-file-path: ./MyGame/my-server-executable
game-server-args:
  - arg: "--port"
    val: "{{.gameport}}"
    pos: 0
        

ステップ 4: ゲームサーバービルドをアップロードする

これで、ゲームサーバービルドに必要なすべての要素 (ゲームサーバーラッパー、config.yaml、ゲームサーバーファイル) が完了し、ホスティングのためにゲームビルドを Amazon GameLift Servers にアップロードする準備が整いました。ゲームビルドをアップロードする最も簡単な方法は、次の例に示すように AWS CLI コマンド upload-build を使用することです。

Windows でのゲームビルドのアップロード:

aws gamelift upload-build \
    --name gamelift-test-2025-03-11-1 \
    --build-version gamelift-test-2025-03-11-1 \
    --build-root out/windows/amd64/gamelift-servers-managed-ec2 \
    --operating-system WINDOWS_2022 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

ビルドを作成するときは、API レスポンスからビルド ID を記録して、フリートの作成に使用します。

ステップ 5: マネージド EC2 フリートを作成する

次のステップでは、最小限のフリート設定について説明します。これにより、できるだけ早く起動して実行できます。

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

ステップ 6: ゲームセッションを作成して接続する

フリートのステータスがアクティブの場合、ゲームサーバーの準備が整い、ゲームセッションのホストを待っていることを意味します。ゲームセッションを開始するには、Amazon GameLift Servers サービスにゲームセッションリクエストを行います。ここでは、AWS CLI を使用してこのリクエストを行います。

以下を使用してゲームセッションを作成します。

aws gamelift create-game-session \
--fleet-id <FLEET_ID> \
--game-properties '[{"Key": "exampleProperty", "Value": "exampleValue"}]' \
--maximum-player-session-count 3 \
--region us-west-2
        

カスタマイズされたゲームプロパティをサーバー実行可能ファイルに渡すこともできます。詳細については、README のゲームサーバー引数を参照してください。create-game-session 呼び出しを受信すると、Amazon GameLift Servers はラッパーに通知してゲームサーバー実行可能ファイルを起動し、ゲームセッションを開始します。config.yaml の内容はゲームサーバーの設定に影響し、コンソールで設定される起動パラメータによってゲームセッション自体の設定が決まります。

ゲームプロパティを追加するための形式例:

defaultArgs:
        - arg: "--port"
          val: "{{.GamePort}}"
          pos: 0
        - arg: "--ipAddress"
          val: "{{.IpAddress}}"
          pos: 1
        - arg: "--gameSessionId"
          val: "{{.GameSessionId}}"
          pos: 2
        

ステップ 7: フリートを管理およびモニタリングする

ゲームサーバーフリートが設定され、ゲームセッションが開始されたので、Amazon GameLift Servers コンソールから管理およびモニタリングできます。これを実現する最善の方法は、フリートの詳細ページから、フリートの詳細を編集したり、[スケーリング] タブでフリートのスケーリングと容量を変更したりできます。ゲームサーバーのスケーリングについては、次のセクションを参照してください。

[メトリクス] タブを選択すると、アクティビティメトリクスとハードウェアメトリクスのモニタリングを示すグラフが表示されます。メトリクスグラフの詳細については、フリートの ID の横にある [情報] リンクを選択します。さらに、[メトリクス] タブからゲームサーバーを注意深くモニタリングできますが、CloudWatch ダッシュボードでこれらのメトリクスにアラームを追加することもできます。

コンソールから CloudWatch ダッシュボードに移動するには:

ステップ 8: ゲームサーバーをスケールする

次のステップでは、自動スケーリングを設定します。自動スケーリングでは、ゲームサーバーのアクティビティに応じてフリートキャパシティを動的に調整します。自動スケーリングでは、ゲームセッションを開始するプレイヤーが増えるとインスタンスを追加し、プレイヤーが減ると未使用のインスタンスを解放できます。自動スケーリングは、スムーズで高速なプレイヤー体験を提供しながら、ホスティングリソースとコストを最小限に抑える効果的な方法です。

ゲームの起動を準備するときは、フリートの自動スケーリングを設定する必要があります。自動スケーリングは、スムーズで高速なプレイヤー体験を提供しながら、ホスティングリソースとコストを最小限に抑える効果的な方法です。

フリートの容量を手動で設定するには

フリートの容量を手動で設定するには

ターゲットベースの自動スケーリングを使用するには

ターゲットベースの自動スケーリングを使用するには

ターゲットベースの自動スケーリング (ターゲット追跡) は、フリートスケーリングを利用可能なゲームセッションの割合にリンクします。プレイヤーがゲームプレイを急増し、利用可能なゲームセッションが減少すると、フリートに自動的にインスタンスを追加することで応答します。

ルールベースの自動スケーリングにより、スケーリングを他のフリートメトリクスにリンクし、カスタムしきい値とスケーリングレスポンスを設定する機能など、よりきめ細かい制御が可能になります。強力なオプションを提供しますが、カスタムルールの動作を理解するには、CLI の使用と十分なテストが必要です。このチュートリアルでは、最初にターゲットベースのアプローチを設定することに重点を置いています。

一般的な問題のトラブルシューティング

ゲームサーバーとゲームセッションの実行中に発生する可能性がある一般的な問題は次のとおりです。サーバーまたはゲームセッションのいずれかが正しく動作していない場合、最初のステップはログを確認することです。ログには、新規デプロイや本番環境でのゲームで、以下に示す問題のいずれかが明らかになることがあります。

ログには多くの場合、次の内容が表示されます。

Amazon GameLift Servers フリートのイベントログを表示するには

Amazon GameLift Servers フリートのイベントログを表示するには

ゲームセッションログを表示するには

ゲームセッションログを表示するには

CLI でゲームセッションログを表示するには、GetGameSessionLogURL API を使用します。Amazon GameLift Servers はログを14 日間自動的に保存します。

フリートの Amazon CloudWatch logsを設定することもできます。これにより、追加のログ記録機能と他の AWS モニタリングサービスとの統合が提供されます。

CloudWatch を介したリアルタイムログアクセスまたは延長保持期間の場合:

次のステップ