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 Amazon-Server GameLift Hülle

Willkommen zum Onboarding-Tutorial für. Amazon GameLift Servers In diesem Tutorial stellst du deinen Spieleserver schnell so ein, dass er auf einer Flotte von Cloud-basierten Rechenressourcen gehostet wird. Nutze dieses Tutorial, um die Integration des Server-SDK für Amazon GameLift Servers in deinen Spielcode zu überspringen und dein Spiel stattdessen 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 den vollen Funktionsumfang wie automatische Skalierung und Matchmaking zu nutzen. Es ist auch eine großartige Möglichkeit, einen Prototyp deines Spiels als Teil einer Live-Demo oder zum Testen zu hosten.

Die wichtigsten Vorteile dieser Onboarding-Methode:

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:

-Übersicht

In diesem Tutorial wirst du:

Schritt 1: Hol dir den Gameserver-Wrapper und baue ihn

Verwende die folgenden Befehle, um die Quelle des Spielserver-Wrappers abzurufen und den Wrapper zu erstellen. Diese Befehle verwenden SSH, du kannst aber auch direkt zum GitHub Projektarchiv 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 für verwaltete EC2-Flotten durch, also verwenden Sie den Ordner. gamelift-servers-managed-ec2

Schritt 2: Bereite deinen Gameserver-Build vor

In diesem Schritt bereitest du die Build-Dateien deines Spieleservers für den Upload 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 Sie Ihren Spieleserver ausführen müssenAmazon 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 Spieleserver 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 es neue Instances hochfährt, auf denen Ihr Server-Build installiert ist, und recycelt Instances nach Bedarf. Der Service verwaltet den Prozesslebenszyklus des Spielservers, der auf jeder Instance ausgeführt wird. Eine verwaltete EC2-Flotte kann über Instanzen an mehreren Standorten verfügen, um Spieler zu unterstützen, wo auch immer sie sich befinden.

Bearbeiten Sie die Datei config.yaml, um den Wrapper für Logging, Port-Setup 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 Gameserver-Build hoch

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

Einen Spiel-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_2022 \
    --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 sein können.

So erstellen Sie Ihre Flotte:

Schritt 6: Erstelle eine Spielsitzung und verbinde dich mit ihr

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

Nutze 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 die Programmdatei Ihres Servers übergeben. Einzelheiten finden Sie in den Argumenten für Spieleserver in der README-Datei. Wenn der Wrapper den Aufruf create-game-session erhält, Amazon GameLift Servers informiert es den Wrapper, die Programmdatei des Spielservers 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 eingestellt 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

Jetzt, da deine Spieleserverflotte eingerichtet und eine Spielsitzung gestartet ist, kannst du sie von der Amazon GameLift Servers Konsole aus verwalten und überwachen. Das erreichst du am besten auf der Seite mit den Flottendetails, auf der du die Flottendetails bearbeiten oder die Flottenskalierung und Kapazität auf dem Tab Skalierung ändern kannst. Im folgenden Abschnitt erfährst du mehr über die Skalierung deiner Spielserver.

Wähle den Tab „Metriken“, um Grafiken anzuzeigen, 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. Außerdem kannst du deine Spieleserver im Reiter „Metriken“ genau überwachen, aber du kannst diesen Messwerten im CloudWatch Dashboard auch Alarme hinzufügen.

So navigierst du von der Konsole aus zum CloudWatch Dashboard:

Schritt 8: Skalieren Sie Ihre Spieleserver

Für den nächsten Schritt richtest du die automatische Skalierung ein. Mit Auto Scaling skalierst du deine Flottenkapazität dynamisch als Reaktion auf die Aktivität des Spielservers. Wenn Spieler ankommen und Spielsitzungen starten, fügt Auto Scaling weitere Instanzen hinzu, und wenn die Nachfrage der Spieler sinkt, gibt Auto Scaling ungenutzte Instanzen frei. 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 automatische Skalierung für deine Flotten einrichten. Die automatische Skalierung 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

Um die zielbasierte automatische Skalierung zu verwenden

Um die zielbasierte automatische Skalierung zu verwenden

Target-based Autoscaling (Zielverfolgung) verknüpft die Flottenskalierung mit dem Prozentsatz der verfügbaren Spielsitzungen. Wenn die Anzahl der Spieler dazu drängt, dein Spiel zu spielen, und die Anzahl der verfügbaren Spielsitzungen abnimmt, reagiert das System, indem es der Flotte automatisch weitere Instanzen hinzufügt.

Rule-based Auto Scaling 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 zielorientierten Ansatzes.

Beheben Sie häufig auftretende Probleme

Die folgenden Probleme können häufig auftreten, wenn Sie Ihre Spieleserver und Spielsitzungen in Betrieb nehmen. Wenn entweder der Server oder die Spielsitzung nicht richtig läuft, ist der erste Schritt, die Protokolle zu überprüfen, die möglicherweise eines der unten beschriebenen Probleme bei neuen Bereitstellungen oder Spielen in der Produktion aufdecken.

In den Protokollen wird häufig Folgendes enthüllt:

Um die Ereignisprotokolle für Ihre einzusehen GameLift Amazon-Server Flotte

Um die Event-Logs für Ihre Amazon GameLift Servers Flotte einzusehen

Um die Protokolle der Spielsitzungen einzusehen

Um Spielsitzungsprotokolle einzusehen

Verwenden Sie die GetGameSessionLogURL API, um die Sitzungsprotokolle des Spiels 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 Logs in Echtzeit oder für längere Aufbewahrungsfristen durch CloudWatch:

Nächste Schritte