Arbeite mit dem Amazon GameLift Servers Agenten - Amazon GameLift Servers
Über den Agenten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeite mit dem Amazon GameLift Servers Agenten

Der Amazon GameLift Servers Agent überwacht den Betrieb der Spielserver-Prozesse auf Ihren Amazon GameLift Servers Flotten. Der Agent wird auf jedem Computer in einer Flotte eingesetzt und bietet automatisiertes Prozessmanagement, Hosting-Management und Protokollierung der Rechenleistung. Um den Agenten verwenden zu können, muss dein Spieleserver-Build in das Server-SDK für Amazon GameLift Servers Version 5.x oder höher integriert sein.

Der Amazon GameLift Servers Agent ist extern für Flotten verfügbar, bei denen es sich nicht um verwaltete Amazon GameLift Servers EC2 Flotten handelt. (Verwaltete EC2 Flotten erledigen die Aufgaben des Agenten automatisch.) Sie können sich dafür entscheiden, Amazon GameLift Servers Flotten, einschließlich Anywhere-Flotten, mit oder ohne den Agenten zu betreiben. Ohne den Agenten müssen Sie eine alternative Lösung für die Ausführung der erforderlichen Aufgaben bereitstellen.

Bei der Bereitstellung auf einem Computer sollte der Amazon GameLift Servers Agent gestartet werden, bevor irgendwelche Spielserverprozesse gestartet werden. Beim Start führt der Agent die folgenden Aufgaben aus:

  • Registriert die Rechenleistung mithilfe der RegisterComputeAPI bei einer Amazon GameLift Servers Anywhere-Flotte.

  • Ruft die GetComputeAuthTokenAPI auf, um ein Autorisierungstoken abzurufen, und speichert es zur Verwendung durch Serverprozesse, die auf dem Computer ausgeführt werden.

  • Legt die WebSocket URL-Umgebungsvariable für die Berechnung fest und stellt eine WebSocket Verbindung zum Amazon GameLift Servers Dienst her.

  • Fordert die neueste Version der Laufzeitkonfiguration der Flotte vom Amazon GameLift Servers Service an.

  • Startet und stoppt Serverprozesse gemäß den Anweisungen zur Laufzeitkonfiguration.

Quellcode und Build-Anweisungen für den Amazon GameLift Servers Agenten sind im Amazon GameLift ServersAgent verfügbar GitHub.

Über den Agenten

Der Amazon GameLift Servers Agent ist so konzipiert, dass er die folgenden Aufgaben für Ihre Flotten übernimmt:

Prozessmanagement

  • Startet neue Serverprozesse, wie in den Laufzeitanweisungen definiert. Der Agent verwendet möglicherweise eine benutzerdefinierte Laufzeitkonfiguration, die zusammen mit dem Agenten bereitgestellt wird. Alternativ können Sie eine RuntimeConfiguration als Teil Ihrer Flottendefinition angeben. Dieser Ansatz hat den Vorteil, dass Sie die Laufzeitkonfiguration der Flotte jederzeit ändern können. Der Agent fordert regelmäßig aktualisierte Laufzeitkonfigurationen vom Amazon GameLift Servers Service an.

  • Überwacht die Aktivierungen von Serverprozessen und beendet Prozesse, wenn sie nicht rechtzeitig aktiviert werden.

  • Sendet Heartbeats an. Amazon GameLift Servers Wenn der Agent keine Heartbeats sendet, wird die Rechenleistung möglicherweise als veraltet markiert.

  • Meldet, Amazon GameLift Servers wann ein Serverprozess endet. Amazon GameLift Serversverwendet diese Informationen, um die Verfügbarkeit des Spielservers für die Platzierung von Spielsitzungen zu überwachen.

  • Sendet Flottenereignisse für Serverprozesse aus, darunter:

    • SERVER_PROCESS_INVALID_PATH: Die Startparameter für den Spieleserverprozess waren falsch konfiguriert.

    • SERVER_PROCESS_TERMINATED_UNHEALTHY: Der Spielserver-Prozess hat innerhalb von 3 Minuten nach der Aktivierung keinen gültigen Gesundheitscheck gemeldet und wurde daher beendet.

    • SERVER_PROCESS_FORCE_TERMINATED: Der Spielserver-Prozess wurde nicht ordnungsgemäß beendet, nachdem OnProcessTerminate() er innerhalb von 30 Sekunden gesendet wurde.

    • SERVER_PROCESS_CRASHED: Ein Gameserver-Prozess ist aus irgendeinem Grund abgestürzt.

Computerverwaltung

  • Empfängt Nachrichten vom Amazon GameLift Servers Dienst, um die Rechenleistung herunterzufahren.

  • Fordert auf, die Berechnung zu beenden durchAmazon GameLift Servers.

Protokollierung

  • Lädt Protokolle in einen Amazon S3 S3-Bucket in Ihrem AWS Konto hoch.