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

# Amazon GameLift Servers マネージドコンテナでホスティングするための開発ロードマップ
<a name="gamelift-roadmap-containers"></a>

このロードマップでは、コンテナ化されたゲームサーバー用の Amazon GameLift Servers マネージドホスティングソリューションを開発する方法を説明します。マネージドコンテナは、Amazon GameLift Servers が提供するホスティングソリューションの 1 つにすぎません。ホスティングオプションの詳細については、「[Amazon GameLift Servers ゲームホスティングオプション](gamelift-intro-flavors.md)」を参照してください。

Amazon GameLift Servers を使用したマネージドコンテナソリューションには、次のコンポーネントがあります。
+ ゲームサーバービルドを含むコンテナイメージを、Amazon Elastic Container Registry (Amazon ECR) のプライベートリポジトリにアップロードします。ゲームサーバービルドは、サーバー SDK for Amazon GameLift Servers と統合され、Linux で動作するように構築されています。
+ ゲームクライアントに代わって Amazon GameLift Servers サービスとやり取りするバックエンドサービス。バックエンドサービスは、 AWS SDK の一部である Amazon GameLift Servers 用サービス API の機能を使用します。
+ 新しい Amazon GameLift Servers ゲームセッションのリクエストを処理し、すべてのフリートで利用可能なサーバーを検索し、ゲームセッションを開始するようにゲームサーバーを促すゲームセッションキュー、またはその他の配置メカニズム。
+ (オプション) マルチプレイヤーマッチを作成し、マッチのゲームセッションを立ち上げる FlexMatch マッチメーカー。
+ Amazon Elastic Compute Cloud (Amazon EC2) インスタンスを使用し、マルチプレイヤーゲームホスティング向けに最適化された 1 つ以上のコンテナフリート。

このロードマップは、コンテナ化されたゲームサーバーを Amazon GameLift Servers マネージドコンテナで正常に稼働させるための効率的な手順を示します。必要なコンポーネントが揃ったら、ゲーム開発を繰り返し、ホスティングソリューションをカスタマイズできます。ローンチが近づいたら、本番稼働レベルの使用に備えてホスティングソリューションを準備する方法について、「[Amazon GameLift Servers ホスティングによる起動の準備](gamelift_quickstart_customservers_checklist.md)」を参照してください。

