

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.

# Erste Schritte mit Amazon GameLift Servers
<a name="getting-started-intro"></a>

Nutzen Sie diese Ressourcen für die ersten Schritte, um mehr über den Amazon GameLift Servers Service zu erfahren und zu erfahren, wie Sie mit der Entwicklung einer maßgeschneiderten Hosting-Lösung für Ihre sitzungsbasierten Multiplayer-Spiele beginnen können.

## Bevor Sie beginnen
<a name="getting-started-intro-prereq"></a>
+ Erstellen Sie eine AWS-Konto (oder geben Sie eine vorhandene an), mit der Sie es verwenden möchten. Amazon GameLift Servers
+ Richten Sie Benutzer mit Berechtigungen für Amazon GameLift Servers und verwandte AWS Dienste ein.
+ Wählen Sie einen aus AWS-Region , in dem Sie arbeiten möchten. Wählen Sie für die Entwicklung eine Region aus, die sich in der Nähe Ihres Standorts befindet. Sie können die Regionen jederzeit ändern.

[Richten Sie ein AWS Benutzerkonto ein](setting-up-aws-login.md)

## Wähle deinen Weg
<a name="getting-started-intro-paths"></a>

### Ich möchte Amazon GameLift Servers schnell auf Entdeckungsreise gehen
<a name="getting-started-intro-quick"></a>

Ideal für: Lernen, Erstellung eines Machbarkeitsnachweises, Rapid Prototyping

