Arbeiten Sie mit dem GameLift Amazon-Agenten - Amazon GameLift

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.

Arbeiten Sie mit dem GameLift Amazon-Agenten

Der GameLift Amazon-Agent überwacht die Ausführung der Spielserverprozesse auf Ihren GameLift Amazon-Flotten. Der Agent wird für jeden Computer in einer Flotte eingesetzt und bietet automatisiertes Prozessmanagement, Hosting-Management und Protokollierung der Rechenleistung. Um den Agenten verwenden zu können, muss Ihr Spieleserver-Build in Amazon GameLift Server SDK 5.x oder höher integriert sein.

Der Amazon GameLift Agent ist extern für die Verwendung mit GameLift Amazon-Flotten verfügbar, bei denen es sich nicht um verwaltete EC2 Flotten handelt. (Verwaltete EC2 Flotten erledigen die Aufgaben des Agenten automatisch.) Sie können sich dafür entscheiden, GameLift Amazon-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 Agent gestartet werden, bevor irgendwelche Spieleserverprozesse gestartet werden. Beim Start führt der Agent die folgenden Aufgaben aus:

  • Registriert die Berechnung bei einem Amazon GameLift Anywhere Flotte, die die verwendet RegisterComputeAPI.

  • Ruft das GetComputeAuthTokenAPIauf, 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 GameLift Amazon-Service her.

  • Fordert die neueste Version der Runtime-Konfiguration der Flotte vom GameLift Amazon-Service an.

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

Quellcode und Bauanweisungen für den Amazon GameLift Agent sind im Amazon GameLift Agent verfügbar GitHub.

Über den Agenten

Der Amazon GameLift Agent wurde entwickelt, um die folgenden Aufgaben für Ihre Flotten zu erledigen:

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 GameLift Amazon-Service an.

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

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

  • Meldet Amazon GameLift , wenn ein Serverprozess endet. Amazon GameLift verwendet diese Informationen, um die Verfügbarkeit von Spieleservern 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 GameLift Amazon-Service, um die Datenverarbeitung herunterzufahren.

  • Fordert auf, die Berechnung durch Amazon GameLift zu beenden.

Protokollierung

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