**マネージドコンテナ用のこれらのツールを使用して、オンボーディングを高速化します。**  
[コンテナスターターキット](https://github.com/aws/amazon-gamelift-toolkit/tree/main/containers-starter-kit)は、統合とフリートのセットアップを合理化します。ゲームサーバーに重要なゲームセッション管理機能を追加し、事前設定されたテンプレートを使用して、ゲームサーバー用のコンテナフリートと自動デプロイパイプラインを構築します。デプロイ後、Amazon GameLift Servers コンソールと API ツールを使用して、フリートのパフォーマンスのモニタリング、ゲームセッションの管理、メトリクスの分析を行います。
Unreal Engine および Unity の開発者は、[Amazon GameLift Servers プラグイン](https://github.com/amazon-gamelift/)を使用してゲームサーバーを統合し、ゲームエンジンの開発環境内からコンテナフリートを構築できます。プラグインのガイド付きワークフローは、マネージドコンテナを使用したクラウドベースのホスティングによる高速でシンプルなソリューションの作成に役立ちます。この基盤をもとに、ゲーム用のカスタムホスティングソリューションを作成できます。

## ステップ 1: Amazon GameLift Servers を使用するためのゲームサーバーを準備する
<a name="gamelift-roadmap-containers-step1"></a>

ゲームサーバーに機能を追加して、ホスティング用にデプロイされたときに Amazon GameLift Servers サービスと通信できるようにします。
+ **ゲームプロジェクト用に SDK for Amazon GameLift Servers (バージョン 5.2 以上) を取得します。**サーバー SDK は、C\$1\$1、C\$1、Go で利用可能です。[サーバー SDK for Amazon GameLift Servers をダウンロードします](https://aws.amazon.com/gamelift/servers/getting-started-sdks/)。サーバー SDK は、C\$1\$1、C\$1、Go で利用可能です。
+ **ゲームサーバーコードを変更して、サーバーの SDK 機能を追加します。**ガイダンスについては、「[Amazon GameLift Serversでホストするゲームを準備します](integration-intro.md)」を参照してください。少なくとも、以下を実行します。
  + Amazon GameLift Servers SDK を初期化するコードを追加し、Amazon GameLift Servers サービスとの WebSocket 接続を確立します。サーバー SDK アクション `InitSdk()` を使用します。
  + サーバープロセスがゲームセッションをホストする準備ができたことを Amazon GameLift Servers サービスに報告するコードを追加します。サーバー SDK アクション `ProcessReady()` を使用します。
  + 必要なコールバック関数 `OnStartGameSession()`、および `OnProcessTerminate()` を実装します。これらの関数を使用することで、ゲームサーバープロセスは Amazon GameLift Servers サービスとの接続を維持し、Amazon GameLift Servers からの指示によりゲームセッションを開始し、ゲームサーバープロセスを終了するプロンプトに応答できます。
  + サーバープロセスがゲームセッションを終了することを Amazon GameLift Servers サービスに報告するコードを追加します。サーバー SDK アクション `ProcessEnding()` を使用します。
+ **ゲームサーバービルドをパッケージ化します。**Linux で実行するようにゲームサーバーを構築します。ゲームサーバーの実行に必要なビルドやその他のファイルを準備します。Windows で開発している場合、このステップでは、別の Linux ワークスペースを設定するか、Windows サブシステム for Linux (WSL) などのツールを使用する場合があります。ゲームサーバーの構築をテストしたり、コンテナイメージを構築およびテストしたりするには、Linux 環境が必要です。
+ **ゲームサーバーの統合をテストします。**統合されたゲームサーバーが Amazon GameLift Servers サービスに接続し、プロンプトに応答できることを確認します。「[Amazon GameLift Servers Anywhereでローカルテストを設定する](integration-testing.md)」で説明されているように、ローカルワークステーションをテストホストとしてシンプルな Amazon GameLift Servers Anywhere フリートを設定することをお勧めします。ゲームサーバービルドをテストホストにインストールし、サーバープロセスを開始します。 AWS CLI を使用して新しいゲームセッションをリクエストし、Amazon GameLift Serversサービスがサーバープロセスにゲームセッションの開始を正常に促すことを確認します。

## ステップ 2: ゲームサーバーコンテナイメージを作成する
<a name="gamelift-roadmap-containers-step2"></a>

ゲームサーバーを正常に統合したら、ゲームサーバー実行可能ファイルでコンテナイメージを作成します。Amazon GameLift Servers で使用するため、Amazon Elastic Container Registry (Amazon ECR) リポジトリに保存します。詳細な手順については、「[Amazon GameLift Servers 用のコンテナイメージを構築する](containers-prepare-images.md)」を参照してください。
+ **ゲームサーバーコンテナ (Amazon GameLift Servers 提供) の Dockerfile テンプレートを取得します。**ゲームサーバーのビルドファイルの ファイルを変更します。
+ **ゲームサーバーコンテナイメージを構築します。**Linux 環境で作業するには、Docker ツールを使用してイメージを作成します。
+ **コンテナイメージを Amazon ECR にプッシュします。**コンテナフリートをデプロイする予定の AWS リージョン 同じ と を使用して AWS アカウント 、Amazon ECR にパブリックリポジトリまたはプライベートリポジトリを作成します。コンテナイメージをそこにプッシュします。
+ **Anywhere フリートを使用してコンテナイメージをテストします (オプション)。**クラウドホスト型のコンテナフリートにデプロイする前に、コンテナイメージをローカルでテストすることもできます。テストには、既存の Amazon GameLift Servers Anywhere フリートをローカルワークステーションで使用できます。ゲームサーバーコンテナをインストールして実行し、次を確認します。(1) Amazon GameLift Servers サービスがサーバープロセスにゲームセッション開始を正常に促すこと、(2) ゲームクライアントがゲームセッションに接続できること。

## ステップ 3: クラウドクラウドベースのコンテナフリートを作成する
<a name="gamelift-roadmap-containers-step3"></a>

ここまでは、セルフマネージド Anywhere フリートを使用して、ゲームコンポーネントをテストして反復処理してきました。Amazon GameLift Servers 用に統合されたゲームサーバービルドが動作している場合は、本番環境に必要となるクラウドベースの Amazon GameLift Servers マネージドコンテナフリートホスティングリソースのセットアップを開始できます。
+ **コンテナグループ定義の作成。**コンテナグループ定義は、フリートのコンテナアーキテクチャを記述します。 と は、デプロイするコンテナイメージを識別します。「[コンテナフリートAmazon GameLift Servers用のコンテナグループ定義を作成する](containers-create-groups.md)」を参照してください。コンテナイメージが保存され AWS リージョン ているのと同じ にコンテナグループ定義を作成します。フリートのロケーションの選び方については、「[地理的場所](gamelift-compute.md#gamelift-compute-location)」を参照してください。少なくとも、以下を実行します。
  + ゲームサーバーコンテナグループ定義を作成します。
  + ゲームサーバービルドでコンテナイメージを含むコンテナ定義を追加します。
  + コンテナのゲームサーバープロセスのポート範囲を設定します。
+ **マネージドコンテナフリートを作成します。**フリートを作成すると、Amazon GameLift Servers はすぐにホスティング用にゲームサーバービルドのデプロイを開始します。マネージドフリートの多くの側面を設定できます。ガイダンスについては、「[Amazon GameLift Servers マネージドコンテナフリートを作成する](containers-build-fleet.md)」を参照してください。少なくとも、以下を実行します。
  + コンテナフリートの AWS Identity and Access Management (IAM) サービスロールを設定します。「[Amazon GameLift Servers 用に IAM サービスロールをセットアップする](setting-up-role.md)」を参照してください。
  + フリートインスタンスにデプロイするゲームサーバーコンテナグループ定義を指定します。
  + 他のすべてのパラメータで使用できるデフォルト値を使用します。Amazon GameLift Servers は、最適な設定のためにいくつかのパラメータを計算します。
+ **コンテナフリートをキューに追加します。**ゲームセッションキューで、Anywhere テストフリートをマネージドコンテナフリートで置き換えます。
+ **コンテナフリートでゲームホスティングをテストします。**この時点で、ソリューション全体をテストできるはずです。ゲームクライアントを起動し、バックエンドサービスを介してゲームセッションをリクエストします。接続情報を取得し、コンテナフリートのゲームセッションに接続します。
+ **フリートデプロイで反復処理します。**コンテナグループ定義とフリート設定を更新し、既存のフリートに更新をデプロイできます。

## ステップ 4: ホストされたゲームセッションに参加するゲームクライアントを準備する
<a name="gamelift-roadmap-containers-step4"></a>

ゲームクライアントがゲームセッションへの参加をリクエストし、接続情報を取得して、ホストされているゲームセッションに直接接続する方法を作成します。最も一般的なアプローチは、ゲームクライアントと Amazon GameLift Servers サービス間の仲介役として機能するバックエンドサービス機能をセットアップすることです。このアプローチにより、ホスティングリソースを保護し、プレイヤーがゲームセッションにどのように配置されるかをより詳細に制御することができます。
+ **ホスティング用のバックエンドサービス機能を構築します。**バックエンドサービスは Amazon GameLift Servers サービスと通信し、ゲームクライアントに接続情報を送信します。この機能には、ゲームセッションの開始、ゲームへのプレイヤーの配置、ゲームセッション情報の取得が含まれます。ガイダンスについては、「[Amazon GameLift Serversでホストするゲームを準備します](integration-intro.md)」を参照してください。少なくとも、以下を実行します。
  +  AWS SDK for を取得しAmazon GameLift Servers、バックエンドサービスプロジェクトに追加します。「[クライアントサービス用の Amazon GameLift Servers SDK リソース](gamelift-supported.md#gamelift-supported-clients)」を参照してください。
  + Amazon GameLift Servers クライアントを初期化するコードを追加し、キー設定を保存します。「[Amazon GameLift Servers APIをセットアップします。](gamelift-sdk-client-api.md#gamelift-sdk-client-api-initialize)」を参照してください。
  +  AWS SDK アクションを呼び出し`CreateGameSession()`、ゲームクライアントにゲームセッション接続情報を提供する機能を追加します。「[特定のフリートにゲームセッションを作成する](gamelift-sdk-client-api.md#gamelift-sdk-client-api-create)」を参照してください。

    `CreateGameSession()` の呼び出しは、新しいゲームセッションをリクエストする際に便利な出発点となります。ゲームセッション配置システムが整ったら (ステップ 3 を参照)、このコードを `StartGameSessionPlacement()` への呼び出しに置き換えます (`StartMatchmaking()` を使用している場合は FlexMatch)。

    バックエンドサービスを設計する方法については、「[Amazon GameLift Serversのバックエンドサービスを構築する](gamelift_quickstart_customservers_designbackend.md)」を参照してください。
+ **プレイヤーがホストされているゲームセッションに参加できるようにする機能をゲームクライアントに追加します。**ゲームクライアントは、Amazon GameLift Servers に直接リクエストするのではなく、バックエンドサービスにリクエストを行います。バックエンドサービスがゲームセッション接続情報を提供すると、ゲームクライアントはゲームセッションに直接接続してゲームをプレイします。
+ **ゲームクライアントの統合をテストします。**テストには、既存の Amazon GameLift Servers Anywhere フリートをローカルワークステーションで使用できます。新しいバックエンドサービスを使用して新しいゲームセッションをリクエストし、(1) Amazon GameLift Serversサービスがサーバープロセスにゲームセッションの開始を正常に促し、(2) ゲームクライアントがゲームセッションに接続できることを確認します。

## ステップ 5: ゲームセッション配置を設定する
<a name="gamelift-roadmap-containers-step5"></a>

Amazon GameLift Servers が新しいゲームセッションのリクエストをどのように処理し、ホスト可能なゲームサーバーをどのように特定するかをカスタマイズできます。Amazon GameLift Servers は、すべてのフリート内のゲームサーバーの可用性を自動的に追跡します。ゲームクライアントがゲームセッションへの参加リクエストを送信すると、Amazon GameLift Servers は最小レイテンシー、コスト、可用性などの定義された一連の優先順位に基づいて「可能な限り最良の」配置を探します。
+ **利用可能なゲームサーバーで新しいゲームセッションを配置するためのゲームセッションキューを作成します。**キューは、ゲームセッション配置の主要なメカニズムです。ガイダンスについては、「[ゲームセッションキューを作成する](queues-creating.md)」を参照してください。
  + 少なくとも、Anywhere フリートをキュー内の送信先として追加します。その他のすべての設定はオプションのカスタマイズです。
+ **バックエンドサービスコードで、`CreateGameSession()` 呼び出しを `StartGameSessionPlacement()` に変換します。**「[マルチフリートキューにゲームセッションを作成する](gamelift-sdk-client-api.md#gamelift-sdk-client-api-create)」を参照してください。
+ **ゲームセッションに参加できる状態になったら、ゲームクライアントに通知するメカニズムを作成します。**開発中は、`DescribeGameSessionPlacement`を呼び出してゲームセッションのステータスをポーリングできます。ただし、大量の処理にキューを使用する前に、イベント通知を有効にする必要があります。「[ゲームセッション配置のイベント通知を設定](queue-notification.md)」を参照してください。
+ **FlexMatch マッチメーキングを追加します (オプション)。**マッチメーキングルールセットを構築し、ゲームセッションキューを操作するマッチメーキング設定を作成します。マッチメーキングシステムの設定に関するガイダンスについては、「[Amazon GameLift ServersFlexMatchデベロッパーガイド](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-intro.html)」を参照してください。
+ **プレイスメントシステムをテストします。**テストには、既存の Amazon GameLift Servers Anywhere フリートをローカルワークステーションで使用できます。バックエンドサービスを使用して新しいゲームセッションをリクエストし、Amazon GameLift Servers サービスがサーバープロセスにゲームセッションの開始を正常に指示することを確認します。

## ステップ 6: マネージドコンテナソリューションをカスタマイズする
<a name="gamelift-roadmap-containers-step6"></a>

ゲームのローンチに備えて、マネージドホスティングリソースをファインチューニングする必要があります。考慮すべき決定事項には、次のようなものがあります。
+ コンテナフリートの設定を最適化します。「[Amazon GameLift Servers コンテナフリートをカスタマイズする](containers-design-fleet.md)」を参照してください。
+ コスト削減のためにスポットフリートの追加を検討します。「[スポットフリートによるゲームホスティングコストの削減](fleets-spot.md)」を参照してください。
+ ゲームサーバーが他の AWS リソースと通信する必要がある場合は、IAM ロールを設定してアクセスを管理します。「[Amazon GameLift Servers ホストされたゲームサーバーを他の AWS リソースに接続する](gamelift-sdk-server-resources.md)」を参照してください。
+ ゲームサーバーを地理的にどこに配置するかを決定します。マネージドフリートにリモートロケーションを追加します。「[ホスティングリソースのカスタマイズ](fleets-design.md)」を参照してください。
+ 優先順位付け設定のカスタマイズなど、マネージドフリートのゲームセッション配置オプションを試してみます。「[ゲームセッションキューをカスタマイズする](queues-design.md)」を参照してください。
+ 予想されるプレイヤー需要に応えるための自動容量スケーリングを設定します。「[Amazon GameLift Servers を使用したゲームホスティング容量のスケーリング](fleets-manage-capacity.md)」を参照してください。
+ 他の にフリートを作成し AWS リージョン 、必要に応じてフェイルオーバーを処理するようにキューと自動スケーリングを変更します。
+ 分析やログ記録など、ホスティングのオブザーバビリティツールをセットアップします。[Amazon GameLift Servers のモニタリング](monitoring-overview.md)を参照してください。
+ [ Infrastructure as Code (IaC)](https://docs.aws.amazon.com/whitepapers/latest/introduction-devops-aws/infrastructure-as-code.html) を使用して、フリートのデプロイを自動化します。「[を使用してAmazon GameLift Serversホスティングリソースを管理する CloudFormation](resources-cloudformation.md)」を参照してください。

  Amazon GameLift Servers では、デプロイ固有の設定に AWS CloudFormation テンプレートを使用できます。を使用してAmazon GameLift Serversリソース AWS Cloud Development Kit (AWS CDK) を定義することもできます。の詳細については AWS CDK、 [AWS Cloud Development Kit (AWS CDK) デベロッパーガイド](https://docs.aws.amazon.com/cdk/v2/guide/)を参照してください。

   CloudFormation スタックのデプロイを管理するには、継続的インテグレーションおよび継続的デリバリー (CI/CD) ツールと などのサービスを使用することをお勧めします AWS CodePipeline。こうしたツールにより、ゲームサーバーバイナリが構築されるたびに、自動的に、または承認によりデプロイできます。CI/CD ツールまたはサービスを使用すると、新しいゲームサーバーバージョンのリソースのデプロイは次のようになります。
  + ゲームサーバーバイナリをビルドしてテストします。
  + バイナリを Amazon GameLift Servers にアップロードします。
  + 新しいビルドを使用して新しいフリートをデプロイします。
  + ゲームセッションキューに新しいフリートを追加し、以前のビルドバージョンのフリートを削除する。
  + 以前のビルドのフリートがアクティブなゲームセッションをホストしなくなったら、それらのフリートの CloudFormation スタックを削除します。