翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

のオンボーディングチュートリアルへようこそAmazon GameLift Servers。このチュートリアルでは、クラウドベースのコンピューティングリソースのフリートでホストされるようにゲームサーバーを迅速にデプロイします。このチュートリアルを使用して、 サーバー SDK をゲームコードに統合する作業Amazon GameLift Serversをスキップし、代わりに最小限の機能でゲームをデプロイして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のためにゲームビルドを にアップロードする準備が整いました。ゲームビルドをアップロードする最も簡単な方法は、次の例upload-buildに示すように AWS CLI コマンドを使用することです。

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_2016 \
    --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 と重要なテストを使用する必要があります。このチュートリアルでは、最初にターゲットベースのアプローチを設定することに重点を置いています。

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

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

ログには、次の情報が表示されることがよくあります。

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

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

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

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

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

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

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

次のステップ