Schnellstartoptionen:
+ [Gameserver-Wrapper für Amazon GameLift Servers](https://github.com/amazon-gamelift/amazon-gamelift-servers-game-server-wrapper/) — siehe[Tutorial: Schnelles Onboarding mit dem Wrapper Amazon GameLift Servers](gamelift-wrapper-tutorial.md). Dieses Tool ist der schnellste und einfachste Weg, deinen Gameserver zu hosten und Spielsitzungen auszuführenAmazon GameLift Servers, ohne dass Änderungen am Spielcode erforderlich sind. Der Gameserver-Wrapper bietet grundlegende Funktionen zur Verwaltung von Spielesitzungen und eine optimierte Bereitstellung von Spieleservern. Er ist ideal für eine praktische Evaluierung der Amazon GameLift Servers Verwendung Ihres eigenen Spielprojekts oder eines Beispielprojekts. Wenn Sie bereit sind, eine benutzerdefinierte Game-Hosting-Lösung zu erstellen, wechseln Sie zu einer der benutzerdefinierten Entwicklungsoptionen mit vollständiger Integration in das Server-SDK fürAmazon GameLift Servers. Wenn dein Spiel keine benutzerdefinierte Hosting-Lösung benötigt, kannst du den Gameserver-Wrapper weiterhin verwenden, um deine Spieleserver in der Produktion bereitzustellen und zu hosten. 
+ [Amazon GameLift ServersPlugin für Unreal Engine oder Unity](getting-started-plugin.md) — Die Plugins bieten dir GUI-Workflows und Beispielressourcen, die dich durch die ersten Schritte führen und deinen Gameserver mit einer einfachen Hosting-Lösung bereitstellen. Verwende das Plugin, um Hosting mit selbstverwalteten Anywhere-Flotten einzurichten oder cloudbasierte, verwaltete EC2-Flotten oder Container-Flotten bereitzustellen. Wenn Sie bereit sind, eine maßgeschneiderte Hosting-Lösung zu entwickeln, können Sie auf Ihren Plugin-Lösungen aufbauen.
+ [Starter-Kit für Amazon GameLift Servers verwaltete Container](https://github.com/aws/amazon-gamelift-toolkit/tree/main/containers-starter-kit) — Dieses Kit vereinfacht die Aufgaben zur Integration eines Spieleservers, zur Vorbereitung eines Gameserver-Container-Images und zur Bereitstellung einer Containerflotte für das Hosting. Für die Integration erweitert das Kit deinen Spieleserver um wichtige Funktionen zur Verwaltung von Spielsitzungen. Das Kit verwendet vorkonfigurierte Vorlagen zum Aufbau einer Containerflotte und einer automatisierten Bereitstellungspipeline für den Spieleserver. Wenn Sie bereit sind, vollständige Funktionen zur Verwaltung von Spielsitzungen hinzuzufügen, folgen Sie einer der benutzerdefinierten Entwicklungs-Roadmaps, für die Sie das Server-SDK für integrieren möchten. Amazon GameLift Servers

### Ich möchte eine maßgeschneiderte Hosting-Lösung erstellen
<a name="getting-started-intro-custom"></a>

Ideal für: Erstellung einer Lösung auf Produktionsebene für einen benutzerdefinierten Spieleserver 

Sehen Sie sich die Seite an [Amazon GameLift ServersHosting-Optionen für Spiele](gamelift-intro-flavors.md) und wählen Sie eine der Optionen für Ihre Lösung aus. Folgen Sie einer dieser Entwicklungs-Roadmaps, um mit der Entwicklung einer maßgeschneiderten Hosting-Lösung mit vollem Funktionsumfang für Ihr Spiel zu beginnen. Die Roadmaps enthalten detaillierte Anleitungen zum Erstellen, Testen und Anpassen der einzelnen Komponenten in Ihrer Hosting-Lösung. 
+ [Entwicklungs-Roadmap für Hosting mit Amazon GameLift Servers verwaltetem EC2](gamelift-roadmap-managed.md)
+ [Entwicklungs-Roadmap für Hosting mit Amazon GameLift Servers verwalteten Containern](gamelift-roadmap-containers.md)
+ [Entwicklungs-Roadmap für Hosting mit Anywhere Amazon GameLift Servers](gamelift-roadmap-anywhere.md)
+ [Entwicklungs-Roadmap für Hybrid-Hosting mit Amazon GameLift Servers](gamelift-roadmap-hybrid.md)

## Empfohlener Lernpfad
<a name="getting-started-intro-recommended"></a>

1. Fangen Sie klein an. Probiere den Gameserver-Wrapper oder das Plugin für Unreal aus. 

1. Verstehe die Konzepte. Überprüfe die Seite[So Amazon GameLift Servers funktioniert das Hosten mit](gamelift-howitworks.md).

1. Wählen Sie Architektur. Wählen Sie Ihr Hosting-Modell basierend auf den Anforderungen Ihres Spiels aus.

1. Baue und teste. Folgen Sie der entsprechenden Entwicklungs-Roadmap. Erstellen Sie für jede Komponente eine Basisversion, iterieren Sie sie und passen Sie sie an.

1. Skalieren und optimieren. Optimieren Sie Ihre Lösung für den Einsatz auf Produktionsebene. Fügen Sie erweiterte Funktionen wie Matchmaking hinzu.

# Richten Sie ein AWS Benutzerkonto ein
<a name="setting-up-aws-login"></a>

**Tipp**  
Verwenden Sie diese Themen, um Hilfe bei diesen Aufgaben zu erhalten:   
Holen Sie sich ein neues AWS-Konto zur Verwendung mitAmazon GameLift Servers.
Erstellen Sie einen Benutzer oder eine Gruppe mit Berechtigungen zum Arbeiten mit Amazon GameLift Servers Ressourcen.
Richten Sie Sicherheitsanmeldedaten ein (Sie benötigen diese, um die AWS CLI Tools und Amazon GameLift Servers Plugins für Unreal und Unity zu verwenden)


Wie bei allen AWS Diensten benötigen Sie eine, AWS-Konto um den Amazon GameLift Servers Dienst und die Tools nutzen zu können. An AWS-Konto erfüllt zwei Hauptfunktionen: (1) Es bietet Ihnen einen Container für alle AWS Ressourcen, die Sie mit dem Konto erstellen, und (2) es ermöglicht Ihnen, die Sicherheit Ihrer AWS Ressourcen zu verwalten, einschließlich der Einrichtung der Benutzerauthentifizierung und der Kontrolle der Benutzerzugriffsberechtigungen. Die Erstellung eines ist kostenlos AWS-Konto. 

**Erkunden Sie Amazon GameLift Servers mit oder ohne AWS Konto**  
Du **benötigst kein** AWS Konto für:
+ Entdecke AWS Tools zum Erstellen, Ausführen und Erweitern von Spielerlebnissen bei [AWS for Games](https://aws.amazon.com/gametech/). Lesen Sie den [Blog](https://aws.amazon.com/blogs/gametech/) und stöbern Sie in der [Solutions for Games-Bibliothek](https://aws.amazon.com/solutions/games).
+ Weitere Informationen finden Sie Amazon GameLift Servers in der [Produktübersicht und in den Ressourcen](https://aws.amazon.com/gamelift/). FAQs **Fragen** Sie AWS nach Antworten auf Ihre Produktfragen. (Versuche es mit diesem Beispiel: „Ich suche nach kostengünstigen Optionen, um mein Multiplayer-Spiel zu hosten“.)
+ Weitere Informationen finden Sie in der [technischen Dokumentation](https://docs.aws.amazon.com/gamelift/), einschließlich Entwicklerhandbüchern für Hosting und Matchmaking sowie dem Referenzhandbuch zur Service-API. Amazon GameLift Servers
+ Informieren Sie sich über Techniken zur [Amazon GameLift ServersPreisgestaltung](https://aws.amazon.com/gamelift/servers/pricing/) und Kostenoptimierung. Probieren Sie den [Preisrechner](https://calculator.aws/#/createCalculator/GameLift) aus, um zu sehen, wie die Hosting-Kosten auf der Grundlage der Spitzenauslastung durch gleichzeitige Spieler (CCU) berechnet werden.
+ Holen Sie sich Downloads und sehen Sie sich Code-Repositorys Amazon GameLift Servers SDKs, Plugins und Toolkits an. Siehe [Amazon GameLift ServersErste Schritte](https://aws.amazon.com/gamelift/servers/getting-started/). (Sie benötigen eine AWS-Konto , um sie verwenden zu können.)

Sie **benötigen** ein AWS Konto für: 
+ Folgen Sie den Onboarding-Workflows mit den Amazon GameLift Servers Plugins für Unreal und Unity oder verwenden Sie den Gameserver-Wrapper.
+ Erstellen und verwalten Sie AWS Ressourcen mit dem. AWS-Managementkonsole
+ Erstellen und verwalten Sie AWS Ressourcen mit dem AWS Command Line Interface.
+ Verwenden Sie Amazon Q mit dem In der Amazon GameLift Servers technischen Dokumentation, um Antworten, Anleitungen und Empfehlungen zu finden. 

**Topics**
+ [Melden Sie sich an für ein AWS-Konto](#sign-up-for-aws)
+ [Erstellen eines Benutzers mit Administratorzugriff](#create-an-admin)
+ [Legen Sie Benutzerberechtigungen fest für Amazon GameLift Servers](#getting-started-create-iam-user)
+ [Richten Sie den programmatischen Zugriff für Benutzer ein](#getting-started-iam-user-access-keys)
+ [Richte den programmatischen Zugriff für dein Spiel ein](#getting-started-iam-player-user)
+ [Beispiele für IAM-Berechtigungen für Amazon GameLift Servers](gamelift-iam-policy-examples.md)
+ [Richten Sie eine IAM-Servicerolle ein für Amazon GameLift Servers](setting-up-role.md)

## Melden Sie sich an für ein AWS-Konto
<a name="sign-up-for-aws"></a>

Wenn Sie noch keine haben AWS-Konto, führen Sie die folgenden Schritte aus, um eine zu erstellen.

**Um sich für eine anzumelden AWS-Konto**

1. Öffnen Sie [https://portal.aws.amazon.com/billing/die Anmeldung.](https://portal.aws.amazon.com/billing/signup)

1. Folgen Sie den Online-Anweisungen.

   Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben.

   Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Benutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

AWS sendet Ihnen nach Abschluss des Anmeldevorgangs eine Bestätigungs-E-Mail. Du kannst jederzeit deine aktuellen Kontoaktivitäten einsehen und dein Konto verwalten, indem du zu [https://aws.amazon.com/](https://aws.amazon.com/)gehst und **Mein Konto** auswählst.

## Erstellen eines Benutzers mit Administratorzugriff
<a name="create-an-admin"></a>

Nachdem Sie sich für einen angemeldet haben AWS-Konto, sichern Sie Ihren Root-Benutzer des AWS-Kontos AWS IAM Identity Center, aktivieren und erstellen Sie einen Administratorbenutzer, sodass Sie den Root-Benutzer nicht für alltägliche Aufgaben verwenden.

**Sichern Sie Ihre Root-Benutzer des AWS-Kontos**

1.  Melden Sie sich [AWS-Managementkonsole](https://console.aws.amazon.com/)als Kontoinhaber an, indem Sie **Root-Benutzer** auswählen und Ihre AWS-Konto E-Mail-Adresse eingeben. Geben Sie auf der nächsten Seite Ihr Passwort ein.

   Hilfe bei der Anmeldung mit dem Root-Benutzer finden Sie unter [Anmelden als Root-Benutzer](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) im *AWS-Anmeldung -Benutzerhandbuch* zu.

1. Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA) für den Root-Benutzer.

   Anweisungen finden Sie unter [Aktivieren eines virtuellen MFA-Geräts für Ihren AWS-Konto Root-Benutzer (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) im *IAM-Benutzerhandbuch*.

**Erstellen eines Benutzers mit Administratorzugriff**

1. Aktivieren Sie das IAM Identity Center.

   Anweisungen finden Sie unter [Aktivieren AWS IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Gewähren Sie einem Administratorbenutzer im IAM Identity Center Benutzerzugriff.

   *Ein Tutorial zur Verwendung von IAM-Identity-Center-Verzeichnis als Identitätsquelle finden Sie IAM-Identity-Center-Verzeichnis im Benutzerhandbuch unter [Benutzerzugriff mit der Standardeinstellung konfigurieren](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html).AWS IAM Identity Center *

**Anmelden als Administratorbenutzer**
+ Um sich mit Ihrem IAM-Identity-Center-Benutzer anzumelden, verwenden Sie die Anmelde-URL, die an Ihre E-Mail-Adresse gesendet wurde, als Sie den IAM-Identity-Center-Benutzer erstellt haben.

  Hilfe bei der Anmeldung mit einem IAM Identity Center-Benutzer finden Sie [im *AWS-Anmeldung Benutzerhandbuch* unter Anmeldung beim AWS Access-Portal](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html).

**Weiteren Benutzern Zugriff zuweisen**

1. Erstellen Sie im IAM-Identity-Center einen Berechtigungssatz, der den bewährten Vorgehensweisen für die Anwendung von geringsten Berechtigungen folgt.

   Anweisungen hierzu finden Sie unter [ Berechtigungssatz erstellen](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

1. Weisen Sie Benutzer einer Gruppe zu und weisen Sie der Gruppe dann Single Sign-On-Zugriff zu.

   Eine genaue Anleitung finden Sie unter [ Gruppen hinzufügen](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) im *AWS IAM Identity Center -Benutzerhandbuch*.

## Legen Sie Benutzerberechtigungen fest für Amazon GameLift Servers
<a name="getting-started-create-iam-user"></a>

Erstellen Sie zusätzliche Benutzer oder erweitern Sie die Zugriffsberechtigungen auf bestehende Benutzer, je nach Bedarf für Ihre Amazon GameLift Servers Ressourcen. Als bewährte Methode ([bewährte Sicherheitsmethoden in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)) sollten Sie allen Benutzern Berechtigungen mit den geringsten Rechten zuweisen. Hinweise zur Syntax von Berechtigungen finden Sie unter. [Beispiele für IAM-Berechtigungen für Amazon GameLift Servers](gamelift-iam-policy-examples.md)

Verwenden Sie die folgenden Anweisungen, um Benutzerberechtigungen auf der Grundlage der Verwaltung der Benutzer in Ihrem AWS Konto festzulegen. 

Um Zugriff zu gewähren, fügen Sie Ihren Benutzern, Gruppen oder Rollen Berechtigungen hinzu:
+ Benutzer und Gruppen in AWS IAM Identity Center:

  Erstellen Sie einen Berechtigungssatz. Befolgen Sie die Anweisungen unter [Erstellen eines Berechtigungssatzes](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) im *AWS IAM Identity Center -Benutzerhandbuch*.
+ Benutzer, die in IAM über einen Identitätsanbieter verwaltet werden:

  Erstellen Sie eine Rolle für den Identitätsverbund. Befolgen Sie die Anleitung unter [Eine Rolle für einen externen Identitätsanbieter (Verbund) erstellen](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) im *IAM-Benutzerhandbuch*.
+ IAM-Benutzer:
  + Erstellen Sie eine Rolle, die Ihr Benutzer annehmen kann. Befolgen Sie die Anleitung unter [Eine Rolle für einen IAM-Benutzer erstellen](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) im *IAM-Benutzerhandbuch*.
  + (Nicht empfohlen) Weisen Sie einem Benutzer eine Richtlinie direkt zu oder fügen Sie einen Benutzer zu einer Benutzergruppe hinzu. Befolgen Sie die Anweisungen unter [Hinzufügen von Berechtigungen zu einem Benutzer (Konsole)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) im *IAM-Benutzerhandbuch*.

Bei der Arbeit mit IAM-Benutzern hat es sich bewährt, Berechtigungen immer Rollen oder Benutzergruppen zuzuweisen, nicht einzelnen Benutzern.

## Richten Sie den programmatischen Zugriff für Benutzer ein
<a name="getting-started-iam-user-access-keys"></a>

Benutzer benötigen programmatischen Zugriff, wenn sie mit AWS außerhalb des interagieren möchten. AWS-Managementkonsole Die Art und Weise, wie programmatischer Zugriff gewährt wird, hängt von der Art des Benutzers ab, der zugreift. AWS

Um Benutzern programmgesteuerten Zugriff zu gewähren, wählen Sie eine der folgenden Optionen.


****  

| Welcher Benutzer benötigt programmgesteuerten Zugriff? | Bis | Von | 
| --- | --- | --- | 
| IAM | (Empfohlen) Verwenden Sie Konsolenanmeldeinformationen als temporäre Anmeldeinformationen, um programmatische Anfragen an AWS CLI AWS SDKs, oder zu signieren. AWS APIs |  Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/setting-up-aws-login.html)  | 
|  Mitarbeiteridentität (Benutzer, die in IAM Identity Center verwaltet werden)  | Verwenden Sie temporäre Anmeldeinformationen, um programmatische Anfragen an das AWS CLI AWS SDKs, oder AWS APIs zu signieren. |  Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/setting-up-aws-login.html)  | 
| IAM | Verwenden Sie temporäre Anmeldeinformationen, um programmatische Anfragen an das AWS CLI AWS SDKs, oder zu signieren. AWS APIs | Folgen Sie den Anweisungen unter [Verwenden temporärer Anmeldeinformationen mit AWS Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) im IAM-Benutzerhandbuch. | 
| IAM | (Nicht empfohlen)Verwenden Sie langfristige Anmeldeinformationen, um programmatische Anfragen an das AWS CLI AWS SDKs, oder zu signieren. AWS APIs |  Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/setting-up-aws-login.html)  | 

Wenn Sie Zugriffsschlüssel verwenden, finden Sie weitere Informationen unter [Bewährte Methoden für die Verwaltung von AWS Zugriffsschlüsseln](https://docs.aws.amazon.com/accounts/latest/reference/credentials-access-keys-best-practices.html).

## Richte den programmatischen Zugriff für dein Spiel ein
<a name="getting-started-iam-player-user"></a>

Die meisten Spiele verwenden Backend-Dienste für die Kommunikation Amazon GameLift Servers mit dem. AWS SDKs Verwende einen Backend-Dienst (der für einen Spielclient agiert), um Spielsitzungen anzufordern, Spieler in Spiele einzuordnen und andere Aufgaben zu erledigen. Diese Dienste benötigen programmatischen Zugriff und Sicherheitsanmeldedaten, um Aufrufe der Service-API für zu authentifizieren. Amazon GameLift Servers 

Denn Sie verwalten diesen ZugriffAmazon GameLift Servers, indem Sie einen Player-Benutzer in AWS Identity and Access Management (IAM) erstellen. Verwalten Sie die Benutzerberechtigungen von Spielern mit einer der folgenden Optionen:
+ Erstellen Sie eine IAM-Rolle mit Spielerbenutzerberechtigungen und ermöglichen Sie dem Player-Benutzer, die Rolle bei Bedarf zu übernehmen. Der Back-End-Dienst muss Code enthalten, mit dem diese Rolle übernommen werden kann, bevor Anfragen gestellt werden. Amazon GameLift Servers Gemäß den bewährten Sicherheitsmethoden bieten Rollen begrenzten, temporären Zugriff. Sie können Rollen für Workloads verwenden, die auf AWS Ressourcen ([IAM-Rollen) oder außerhalb von AWS ([IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_non-aws.html) Roles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) Anywhere) ausgeführt werden.
+ Erstellen Sie eine IAM-Benutzergruppe mit Spielerbenutzerberechtigungen und fügen Sie Ihren Player-Benutzer der Gruppe hinzu. Mit dieser Option erhalten Ihre Player-Benutzer langfristige Anmeldeinformationen, die der Back-End-Dienst speichern und für die Kommunikation mit ihnen verwenden muss. Amazon GameLift Servers

Informationen zur Syntax der Berechtigungsrichtlinien finden Sie unter[Beispiele für Benutzerberechtigungen von Spielern](gamelift-iam-policy-examples.md#iam-policy-admin-game-dev-example). 

Weitere Informationen zur Verwaltung von Berechtigungen für die Verwendung durch einen Workload finden Sie unter [IAM-Identitäten: Temporäre Anmeldeinformationen in](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html#id_temp-creds) IAM.

# Beispiele für IAM-Berechtigungen für Amazon GameLift Servers
<a name="gamelift-iam-policy-examples"></a>

Verwenden Sie die Syntax in diesen Beispielen, um AWS Identity and Access Management (IAM-) Berechtigungen für Benutzer festzulegen, die Zugriff auf Amazon GameLift Servers Ressourcen benötigen. Weitere Informationen zur Verwaltung von Benutzerberechtigungen finden Sie unter[Legen Sie Benutzerberechtigungen fest für Amazon GameLift Servers](setting-up-aws-login.md#getting-started-create-iam-user). Bei der Verwaltung von Berechtigungen für Benutzer außerhalb des IAM Identity Center hat es sich bewährt, Berechtigungen immer IAM-Rollen oder Benutzergruppen zuzuordnen, nicht einzelnen Benutzern.

Wenn Sie die Lösung Amazon GameLift Servers FleetIQ als eigenständige Lösung verwenden, finden Sie weitere Informationen unter [Einrichten Ihres AWS-Konto](https://docs.aws.amazon.com/gameliftservers/latest/fleetiqguide/gsg-iam-permissions.html) für. Amazon GameLift Servers FleetIQ

## Beispiele für Administratorberechtigungen
<a name="iam-policy-simple-example"></a>

Diese Beispiele geben einem Hosting-Administrator oder Entwickler gezielten Zugriff auf die Verwaltung von Amazon GameLift Servers Spielhosting-Ressourcen.

**Example Syntax für Ressourcenberechtigungen Amazon GameLift Servers mit vollem Zugriff**  
Das folgende Beispiel erweitert den Vollzugriff auf alle Amazon GameLift Servers Ressourcen.    
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Effect": "Allow",
    "Action": "gamelift:*",
    "Resource": "*"
  }
}
```

**Example Syntax für Amazon GameLift Servers Ressourcenberechtigungen mit Unterstützung für Regionen, die standardmäßig nicht aktiviert sind**  
Das folgende Beispiel erweitert den Zugriff auf alle Amazon GameLift Servers Ressourcen und AWS Regionen, die standardmäßig nicht aktiviert sind. Weitere Informationen zu Regionen, die standardmäßig nicht aktiviert sind, und zu deren Aktivierung finden Sie unter [Verwaltung AWS-Regionen](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) in der *Allgemeine AWS-Referenz*.    
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Effect": "Allow",
    "Action": [
      "ec2:DescribeRegions",
      "gamelift:*"
    ],
    "Resource": "*"
  }
}
```

**Example Syntax für Amazon GameLift Servers Ressourcen für den Zugriff auf Container-Images in Amazon ECR**  
Das folgende Beispiel erweitert den Zugriff auf Amazon Elastic Container Registry (Amazon ECR) -Aktionen, die Amazon GameLift Servers Benutzer benötigen, wenn sie mit verwalteten Containerflotten arbeiten.     
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Effect": "Allow",
    "Action": [
      "ecr:DescribeImages",
      "ecr:BatchGetImage",
      "ecr:GetDownloadUrlForLayer"
    ],
    "Resource": "*"
  }
}
```

**Example Syntax für Amazon GameLift Servers Ressourcen und Berechtigungen `PassRole`**  
Das folgende Beispiel erweitert den Zugriff auf alle Amazon GameLift Servers Ressourcen und ermöglicht es einem Benutzer, eine IAM-Dienstrolle an zu Amazon GameLift Servers übergeben. Eine Servicerolle bietet Amazon GameLift Servers eingeschränkte Möglichkeiten, in Ihrem Namen auf andere Ressourcen und Dienste zuzugreifen, wie unter beschrieben[Richten Sie eine IAM-Servicerolle ein für Amazon GameLift Servers](setting-up-role.md). Wenn Sie beispielsweise auf eine `CreateBuild` Anfrage antworten, Amazon GameLift Servers benötigen Sie Zugriff auf Ihre Build-Dateien in einem Amazon S3 S3-Bucket. Weitere Informationen zu dieser `PassRole` Aktion finden Sie unter [IAM: Eine IAM-Rolle an einen bestimmten AWS Service weitergeben](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_iam-passrole-service.html) im *IAM-Benutzerhandbuch*.    
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "gamelift:*",
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "iam:PassedToService": "gamelift.amazonaws.com"
        }
      }
    }
  ]
}
```

## Beispiele für Benutzerberechtigungen von Spielern
<a name="iam-policy-admin-game-dev-example"></a>

Diese Beispiele ermöglichen es einem Back-End-Dienst oder einer anderen Entität, API-Aufrufe an die Amazon GameLift Servers API zu tätigen. Sie behandeln die gängigen Szenarien für die Verwaltung von Spielsitzungen, Spielersitzungen und Matchmaking. Weitere Details finden Sie unter [Richte den programmatischen Zugriff für dein Spiel ein](setting-up-aws-login.md#getting-started-iam-player-user).

**Example Syntax für die Platzierungsberechtigungen für Spielsitzungen**  
Das folgende Beispiel erweitert den Zugriff auf die Amazon GameLift Servers APIs , die Warteschlangen für die Platzierung von Spielsitzungen verwenden, um Spielsitzungen zu erstellen und Spielersitzungen zu verwalten.     
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Sid": "PlayerPermissionsForGameSessionPlacements",
    "Effect": "Allow",
    "Action": [
      "gamelift:StartGameSessionPlacement",
      "gamelift:DescribeGameSessionPlacement",
      "gamelift:StopGameSessionPlacement",
      "gamelift:CreatePlayerSession",
      "gamelift:CreatePlayerSessions",
      "gamelift:DescribeGameSessions"
    ],
    "Resource": "*"
  }
}
```

**Example Syntax für Matchmaking-Berechtigungen**  
Das folgende Beispiel erweitert den Zugriff auf diejenigen, Amazon GameLift Servers APIs die FlexMatch Matchmaking-Aktivitäten verwalten. FlexMatchordnet Spieler für neue oder bestehende Spielsitzungen zu und leitet die Platzierung von Spielsitzungen für Spiele ein, auf denen gehostet wird. Amazon GameLift Servers Weitere Informationen zu finden Sie FlexMatch unter [Was ist Amazon GameLift ServersFlexMatch?](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-intro.html)    
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Sid": "PlayerPermissionsForGameSessionMatchmaking",
    "Effect": "Allow",
    "Action": [
      "gamelift:StartMatchmaking",
      "gamelift:DescribeMatchmaking",
      "gamelift:StopMatchmaking",
      "gamelift:AcceptMatch",
      "gamelift:StartMatchBackfill",
      "gamelift:DescribeGameSessions"
    ],
    "Resource": "*"
  }
}
```

**Example Syntax für die manuelle Platzierung von Spielsitzungen**  
Das folgende Beispiel erweitert den Zugriff auf die Amazon GameLift Servers APIs , die manuell Spielsitzungen und Spielersitzungen auf bestimmten Flotten erstellen. Dieses Szenario unterstützt Spiele, die keine Platzierungswarteschlangen verwenden, z. B. Spiele, bei denen Spieler teilnehmen können, indem sie aus einer Liste verfügbarer Spielsitzungen auswählen (die "list-and-pick" -Methode).    
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": {
    "Sid": "PlayerPermissionsForManualGameSessions",
    "Effect": "Allow",
    "Action": [
      "gamelift:CreateGameSession",
      "gamelift:DescribeGameSessions",
      "gamelift:SearchGameSessions",
      "gamelift:CreatePlayerSession",
      "gamelift:CreatePlayerSessions",
      "gamelift:DescribePlayerSessions"
    ],
    "Resource": "*"
  }
}
```

# Richten Sie eine IAM-Servicerolle ein für Amazon GameLift Servers
<a name="setting-up-role"></a>

Bei einigen Amazon GameLift Servers Funktionen müssen Sie den eingeschränkten Zugriff auf andere AWS Ressourcen, die Sie besitzen, erweitern. Sie können dies tun, indem Sie eine AWS Identity and Access Management (IAM-) Rolle erstellen. Eine IAM-[Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) ist eine IAM-Identität, die Sie in Ihrem Konto mit bestimmten Berechtigungen erstellen können. Eine IAM-Rolle ähnelt einem IAM-Benutzer insofern, als es sich um eine AWS Identität mit Berechtigungsrichtlinien handelt, die festlegen, wofür die Identität zuständig ist und was nicht. AWS Eine Rolle ist jedoch nicht einer einzigen Person zugeordnet, sondern kann von allen Personen angenommen werden, die diese Rolle benötigen. Einer Rolle sind außerdem keine standardmäßigen, langfristigen Anmeldeinformationen (Passwörter oder Zugriffsschlüssel) zugeordnet. Wenn Sie eine Rolle übernehmen, erhalten Sie stattdessen temporäre Anmeldeinformationen für Ihre Rollensitzung. 

In diesem Thema wird beschrieben, wie Sie eine Rolle erstellen, die Sie mit Ihren Amazon GameLift Servers verwalteten Flotten verwenden können. Wenn Sie Amazon GameLift Servers FleetIQ das Game-Hosting auf Ihren Amazon Elastic Compute Cloud (Amazon EC2) -Instances optimieren, finden Sie weitere Informationen unter [Einrichten Ihres AWS-Konto für Amazon GameLift ServersFleetIQ](https://docs.aws.amazon.com/gameliftservers/latest/fleetiqguide/gsg-iam-permissions.html).

Erstellen Sie im folgenden Verfahren eine Rolle mit einer benutzerdefinierten Berechtigungsrichtlinie und einer Vertrauensrichtlinie, die es ermöglicht, die Rolle Amazon GameLift Servers zu übernehmen.

## Erstellen Sie eine IAM-Servicerolle für eine Amazon GameLift Servers verwaltete EC2-Flotte
<a name="setting-up-role-custom"></a>

**Schritt 1: Erstellen Sie eine Berechtigungsrichtlinie.**

Verwenden Sie die Anweisungen und Beispiele auf dieser Seite, um eine benutzerdefinierte Berechtigungsrichtlinie für den Amazon GameLift Servers Flottentyp zu erstellen, mit dem Sie arbeiten.

**So verwenden Sie den JSON-Richtlinieneditor zum Erstellen einer Richtlinie**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Wählen Sie im Navigationsbereich auf der linken Seite **Policies (Richtlinien)**. 

   Wenn Sie zum ersten Mal **Policies (Richtlinien)** auswählen, erscheint die Seite **Welcome to Managed Policies (Willkommen bei verwalteten Richtlinien)**. Wählen Sie **Get Started**.

1. Wählen Sie oben auf der Seite **Create policy (Richtlinie erstellen)** aus.

1. Wählen Sie im Bereich **Policy editor** (Richtlinien-Editor) die Option **JSON** aus.

1. Geben oder fügen Sie ein JSON-Richtliniendokument ein. Weitere Informationen zur IAM-Richtliniensprache finden Sie in der [IAM-JSON-Richtlinienreferenz](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html).

1. Beheben Sie alle Sicherheitswarnungen, Fehler oder allgemeinen Warnungen, die während der [Richtlinien-Validierung](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_policy-validator.html) erzeugt wurden, und wählen Sie dann **Weiter**. 
**Anmerkung**  
Sie können jederzeit zwischen den Editoroptionen **Visual** und **JSON** wechseln. Wenn Sie jedoch Änderungen vornehmen oder im **Visual**-Editor **Weiter** wählen, strukturiert IAM Ihre Richtlinie möglicherweise um, um sie für den visuellen Editor zu optimieren. Weitere Informationen finden Sie unter [Richtlinienrestrukturierung](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure) im *IAM-Benutzerhandbuch*.

1. (Optional) Wenn Sie eine Richtlinie in der erstellen oder bearbeiten AWS-Managementkonsole, können Sie eine JSON- oder YAML-Richtlinienvorlage generieren, die Sie in CloudFormation Vorlagen verwenden können.

   Wählen Sie dazu im **Richtlinien-Editor** **Aktionen** und anschließend ** CloudFormationVorlage generieren** aus. Weitere Informationen CloudFormation finden Sie in der [Referenz zum AWS Identity and Access Management Ressourcentyp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_IAM.html) im *AWS CloudFormation Benutzerhandbuch*.

1. Wenn Sie mit dem Hinzufügen von Berechtigungen zur Richtlinie fertig sind, wählen Sie **Next** (Weiter) aus.

1. Geben Sie auf der Seite **Prüfen und erstellen** unter **Richtlinienname** einen Namen und unter **Beschreibung** (optional) eine Beschreibung für die Richtlinie ein, die Sie erstellen. Überprüfen Sie **Permissions defined in this policy** (In dieser Richtlinie definierte Berechtigungen), um die Berechtigungen einzusehen, die von Ihrer Richtlinie gewährt werden.

1. (Optional) Fügen Sie der Richtlinie Metadaten hinzu, indem Sie Tags als Schlüssel-Wert-Paare anfügen. Weitere Informationen zur Verwendung von Tags in IAM finden Sie unter [Tags für AWS Identity and Access Management Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *IAM-Benutzerhandbuch*.

1. Wählen Sie **Create policy** (Richtlinie erstellen) aus, um Ihre neue Richtlinie zu speichern.

**Schritt 2: Erstellen Sie eine Rolle, die übernommen Amazon GameLift Servers werden kann.**

**So erstellen Sie eine IAM-Rolle**

1. Klicken Sie im Navigationsbereich der IAM-Konsole auf **Rollen**, und wählen Sie dann **Rolle erstellen**.

1. **Wählen Sie auf der Seite Vertrauenswürdige Entität** auswählen die Option **Benutzerdefinierte Vertrauensrichtlinie** aus. Diese Auswahl öffnet den Editor **für benutzerdefinierte Vertrauensrichtlinien**.

1. Ersetzen Sie die standardmäßige JSON-Syntax durch die folgende Syntax und wählen Sie dann **Weiter**, um fortzufahren.

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "gamelift.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

1. Suchen Sie auf der Seite „**Berechtigungen hinzufügen**“ nach der Berechtigungsrichtlinie, die Sie in Schritt 1 erstellt haben, und wählen Sie sie aus. Wählen Sie **Next** (Weiter), um fortzufahren.

1. Geben Sie auf der Seite **Name, überprüfen und erstellen** einen **Rollennamen** und eine **Beschreibung** (optional) für die Rolle ein, die Sie erstellen. Überprüfen Sie die **Vertrauensentitäten** und die **hinzugefügten Berechtigungen**.

1. Wählen Sie **Rolle erstellen**, um Ihre neue Rolle zu speichern.

## Erstellen Sie eine IAM-Rolle für Amazon GameLift Servers verwaltete Container
<a name="setting-up-role-containers"></a>

Wenn Sie Amazon GameLift Servers verwaltete Container verwenden, müssen Sie eine IAM-Servicerolle für die Verwendung mit einer Containerflotte erstellen. Diese Rolle gewährt eingeschränkte Berechtigungen, die Sie Amazon GameLift Servers benötigen, um die Ressourcen Ihrer Containerflotte zu verwalten und in Ihrem Namen Maßnahmen zu ergreifen.

**Um eine IAM-Rolle für eine Containerflotte zu erstellen**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)

1. Klicken Sie im Navigationsbereich der IAM-Konsole auf **Rollen**, und wählen Sie dann **Rolle erstellen**.

1. **Wählen Sie auf der Seite „Vertrauenswürdige Entität** auswählen“ den **AWS Dienst** und anschließend den **Anwendungsfall** "GameLift“ aus. Wählen Sie **Weiter**

1. Wählen **Sie auf „Berechtigungen hinzufügen**“ die verwaltete Richtlinie aus`GameLiftContainerFleetPolicy`. Wählen Sie **Weiter** aus. [AWS verwaltete Richtlinien für Amazon GameLift Servers](security-iam-awsmanpol.md)Weitere Informationen zu dieser Richtlinie finden Sie unter.

1. Geben Sie unter **Name, review and create** einen Rollennamen ein und wählen Sie **Create role** aus, um die neue Rolle zu speichern.

## Syntax der Berechtigungsrichtlinie
<a name="setting-up-role-syntax"></a>
+ **Berechtigungen für Amazon GameLift Servers die Übernahme der Servicerolle**

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "gamelift.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
  }
  ```

------
+ **Berechtigungen für den Zugriff auf AWS Regionen, die standardmäßig nicht aktiviert sind**

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": [
            "gamelift.amazonaws.com",
            "gamelift.ap-east-1.amazonaws.com",
            "gamelift.me-south-1.amazonaws.com",
            "gamelift.af-south-1.amazonaws.com",
            "gamelift.eu-south-1.amazonaws.com" 
          ]
        },
        "Action": "sts:AssumeRole"
      }
    ]
  }
  ```

------

# Holen Sie sich Amazon GameLift Servers Entwicklungstools
<a name="gamelift-supported"></a>

Amazon GameLift Serversbietet eine Reihe von SDKs und anderen Tools, mit denen Sie Game-Hosting-Lösungen für Ihre Spiele entwickeln können. SDKs Sie erweitern Spieleserver, Spieleclients und Backend-Dienste um Funktionen, die es ihnen ermöglichen, mit dem Amazon GameLift Servers Dienst zu interagieren. Aktuelle Informationen zu Amazon GameLift Servers SDK-Versionen und Kompatibilität finden Sie unter[Amazon GameLift Servers-Versionshinweise](release-notes.md).

## Für Spieleserver
<a name="gamelift-supported-servers"></a>

Integrieren und erstellen Sie Ihre 64-Bit-Spieleserver mit dem Server-SDK fürAmazon GameLift Servers. Der Spieleserver verwendet das Server-SDK für die Kommunikation mit dem Amazon GameLift Servers Dienst für die Verwaltung von Spielsitzungen, einschließlich des Startens, Aktualisierens und Stoppens von Spielsitzungen. Hilfe zur Integration des Server-SDK in Ihre Spielprojekte finden Sie unter[Bereite ein Spiel für das Hosten vor mit Amazon GameLift Servers](integration-intro.md).

### Unterstützung bei der Entwicklung
<a name="gamelift-supported-servers-dev"></a>
+ **Entwicklungs-Betriebssystem**
  + Windows
  + Linux
+ **Programmiersprachen** 

  **[Holen Sie sich das Amazon GameLift Servers SDK](https://github.com/amazon-gamelift).** Versionsspezifische Informationen und Installationsanweisungen finden Sie in den Readme-Dateien, die in jedem Paket enthalten sind.
  + [C\$1\$1-Server-SDK](https://github.com/amazon-gamelift/amazon-gamelift-servers-cpp-server-sdk)
    + [Server-SDK-Referenz](integration-server-sdk5-cpp-actions.md)
    + [Wie integriert man](gamelift-sdk-server-api.md)
  + [C\$1-Server-SDK](https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk) (Support für.NET 4, .NET 6, .NET 8 variiert je nach Version, siehe[SDK-Versionen](release-notes.md#release-notes-history))
    + [Server-SDK-Referenz](integration-server-sdk5-csharp-actions.md)
    + [Wie integriert man](gamelift-sdk-server-api.md)
  + [Gehen Sie zum Server-SDK](https://github.com/amazon-gamelift/amazon-gamelift-servers-go-server-sdk)
    + [Server-SDK-Referenz](integration-server-sdk-go-actions.md)
    + [Wie integriert man](gamelift-sdk-server-api.md)
+ **Game-Engine-Unterstützung**

  Das Plug-in mit vollem Funktionsumfang für Amazon GameLift Servers umfasst UI-Workflows und Beispielressourcen sowie integrierte Versionen des AWS SDK und des Server-SDK. Die Workflows führen Sie durch die Konfiguration und Bereitstellung Ihres Spieleservers für das Hosting mit verwalteten EC2-Flotten, verwalteten Container-Flotten oder selbstverwalteten Anywhere-Flotten. Wenn du die geführten Workflows nicht benötigst, kannst du auch einfach das Server-SDK für deine Game-Engine aus denselben Repositorys beziehen. GitHub 

  Wenn du eine andere Game-Engine oder Entwicklungsumgebung verwendest, die das Plugin nicht unterstützt, besorge dir das Server-SDK für deine Programmiersprache und füge es zu deinem Spielprojekt hinzu.

  Versionsspezifische Informationen und Installationsanweisungen findest du in den Readme-Dateien, die in jedem Paket enthalten sind.
  + [Plugin für Unreal Engine — Entwickelt](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unreal) für die Verwendung mit den Unreal Engine-Versionen 5.6. Suchen Sie in den versionsspezifischen Readme-Dateien nach, ob Unreal unterstützt wird.
    + [Plugin-Anleitung für Unreal Engine](unreal-plugin.md)
    + [C\$1\$1 (Unreal) Server-SDK 5.x für Amazon GameLift Servers -- Aktionen](integration-server-sdk5-unreal-actions.md)
  + [Plugin für Unity](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unity) — Entwickelt für die Verwendung mit den LTS-Versionen von Unity Editor 6.0, 2022.3 oder 2021.3. Es unterstützt die Profile .NET Framework und .NET Standard von Unity mit.NET Standard 2.1 und .NET 4.x. Informationen zur Unity-Unterstützung finden Sie in den versionsspezifischen Readmes.
    + [Plugin-Leitfaden für Unity](unity-plug-in.md)
    + [C\$1-Server-SDK 5.x für Amazon GameLift Servers -- Aktionen](integration-server-sdk5-csharp-actions.md)SDK-Referenz für C\$1-Server
  + [Server-SDK für Unreal](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unreal)
    + [Server-SDK-Referenz](integration-server-sdk5-unreal-actions.md)
    + [Amazon GameLift ServersIn ein Unreal Engine-Projekt integrieren](integration-engines-setup-unreal.md)
  + [Server-SDK SDK for Unity](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unity)
    + [Server-SDK-Referenz](integration-server-sdk5-csharp-actions.md)
    + [Amazon GameLift ServersIn ein Unity-Projekt integrieren](integration-engines-unity-using.md)

### Runtime-Unterstützung
<a name="gamelift-supported-servers-runtime"></a>

Für eine verwaltete Hosting-Lösung sollten Sie Ihren Spieleserver so einrichten, dass er auf einem der folgenden Amazon-Computer-Images läuft (AMIs). [Amazon GameLift ServersAMI-Versionen](reference-ec2-ami-version-history.md)Weitere Amazon GameLift Servers Informationen finden Sie unter.
+ [Windows Server 2016](https://aws.amazon.com/windows/products/ec2/windows-server-2016/)
+ [Amazon Linux 2023](https://aws.amazon.com/linux/amazon-linux-2023/)
+ [Amazon Linux 2](https://aws.amazon.com/amazon-linux-2/)

**Anmerkung**  
Der Support für Amazon Linux 2 (AL2) endet am 30. Juni 2026. Weitere Einzelheiten finden Sie in [Amazon Linux FAQs 2.](https://aws.amazon.com/amazon-linux-2/faqs/) Bei Spieleservern, die auf dem Amazon GameLift Servers Server-SDK 4.x gehostet werden AL2 und dieses verwenden, aktualisieren Sie zuerst den Spieleserver-Build auf das Server-SDK 5.x und stellen Sie ihn dann auf Instances bereit AL2023 . Siehe [Migrieren Sie zum Server-SDK 5.x für Amazon GameLift Servers](reference-serversdk5-migration.md).

### Zusätzliche Tools
<a name="gamelift-supported-servers-tools"></a>

**[Spieleserver-Wrapper für Amazon GameLift Servers](https://github.com/amazon-gamelift/amazon-gamelift-servers-game-server-wrapper/)**  
Dieses Tool hilft Ihnen bei der Bereitstellung eines Spieleservers zum Hosten mit einer Reihe grundlegender Funktionen zur Verwaltung von Spielesitzungen. Mit diesem Tool müssen Sie keine Änderungen an Ihrem Spielcode vornehmen oder das Server-SDK für integrierenAmazon GameLift Servers. Verwenden Sie den Gameserver-Wrapper, um Ihren Spieleserver zu verpacken und ihn mithilfe einer der drei Hosting-Lösungen (Anywhere, Managed EC2 oder Managed Containers) für das Amazon GameLift Servers Game-Hosting bereitzustellen. Dieses Tool eignet sich am besten für die frühe Evaluierung oder das Prototyping mit Ihrem eigenen Spiel oder einem Beispielspiel, da dieses Tool die Anpassung von Spieleservern nicht unterstützt. Wenn dein Spiel keine benutzerdefinierten Funktionen benötigt, kannst du deinen Spieleserver mit dem Gameserver-Wrapper für das Produktionshosting bereitstellen. 

**[Amazon GameLift ServersToolkit](https://github.com/aws/amazon-gamelift-toolkit)**  
Das Amazon GameLift Servers Toolkit ist eine Sammlung von Skripten und anderen Tools, die wir entwickelt haben, um Entwicklern bei häufigen Szenarien und Problemen zu helfen. Zu den Materialien des Toolkits gehören Skripte, Beispielcode und Readmes. 
+ [Container-Starterkit](https://github.com/aws/amazon-gamelift-toolkit/tree/main/containers-starter-kit) — Verwende dieses Tool, um die Einrichtung von Spielserver-Builds für das Hosting mit Amazon GameLift Servers verwalteten Containern zu vereinfachen. Das Kit integriert wichtige Funktionen zur Verwaltung von Spielsitzungen in einen Spieleserver und verwendet vorkonfigurierte Vorlagen, um eine Containerflotte zu erstellen und eine automatisierte Bereitstellungspipeline für Ihren Spielserver-Build einzurichten. Nach der Bereitstellung kannst du mithilfe der Amazon GameLift Servers Konsole und der API-Tools die Leistung deiner Flotte überwachen, Spielsitzungen verwalten und Messwerte analysieren. Das Kit lässt sich AWS CodeBuild für die Build-Automatisierung, Amazon Simple Storage Service für Speicher und AWS CloudFormation für die Infrastrukturbereitstellung integrieren.
+ [Tool zur schnellen Aktualisierung von Builds](https://github.com/aws/amazon-gamelift-toolkit/tree/main/fast-build-update-tool) — Verwenden Sie dieses Tool, um einen Spielserver-Build zu ändern, der bereits auf einer verwalteten EC2-Flotte bereitgestellt wurde. Das Tool wurde entwickelt, um dir dabei zu helfen, Spiele-Build-Dateien schnell auszutauschen, ohne bei jeder Änderung neue EC2-Flotten konfigurieren und erstellen zu müssen. Sie können einzelne Instances oder alle Instances in der Flotte aktualisieren. Mit den Optionen kannst du bestimmte Build-Dateien oder einen ganzen Build ersetzen und festlegen, wie du Spieleserver nach den Updates neu startest. 

## Für Spieleclients
<a name="gamelift-supported-game-clients"></a>

Integrieren Sie Ihren Spieleclient in das Client-SDK fürAmazon GameLift Servers. Das Client-SDK bietet Dienstprogramme für Spieleclients, mit denen sie Amazon GameLift Servers Funktionen wie Player-Gateway und UDP-Ping-Beacons nutzen können.

**Holen Sie sich das Client-SDK**
+ [Client-SDK SDK for C\$1\$1](https://github.com/amazon-gamelift/amazon-gamelift-servers-client-sdk-for-cpp) — Enthält Player-Gateway- und UDP-Ping-Beacon-Dienstprogramme mit integrierten Algorithmen zur Endpunktauswahl sowie eine Beispielanwendung, die die Integration demonstriert. Erfordert C\$1\$117 und eine Threading-Bibliothek.
+ [Client-SDK für Unreal Engine](https://github.com/amazon-gamelift-for-unreal/amazon-gamelift-servers-client-sdk-for-unreal) — Beinhaltet Player-Gateway (mit oder ohne Engine-Änderungen) und UDP-Ping-Beacons mit integrierten Algorithmen zur Endpunktauswahl. Erfordert die im Quellcode erstellte Unreal Engine 5.1 oder höher. Für den Zugriff ist eine Mitgliedschaft in der [Epic Games-Organisation](https://www.unrealengine.com/en-US/ue-on-github) am erforderlich. GitHub

Anleitungen zur Integration findest du in der Dokumentation zu den einzelnen GitHub Repositorys.

## Für Backend-Dienste für Spiele
<a name="gamelift-supported-clients"></a>

Erstellen Sie einen 64-Bit-Backend-Dienst für Ihr Spiel und integrieren Sie ihn in Funktionen aus dem AWS SDK, zu dem auch die Service-API für gehört. Amazon GameLift Servers Verwenden Sie den Backend-Service, um Interaktionen mit dem Amazon GameLift Servers Dienst abzuwickeln, einschließlich des Startens oder Findens von Spielsitzungen und des Beitritts von Spielern zu Spielen.

[Holen Sie sich das SDK AWS](https://aws.amazon.com/developer/tools/#SDKs)

Weitere Informationen zur Verwendung des AWS SDK mit Amazon GameLift Servers finden Sie in den folgenden Ressourcen: 
+ [Amazon GameLift Servers API Referenz](https://docs.aws.amazon.com/gameliftservers/latest/apireference/Welcome.html)
+ Integrieren Sie die Funktionalität des Spielclients
  + [Clientseitige Serviceintegration für Spiele mit benutzerdefinierten Spieleserver-Builds](gamelift-sdk-client-api.md)
  + [Clientseitige Serviceintegration für Spiele mit Servern Realtime](https://docs.aws.amazon.com/gameliftservers/latest/realtimeguide/realtime-client.html)
+ [Entwerfen Sie einen Backend-Service](gamelift_quickstart_customservers_designbackend.md)

## Für das Amazon GameLift Servers Ressourcenmanagement
<a name="gamelift-supported-resources"></a>

Verwenden Sie die folgenden Tools, um Ihre Amazon GameLift Servers verwalteten Hosting-Ressourcen zu erstellen, zu aktualisieren und zu überwachen. 
+ [AWS-Managementkonsole](https://console.aws.amazon.com/)— Die AWS Konsole ist eine webbasierte Anwendung, die einen zentralen Zugriff auf alle einzelnen AWS Servicekonsolen bietet, einschließlichAmazon GameLift Servers. Verwenden Sie die Konsole, um ein AWS Konto zu erstellen oder sich anzumelden, und öffnen Sie die Amazon GameLift Servers Konsole, um mit Ihren Spielhosting-Ressourcen zu arbeiten. Du kannst Hosting-Flotten und andere Ressourcen konfigurieren und bereitstellen, Nutzungs- und Leistungskennzahlen einsehen, Ressourcen im Dashboard verfolgen und viele andere Aufgaben erledigen. [Gehen Sie zur Amazon GameLift Servers Konsole.](https://console.aws.amazon.com//gamelift) 
+ [Service-API für Amazon GameLift Servers](https://docs.aws.amazon.com/gameliftservers/latest/apireference/Welcome.html) — Diese API ermöglicht Ihnen programmatischen Zugriff auf all Ihre Amazon GameLift Servers Ressourcen. Sie ist Teil des AWS SDK, das Sie für die Verwendung mit den gängigsten Programmiersprachen herunterladen können. [Holen Sie sich das AWS SDK.](https://aws.amazon.com//developer)
+ [AWS Befehlszeilenschnittstelle (CLI)](https://docs.aws.amazon.com/cli/) — Mit der AWS CLI können Sie über eine Befehlszeilen-Shell mit AWS Diensten interagieren. Die Tools bieten direkten Zugriff auf AWS Dienste sowie auf benutzerdefinierte Befehle, die für einen Dienst APIs verfügbar sind. [Holen Sie sich die AWS CLI.](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 
+ [AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)für Amazon GameLift Servers — Der CloudFormation Service unterstützt Sie bei der Modellierung und Einrichtung von AWS Ressourcen, um die Bereitstellung und Verwaltung der Infrastruktur zu optimieren. Erstellen Sie eine CloudFormation Vorlage, um die Amazon GameLift Servers Ressourcen für Ihre Hosting-Lösung zu beschreiben, und verwenden Sie diese Vorlage dann, um zusätzliche Ressourcen zu erstellen oder Konfigurationen zu aktualisieren. Sehen Sie sich die [Referenz zum Amazon GameLift Servers Ressourcentyp an.](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_GameLift.html)

## Für Amazon GameLift Servers Realtime
<a name="gamelift-supported-realtime"></a>

Konfigurieren und implementieren Sie Realtime Server zum Hosten Ihrer Multiplayer-Spiele. Verwenden Sie das Amazon GameLift Servers Realtime Client-SDK, damit Ihre Spieleclients eine Verbindung zu Realtime Servern herstellen können. Laden Sie zunächst [das Realtime Client-SDK herunter](https://aws.amazon.com/gamelift/servers/getting-started/). Informationen zur Konfiguration finden Sie unter [Integrieren eines Spieleclients für Amazon GameLift ServersRealtime](https://docs.aws.amazon.com/gameliftservers/latest/realtimeguide/realtime-client.html).

**SDK -Unterstützung**

Das Realtime Client SDK enthält die Quelle für die folgenden Sprachen:
+ C\$1 (.NET)

**Entwicklungsumgebungen**

Erstellen Sie das SDK nach Bedarf aus dem Quellcode für die folgenden unterstützten Entwicklungsbetriebssysteme und Game-Engines:
+ **Betriebssysteme** — Windows, Linux, Android, iOS
+ **Spiele-Engines** — Unity, Engines, die C\$1-Bibliotheken unterstützen
+ **Laufzeiten von Node.js** — 10.x, 24.x
**Anmerkung**  
Der Support für Node.js 10 wird am 30. September 2026 eingestellt. Weitere Einzelheiten finden Sie in [Node.js 10. FAQs](https://aws.amazon.com/gamelift/faq/nodejs10/) Hinweise zur Migration finden Sie unter [Migration von Node.js 10 auf 24.](https://docs.aws.amazon.com/gamelift/latest/realtimeguide/realtime-script.html#realtime-script-nodejs-migration)

**Betriebssyssteme für Spiel-Server**

Sie können Realtime Server auf Hosting-Ressourcen bereitstellen, die auf den folgenden Plattformen ausgeführt werden:
+ [Amazon Linux 2023](https://aws.amazon.com/linux/amazon-linux-2023/)
+ [Amazon Linux 2](https://aws.amazon.com/amazon-linux-2/)

# Tutorial: Schnelles Onboarding mit dem Wrapper Amazon GameLift Servers
<a name="gamelift-wrapper-tutorial"></a>

Willkommen zum Onboarding-Tutorial für. Amazon 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:
+ Stellen Sie Ihren Spieleserver schnell bereit, um ihn schnell zu hosten.
+ Keine Änderungen am Spielcode und keine Änderungen erforderlich.
+ Verwenden Sie diese Methode mit jeder ausführbaren Datei eines Spiels, unabhängig von der Spiel-Engine.
+ Erkunden Sie alle Amazon GameLift Servers Verwaltungstools, einschließlich der Überwachung der Aktivität von Spielsitzungen und des Zustands des Hostings.

**Anmerkung**  
Der Wrapper ist für Evaluierungszwecke und grundlegende Produktionszwecke vorgesehen. Erweiterte Funktionen wie die detaillierte Verwaltung von Spielersitzungen erfordern eine vollständige Server-SDK-Integration.

## Voraussetzungen
<a name="gamelift-wrapper-tutorial-prerequisites"></a>

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:
+ Und AWS-Konto mit den entsprechenden Berechtigungen
+ AWS CLI installiert
+ Gehe zu 1.18\$1
+ Ein ausführbarer Multiplayer-Gameserver
+ Marke (Linux/Mac)
+ Git wurde mit einem aktiven Konto installiert

## -Übersicht
<a name="gamelift-wrapper-tutorial-overview"></a>

In diesem Tutorial wirst du:

1. Holen Sie sich den Wrapper und bauen Sie ihn

1. Bereite den Spiel-Build vor

1. Konfiguriere den Wrapper

1. Lade den Spielserver-Build hoch

1. Erstellen Sie die verwaltete EC2-Flotte

1. Erstelle eine Spielsitzung und stelle eine Verbindung zu ihr her

1. Überwachen und verwalten Sie Ihre Spieleserver

1. Skalieren Sie Ihre Spieleserver

## Schritt 1: Holen Sie sich den Gameserver-Wrapper und bauen Sie ihn
<a name="gamelift-wrapper-tutorial-step1"></a>

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
<a name="gamelift-wrapper-tutorial-step1-windows"></a>

```
> 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
<a name="gamelift-wrapper-tutorial-step1-mac-linux"></a>

```
$ 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ügt`amazon-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 verwenden. `gamelift-servers-managed-ec2`

## Schritt 2: Bereite deinen Gameserver-Build vor
<a name="gamelift-wrapper-tutorial-step2"></a>

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

### Erstelle das Spielverzeichnis
<a name="gamelift-wrapper-tutorial-step2-create-directory"></a>

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:

1. Verwaltete EC2-Flotte. Suchen Sie im Ausgabeordner des Game-Server-Wrappers nach dem Build-Artefakt für die Bereitstellung auf einer verwalteten EC2-Flotte. Der Build wird in ein Ausgangsverzeichnis geschrieben, wie hier angegeben:. `out\linux\amd64\gamelift-servers-managed-ec2`

1. Kopieren Sie die ausführbare Datei Ihres Spieleservers und alle zugehörigen Dateien, die zum Ausführen erforderlich sind, in den `gamelift-servers-managed-ec2` Ordner. Du kannst nach Bedarf verschachtelte Verzeichnisse einrichten.

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
<a name="gamelift-wrapper-tutorial-step3"></a>

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 über Instances an mehreren Standorten verfügen, um Spieler zu unterstützen, egal wo sie sich befinden.

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

1. **Konfigurieren Sie die Logging-Einstellungen.** Der Gameserver-Wrapper generiert Protokollnachrichten für jeden Gameserver-Prozess. Standardmäßig ist die Protokollebene auf Debug eingestellt, um maximale Ausführlichkeit zu gewährleisten. Dies ist bei der Einrichtung und bei der Problembehandlung sehr nützlich und bestimmt, wie detailliert die Protokollmeldungen sind — in diesem Fall die ausführlichsten. Zu den Optionen gehören Debug, Info, Warn und Error (am wenigsten ausführlich).

1. **Geben Sie den Pfad zum Protokollverzeichnis des Spieleservers an**. Der Standardpfad für Spieleserver-Logs ist`./game-server-logs`. Dieses Verzeichnis enthält alle Protokolle, die von deinem Spieleserver generiert wurden, und jede Instanz hat sie. Die Protokolle werden automatisch dorthin hochgeladen, Amazon GameLift Servers wo sie über den Tab „**Ereignisse**“ abgerufen werden können. Weitere Informationen finden Sie im Abschnitt Problembehandlung.

1. **Definieren Sie die Netzwerk-Port-Konfiguration**. Stellen Sie den Gameport auf den von Ihnen bevorzugten Wert ein. Geben Sie für dieses Tutorial nur einen Port an, da Sie eine Flotte erstellen, auf der nur ein Gameserver-Prozess gleichzeitig pro Instanz ausgeführt wird. Wenn du dich dafür entscheidest, mehrere Prozesse gleichzeitig auszuführen, musst du genügend Ports für jeden gleichzeitigen Prozess konfigurieren. Der Standardwert ist 37016, wie in der Konfigurationsdatei gezeigt, aber im Allgemeinen sollten Sie für Flotten, die Linux-Builds verwenden, die Ports 22 und 1026-60000 verwenden. Verwenden Sie für Flotten, die Windows-Builds verwenden, die Ports 1026-60000.

1. **Richte den Pfad zur ausführbaren Datei des Spielservers** ein. `./MyGame/my-server-executable.exe`Passen Sie dazu den Pfad zur ausführbaren Datei Ihres Spieleservers mit dem tatsächlichen Namen und Speicherort an. Dies ist der Einstiegspunkt für den Start deines Gameservers.

1. **Konfiguriere die Gameserver-Argumente**. Geben Sie mindestens das Argument -port an und verwenden Sie denselben Game-Port-Wert, den Sie zuvor definiert haben. Der „pos“ -Wert 0 gibt an, dass dies das erste Argument ist. Fügen Sie nach Bedarf weitere Argumente hinzu. Diese Argumente werden beim Start an deinen Spieleserver übergeben, sodass du sein Laufzeitverhalten konfigurieren kannst.

   1. Argument: `"--port"`

   1. Wert: `"{{.port number here}}"`

   1. Position: `0` (Erstes Argument in der Liste)

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
<a name="gamelift-wrapper-tutorial-step4"></a>

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_2022 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
```

**Anmerkung**  
Verwenden Sie für Mac- und Linux-Builds --operating-system AMAZON\$1LINUX\$12023

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
<a name="gamelift-wrapper-tutorial-step5"></a>

In den folgenden Schritten wird eine minimale Flottenkonfiguration beschrieben, sodass Sie so schnell wie möglich einsatzbereit sind.

So erstellen Sie Ihre Flotte:

1. Loggen Sie sich in die ein AWS-Managementkonsole und navigieren Sie zuAmazon GameLift Servers.

1. Vergewissere dich in der Menüleiste oben im Konsolenfenster, in welcher Region sich dein Build befindet. Notiere dir das, denn deine Flotte muss sich in derselben Region befinden, sonst kannst du deinen Build nicht finden oder auswählen.

1. Wählen Sie im Navigationsbereich im Abschnitt **Managed EC2** die Option **Builds** aus.

1. Wählen Sie den Build aus, den Sie zuvor hochgeladen haben, um die **Seite mit den Build-Details** anzuzeigen.

1. **Wählen Sie im Bereich „Flotten“ die Option „**Flotte erstellen**“. Daraufhin wird die Detailseite „Verwaltete EC2-Flotte definieren“ angezeigt, auf der Sie den Status Ihrer Flotte verfolgen und auf der Registerkarte „Ereignisse“ Ereignisse bei der Flottenerstellung einsehen können.**

1. **Geben Sie den Namen und die Beschreibung ein und klicken Sie auf Weiter.**

1. Auf der Seite Instanzdetails definieren wird standardmäßig die Region des Builds angezeigt. Wählen Sie alle weiteren Regionen aus, die Sie hinzufügen möchten.

1. Wählen Sie als **Flottenart** die Option **On-Demand**.

1. **Wählen Sie unter **Instanztypen** die Option **c5.large und dann** Weiter aus.**

1. Unter **Runtime-Konfiguration** müssen Sie, da Ihr hochgeladenes Spiel-Build den Wrapper verwendet, stattdessen auf die ausführbare Wrapper-Datei verweisen. Für Windows-Spieleserver ist das. `C:\game\amazon-gamelift-servers-game-server-wrapper.exe` Für Linux-Spieleserver ist das`/local/game/amazon-gamelift-servers-game-server-wrapper`.

   Beispiel: `LaunchPath": "/local/game/amazon-gamelift-servers-game-server-wrapper", "ConcurrentExecutions": 1, "Parameters": "—port 37016`

   Konfigurieren Sie außerdem die Port-Werte des Spiels mit einem Bereich, der den Port, der in den Startparametern der Laufzeitkonfiguration festgelegt wurde, `config.yaml` und den Startparametern der Laufzeitkonfiguration berücksichtigt. Der Port in muss `config.yaml` nicht mit dem Port übereinstimmen, der in der Laufzeitkonfiguration der Flotte angegeben ist, aber wenn die Konfiguration zur Laufzeit einen anderen Port angibt, überschreibt dieser Wert den `config.yaml` Wert in. Die in der Laufzeitkonfiguration eingegebenen Startparameter haben auch Vorrang vor den Angaben in der`config.yaml`.

1. Überprüfen Sie auf der Seite **„Überprüfen und erstellen**“ alle Konfigurationen und wählen Sie dann „**Senden**“, um Ihre Flotte zu erstellen. Der Flottenstatus ändert sich, wenn die Kapazität zum Hosten des Spielservers erhöht wird. Sehr bald wird der Status **Aktiv** angezeigt. Sobald die Aktivierung abgeschlossen und die Flotte bereitgestellt ist, startet der Dienst den Wrapper, der bereit ist, eine Anfrage für eine Spielsitzung zu empfangen.

## Schritt 6: Erstelle eine Spielsitzung und stelle eine Verbindung zu ihr her
<a name="gamelift-wrapper-tutorial-step6"></a>

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.

**Anmerkung**  
Denken Sie daran, dass das Erstellen einer Spielsitzung mit dem nützlich AWS CLI ist, um den Prozess zu testen und sich mit ihm vertraut zu machen. Irgendwann werden Sie Ihrem Spiel-Backend-Service programmatische AWS SDK-Aufrufe als Teil des Matchmaking- oder Platzierungssystems für Spielsitzungen hinzufügen.

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
<a name="gamelift-wrapper-tutorial-step7"></a>

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:

1. Geben Sie "CloudWatch" in die Suchleiste ein und wählen Sie es aus der Suchergebnisliste aus, um die CloudWatch Übersicht anzuzeigen.

1. Scrollen Sie nach unten und wählen Sie „** GameLift Dashboard anzeigen**“, um Grafiken zu sehen, die auf den wichtigsten Kennzahlen Ihrer Flotten und Spielsitzungen basieren.

## Schritt 8: Skalieren Sie Ihre Spieleserver
<a name="gamelift-wrapper-tutorial-step8"></a>

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
<a name="gamelift-wrapper-tutorial-step8-manual"></a>

Um die Flottenkapazität manuell einzurichten

1. Gehen Sie auf der Detailseite Ihrer Flotte zur Registerkarte **Skalierung**.

1. Wählen Sie einen Standort aus und klicken Sie auf **Bearbeiten**.

1. Ändern Sie den Wert „**Gewünschte Instanzen**“ und ändern Sie die Einstellungen für „**Min**.“ und „**Max**. Größe“, um über die aktuellen Werte hinaus zu skalieren, und wählen Sie „**Bestätigen**“.

**Anmerkung**  
Verwenden Sie die Einstellung „Max. Instanzen“ als Notlösung, um übermäßige Skalierung und Kosten zu vermeiden.

### So verwenden Sie zielbasiertes Auto Scaling
<a name="gamelift-wrapper-tutorial-step8-target-based"></a>

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.

1. Wählen Sie unter **Zielbasierte Auto-Scaling-Richtlinie** die Option **Richtlinie hinzufügen** aus und legen Sie fest, dass sich die Kapazität der Flotte automatisch ändert, wenn sie den von Ihnen festgelegten Schwellenwert für den Prozentsatz verfügbarer Spielsitzungen erreicht. Ein größerer Puffer kann Überspannungen besser bewältigen und sorgt dafür, dass neue Spieler schnell mit Spielen beginnen, aber das kann auch zu höheren Hosting-Kosten führen.

1. Wählen Sie **Bestätigen**, um die Änderungen zu akzeptieren.

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
<a name="gamelift-wrapper-tutorial-troubleshoot"></a>

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:
+ Der Spieleserver-Prozess kann nicht gestartet werden. Dies könnte ein Fehler in der Wrapper-Konfiguration sein. Vergewissern Sie sich, dass die Datei den richtigen Startpfad und die richtigen Startparameter und Argumente hat.
+ Der Spielserver-Build kann nicht ausgeführt werden. Dies ist wahrscheinlich ein Fehler im Spielcode.
+ Spieler können keine Verbindung zu Spielsitzungen herstellen. Dies ist wahrscheinlich ein Fehler bei der Portkonfiguration.
+ Verzögerte oder langsame Verbindungen. Überprüfen Sie die Skalierungsrichtlinien und Schwellenwerte.
+ Keine Verbindung. Überprüfen Sie die Portregeln und die Konfiguration für Ihre Flotte.

### Um die Ereignisprotokolle für Ihre Amazon GameLift Servers Flotte einzusehen
<a name="gamelift-wrapper-tutorial-troubleshoot-fleet-logs"></a>

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

1. Öffnen Sie die Amazon GameLift Servers-Konsole.

1. Wählen Sie auf der Seite mit den Flottendetails die Registerkarte **Ereignisse** und laden Sie das Protokoll herunter. **Auf dem Tab „Metriken“ kannst du auch Aktivitäten und Hardwaremetriken für den Zustand des Spielservers und die Aktivierung von Spielsitzungen überwachen.**

### Um Spielsitzungsprotokolle einzusehen
<a name="gamelift-wrapper-tutorial-troubleshoot-session-logs"></a>

Um Spielsitzungsprotokolle einzusehen

1. Öffne von der Konsole aus deine Flotte und öffne den Tab **Spielsitzungen**.

1. Wähle eine Spielsitzungs-ID aus der Liste aus, um die entsprechende Übersichtsseite aufzurufen.

1. Wähle **Protokolle herunterladen**, um eine Protokolldatei lokal herunterzuladen.

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 Protokollzugriff in Echtzeit oder längere Aufbewahrungsfristen durch CloudWatch:

1. Geben Sie oben im Amazon GameLift Servers Konsolen-Dashboard "CloudWatch" in die Suchleiste ein und wählen Sie es aus der Ergebnisliste aus.

1. Gehen Sie zu den CloudWatch Protokollgruppen und suchen Sie nach bestimmten Sitzungen. Am einfachsten ist es, auf **Alle suchen** zu klicken und mit gameSessionId unserer clientId zu filtern.

## Nächste Schritte
<a name="gamelift-wrapper-tutorial-next-steps"></a>
+ [Erstellen Sie eine Flotte mit mehreren Standorten, um Hosting an weiteren Standorten hinzuzufügen](gamelift-regions.md#gamelift-regions-hosting)
+ [Füge eine Warteschlange für Spielsitzungen hinzu, um die bestmöglichen Platzierungen für Spielsitzungen an mehreren Standorten zu erreichen](queues-intro.md)
+ [Experimentiere mit der FlexMatch Spielerzuweisung, indem du einen Matchmaker und einen Regelsatz für dein Spiel erstellst](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-intro.html)
+ [Fangen Sie an, an der Funktionalität Ihres Spielclients und der Backend-Servicekomponenten zu arbeiten, damit Spieler Beitrittsanfragen stellen und sich direkt mit Spielsitzungen verbinden können](gamelift-sdk-client-api.md)
+ [Wenn Sie bereit sind, wechseln Sie zu einer vollständig integrierten Lösung](gamelift-roadmap-managed.md)

# Beispiele für Amazon GameLift Servers
<a name="getting-started-examples"></a>

Wenn du erwägst, deinen eigenen Spieleserver Amazon GameLift Servers zu verwalten, oder wenn du die Vorteile nutzen möchtest Amazon GameLift ServersRealtime, empfehlen wir dir, die folgenden Beispiele auszuprobieren, bevor du den Service für dein eigenes Spiel nutzt. Das Beispiel für einen benutzerdefinierten Spieleserver gibt dir Erfahrung mit dem Hosten von Spielen auf der Amazon GameLift Servers Konsole. Das Amazon GameLift Servers Realtime Beispiel zeigt dir, wie du ein Spiel für das Hosten mithilfe von Realtime Servern vorbereitest.

## Beispiel für einen benutzerdefinierten Spieleserver
<a name="gamelift-explore-deploycustomsample"></a>

Dieses Beispiel zeigt den Prozess der Bereitstellung eines Beispiel-Spielservers auf einer Amazon GameLift Servers verwalteten EC2 Flotte zum Hosten. Verwenden Sie den Beispiel-Spielclient, um eine Verbindung zu einer Live-Spielsitzung herzustellen. Sie erfahren, wie Sie Amazon GameLift Servers .tools, einschließlich der Konsole und der AWS CLI, verwenden können, um die Hosting-Leistung und -Nutzung der Flotte zu überwachen.

Das Beispiel führt Sie durch die folgenden Schritte:
+ Laden Sie den Beispiel-Spielserver-Build hoch.
+ Erstelle eine Flotte, um den Spielserver-Build auszuführen.
+ Holen Sie sich den Beispiel-Spielclient und verwenden Sie ihn, um eine Verbindung zu einem Spieleserver herzustellen und an einer Spielsitzung teilzunehmen.
+ Sieh dir die Statistiken zu Flotte und Spielsitzungen an.

Starte mehrere Spielclients und spiele das Spiel, um Hosting-Daten zu generieren. Verwende die Amazon GameLift Servers Konsole, um Hosting-Ressourcen einzusehen, Messwerte zu verfolgen und Optionen zur Skalierung der Hosting-Kapazität der Flotte zu erkunden.

Melden Sie sich zunächst bei der [Amazon GameLift ServersKonsole](https://console.aws.amazon.com/gamelift/sample-game) an. Gehen Sie in der linken Navigationsleiste zu **Ressourcen** und **probieren Sie ein Beispielspiel** aus.