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.

Tutorial: Schnelles Onboarding mit dem Wrapper Amazon GameLift Servers

Willkommen zum Onboarding-Tutorial fürAmazon GameLift Servers. In diesem Tutorial stellen Sie Ihren Spieleserver schnell bereit, sodass er auf einer Flotte von Cloud-basierten Rechenressourcen gehostet wird. Verwenden Sie dieses Tutorial, um die Arbeit der Integration des Server-SDK für Amazon GameLift Servers in Ihren Spielcode zu überspringen und stattdessen Ihr Spiel mit den minimalen Funktionen bereitzustellen, um mit dem Amazon GameLift Servers Dienst zu kommunizieren und Spielsitzungen durchzuführen. Du richtest eine grundlegende Hosting-Lösung ein und nutzt sie, um alle Funktionen wie automatische Skalierung und Spielersuche zu nutzen. Es ist auch eine großartige Möglichkeit, einen Prototyp Ihres Spiels als Teil einer Live-Demo oder zum Testen zu hosten.

Die wichtigsten Vorteile dieser Onboarding-Methode:

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

Übersicht

In diesem Tutorial wirst du:

Schritt 1: Holen Sie sich den Gameserver-Wrapper und bauen Sie ihn

Verwenden Sie die folgenden Befehle, um die Quelle des Gameserver-Wrappers abzurufen und den Wrapper zu erstellen. Diese Befehle verwenden SSH, aber du kannst auch direkt zum Github-Repository gehen.

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 und Linux

$ git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
$ cd amazon-gamelift-servers-game-server-wrapper
$ make
            

Bei einem erfolgreichen Build wird ein Out-Verzeichnis hinzugefügtamazon-gamelift-servers-game-server-wrapper. In diesem Verzeichnis befinden sich drei Ordner, einer für jede unterstützte Hosting-Flottenoption, die eine Reihe von Build-Artefakten enthalten. In diesem Tutorial führen Sie die Bereitstellung auf verwalteten EC2 Flotten durch, sodass Sie den Ordner gamelift-servers-managed-ec2 verwenden.

Schritt 2: Bereite deinen Gameserver-Build vor

In diesem Schritt bereiten Sie die Build-Dateien Ihres Spieleservers für das Hochladen auf den Amazon GameLift Servers vor.

Erstelle das Spielverzeichnis

Bereite jetzt ein Spielverzeichnis auf deinem lokalen Computer vor. Dieses Verzeichnis muss alle Dateien enthalten, mit denen du deinen Spieleserver ausführen musstAmazon GameLift Servers. Dazu gehören der Gameserver-Wrapper, dein Gameserver-Build und die Datei config.yaml, die dafür sorgt, dass der Wrapper mit deinem Gameserver funktioniert.

Gehen Sie dazu wie folgt vor:

Ein Beispiel für eine Verzeichnisstruktur sieht wie folgt aus:

gamelift-servers-managed-ec2
│-- config.yaml
│-- amazon-gamelift-servers-game-server-wrapper
│-- MyGame
│   │-- server-executable.exe
│   │-- my-game-settings
│   │ ......
            

Schritt 3: Konfigurieren Sie den Wrapper für Ihre Flotte

Amazon GameLift Serversverwaltet den Lebenszyklus der Recheninstanzen einer Flotte, indem neue Instances mit Ihrem installierten Server-Build eingerichtet und Instances nach Bedarf recycelt werden. Der Dienst verwaltet den Prozesslebenszyklus des Spieleservers, der auf jeder Instanz ausgeführt wird. Eine verwaltete EC2 Flotte kann Instanzen an mehreren Standorten haben, um Spieler zu unterstützen, wo auch immer sie sich befinden.

Bearbeiten Sie die Datei config.yaml, um den Wrapper für die Protokollierung, Porteinrichtung und Serverinitialisierung zu konfigurieren.

Beispielkonfiguration:

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
        

Schritt 4: Lade den Spielserver-Build hoch

Du hast jetzt alle erforderlichen Elemente deines Gameserver-Builds abgeschlossen (Gameserver-Wrapper, config.yaml und deine Gameserverdateien) und bist bereit, deinen Game-Build zum Hosten hochzuladen. Amazon GameLift Servers Am schnellsten kannst du deinen Game-Build hochladen, indem du den AWS CLI Befehl verwendest, upload-build wie im folgenden Beispiel gezeigt.

Einen Game-Build mit Windows hochladen:

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
        

Wenn Sie den Build erstellen, notieren Sie sich die Build-ID aus der API-Antwort, um sie für die Flottenerstellung zu verwenden.

Schritt 5: Erstellen Sie die verwaltete EC2 Flotte

Die folgenden Schritte beschreiben eine minimale Flottenkonfiguration, damit Sie so schnell wie möglich einsatzbereit sind.

So erstellen Sie Ihre Flotte:

Schritt 6: Erstelle eine Spielsitzung und stelle eine Verbindung zu ihr her

Wenn dein Flottenstatus Aktiv anzeigt, bedeutet das, dass die Spieleserver bereit sind und darauf warten, eine Spielsitzung zu veranstalten. Um eine Spielsitzung zu starten, stellen Sie eine Anfrage für eine Spielsitzung an den Amazon GameLift Servers Dienst. Hier verwenden Sie den, AWS CLI um diese Anfrage zu stellen.

Verwenden Sie Folgendes, um eine Spielsitzung zu erstellen:

aws gamelift create-game-session \
--fleet-id <FLEET_ID> \
--game-properties '[{"Key": "exampleProperty", "Value": "exampleValue"}]' \
--maximum-player-session-count 3 \
--region us-west-2
        

