Amazon GameLift エージェントの操作 - Amazon GameLift
エージェントについて

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

Amazon GameLift エージェントの操作

Amazon GameLift エージェントは、Amazon GameLift フリートでのゲームサーバープロセスの実行を監督します。エージェントはフリート内の各コンピューティングにデプロイされ、コンピューティングの自動プロセス管理、ホスティング管理、ログ記録を提供します。エージェントを使用するには、ゲームサーバービルドを Amazon GameLift サーバー 5.x SDK 以降と統合する必要があります。

Amazon GameLift Agent は、マネージド GameLift フリートではない Amazon EC2フリートで外部から使用できます。（マネージドEC2フリートはエージェントのタスクを自動的に処理します）。エージェントの有無にかかわらず、Anywhere GameLift フリートを含む Amazon フリートを実行できます。エージェントなしでは、必要なタスクを完了するための代替ソリューションを提供する必要があります。

コンピューティングにデプロイする場合、ゲームサーバープロセスを開始する前に Amazon GameLift エージェントを起動する必要があります。起動時に、エージェントは次のタスクを完了します。

  • コンピューティングを Amazon に登録します GameLift Anywhere を使用するフリートRegisterComputeAPI。

  • を呼び出しGetComputeAuthTokenAPIて認証トークンを取得し、コンピューティングで実行されているサーバープロセスで使用できるように保存します。

  • コンピューティングの環境変数を設定し WebSocket URL、Amazon GameLift サービス WebSocket への接続を確立します。

  • Amazon GameLift サービスからフリートのランタイム設定の最新バージョンをリクエストします。

  • ランタイム設定手順に従って、サーバープロセスを開始および停止します。

Amazon GameLift Agent のソースコードとビルド手順は、Amazon GameLift Agent GitHubで入手できます。

エージェントについて

Amazon GameLift エージェントは、フリートの次のタスクを処理するように設計されています。

プロセス管理

  • ランタイム手順で定義されているように、新しいサーバープロセスを開始します。エージェントは、エージェントにデプロイされたカスタムランタイム設定を使用する場合があります。または、フリート定義RuntimeConfigurationの一部として を指定することもできます。このアプローチには、フリートのランタイム設定をいつでも変更できるという利点があります。エージェントは、Amazon GameLift サービスから更新されたランタイム設定を定期的にリクエストします。

  • サーバープロセスのアクティベーションをモニタリングし、時間内にアクティブ化されない場合はプロセスを終了させます。

  • Amazon にハートビートを送信します GameLift。エージェントがハートビートを送信できない場合、コンピューティングは古くなっているとマークされる可能性があります。

  • サーバープロセスが終了した GameLift ら Amazon に報告します。Amazon GameLift は、この情報を使用して、ゲームセッション配置のゲームサーバーの可用性をモニタリングします。

  • 以下を含むサーバープロセスのフリートイベントを出力します。

    • SERVER_PROCESS_INVALID_PATH: ゲームサーバープロセスの起動パラメータが正しく設定されていません。

    • SERVER_PROCESS_TERMINATED_UNHEALTHY: ゲームサーバープロセスは、アクティブ化されてから 3 分以内に有効なヘルスチェックを報告しなかったため、終了しました。

    • SERVER_PROCESS_FORCE_TERMINATED: ゲームサーバープロセスは、 OnProcessTerminate() が 30 秒以内に送信された後、クリーンに終了しませんでした。

    • SERVER_PROCESS_CRASHED: ゲームサーバープロセスが何らかの理由でクラッシュしました。

コンピューティング管理

  • Amazon GameLift サービスからメッセージを受信して、コンピューティングをシャットダウンします。

  • Amazon によって終了されるコンピューティングをプロンプトします GameLift。

ログ記録

  • AWS アカウントの Amazon S3 バケットにログをアップロードします。