Sie können auch benutzerdefinierte Spieleigenschaften an Ihre ausführbare Serverdatei übergeben. Weitere Informationen finden Sie in der README-Datei unter Gameserver-Argumente. Wenn er den create-game-session Aufruf erhält, Amazon GameLift Servers informieren sie den Wrapper, die ausführbare Datei des Spieleservers zu starten und eine Spielsitzung zu starten. Was darin enthalten ist, config.yaml wirkt sich auf die Konfiguration des Spielservers aus, und die Startparameter, die in der Konsole festgelegt sind, bestimmen die Konfiguration der Spielsitzung selbst.

Beispielformat für das Hinzufügen von Spieleigenschaften:

defaultArgs:
        - arg: "--port"
          val: "{{.GamePort}}"
          pos: 0
        - arg: "--ipAddress"
          val: "{{.IpAddress}}"
          pos: 1
        - arg: "--gameSessionId"
          val: "{{.GameSessionId}}"
          pos: 2
        

Schritt 7: Verwalte und überwache deine Flotte

Nun, da deine Spieleserver-Flotte eingerichtet und eine Spielsitzung gestartet wurde, kannst du sie von der Amazon GameLift Servers Konsole aus verwalten und überwachen. Das geht am besten über die Seite mit den Flottendetails, auf der du die Flottendetails bearbeiten oder die Flottenskalierung und Kapazität auf der Registerkarte Skalierung ändern kannst. Im folgenden Abschnitt findest du Informationen zur Skalierung deiner Spieleserver.

Wähle den Tab Metriken, um dir Diagramme anzusehen, die die Überwachung von Aktivitäts- und Hardwaremetriken darstellen. Weitere Informationen zu den Metrikdiagrammen erhalten Sie, wenn Sie auf den Link Info neben der ID Ihrer Flotte klicken. Zusätzlich kannst du deine Spieleserver über den Tab „Metriken“ genau überwachen, aber du kannst diesen Metriken im CloudWatch Dashboard auch Alarme hinzufügen.

So navigierst du von der Konsole aus zum CloudWatch Dashboard:

Schritt 8: Skalieren Sie Ihre Spieleserver

Im nächsten Schritt richten Sie Auto Scaling ein. Mit Auto Scaling skalieren Sie Ihre Flottenkapazität dynamisch als Reaktion auf die Aktivität des Spieleservers. Wenn Spieler ankommen und Spielsitzungen starten, fügt Auto Scaling weitere Instanzen hinzu, und wenn die Nachfrage der Spieler sinkt, werden durch Auto Scaling ungenutzte Instanzen freigegeben. Dies ist eine effektive Methode, um Ihre Hosting-Ressourcen und -Kosten zu minimieren und gleichzeitig ein reibungsloses, schnelles Spielerlebnis zu bieten.

Während du dich auf den Start des Spiels vorbereitest, solltest du die auto Skalierung für deine Flotten einrichten. Auto Scaling wird als effektive Methode empfohlen, um deine Hosting-Ressourcen und -Kosten zu minimieren und gleichzeitig ein reibungsloses, schnelles Spielerlebnis zu bieten.

Um die Flottenkapazität manuell einzurichten

Um die Flottenkapazität manuell einzurichten

So verwenden Sie zielbasiertes Auto Scaling

So verwenden Sie zielbasiertes Auto Scaling

Zielbasiertes Autoscaling (Target Tracking) verknüpft die Flottenskalierung mit dem Prozentsatz der verfügbaren Spielsitzungen. Wenn Spieler dein Spiel schnell spielen und die Anzahl der verfügbaren Spielsitzungen abnimmt, reagiert das System, indem es automatisch weitere Instanzen zur Flotte hinzufügt.

Regelbasierte auto Skalierung bietet Ihnen eine detailliertere Steuerung, z. B. die Möglichkeit, die Skalierung mit anderen Flottenkennzahlen zu verknüpfen und benutzerdefinierte Schwellenwerte und Skalierungsreaktionen festzulegen. Es bietet leistungsstarke Optionen, erfordert aber auch die Verwendung der CLI und umfangreiche Tests, um zu verstehen, wie sich benutzerdefinierte Regeln in Aktion verhalten. Dieses Tutorial konzentriert sich auf die erste Einrichtung des zielbasierten Ansatzes.

Beheben Sie häufig auftretende Probleme

Im Folgenden finden Sie häufig auftretende Probleme, die beim Ausführen Ihrer Spieleserver und Spielsitzungen auftreten können. Wenn entweder der Server oder die Spielsitzung nicht richtig laufen, besteht der erste Schritt darin, die Protokolle zu überprüfen, die eines der unten beschriebenen Probleme bei neuen Bereitstellungen oder Spielen in der Produktion aufdecken können.

Folgendes wird häufig in den Protokollen aufgedeckt:

Um die Ereignisprotokolle für Ihre Amazon GameLift Servers Flotte einzusehen

Um die Ereignisprotokolle für Ihre Amazon GameLift Servers Flotte einzusehen

Um Spielsitzungsprotokolle einzusehen

Um Spielsitzungsprotokolle einzusehen

Verwenden Sie die GetGameSessionLogURL API, um Spielsitzungsprotokolle mit der CLI anzuzeigen. Amazon GameLift Serversspeichert die Protokolle automatisch für 14 Tage.

Sie können auch CloudWatch Amazon-Logs für Ihre Flotte konfigurieren. Dies bietet zusätzliche Protokollierungsfunktionen und die Integration mit anderen AWS Überwachungsdiensten.

Für den Zugriff auf Protokolle in Echtzeit oder für längere Aufbewahrungsfristen durch CloudWatch:

Nächste Schritte