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.
# Fernzugriff auf Flottenressourcen
Sie können eine Verbindung zu jeder Instance in Ihren aktiven Amazon GameLift Servers verwalteten EC2- oder verwalteten Containerflotten herstellen. Bei Container-Flotten können Sie auch eine Verbindung zu einzelnen Containern herstellen, die auf einer Instance ausgeführt werden, um Spielsitzungen zu beheben, Protokolle zu überprüfen und Laufzeitprobleme zu debuggen. Zu den häufigsten Gründen für den Fernzugriff auf eine Instanz gehören:
+ Beheben Sie Probleme mit der Integration Ihres Spieleservers.
+ Optimiere deine Runtime-Konfiguration und andere flottenspezifische Einstellungen.
+ Überwachen Sie die Aktivitäten auf dem Spieleserver in Echtzeit, z. B. die Protokollierung.
+ Führen Sie Benchmarking-Tools anhand des tatsächlichen Spielerverkehrs aus.
+ Untersuchen Sie spezifische Probleme mit einer Spielsitzung oder einem Serverprozess.
Wenn du eine Verbindung zu einer Instanz herstellst, solltest du Folgendes beachten:
+ Sie können eine Verbindung zu jeder Instance in einer aktiven Flotte herstellen. Im Allgemeinen können Sie keine Verbindung zu inaktiven Flotten herstellen, z. B. zu Flotten, die gerade aktiviert werden oder sich in einem Fehlerstatus befinden. (Diese Flotten sind möglicherweise für einen kurzen Zeitraum nur begrenzt verfügbar.) Hilfe bei Problemen mit der Flottenaktivierung finden Sie unter[Debuggen von Amazon GameLift Servers-Flottenproblemen](fleets-creating-debug.md).
+ Die Verbindung zu einer aktiven Instance hat keinen Einfluss auf die Hosting-Aktivität der Instance. Die Instanz startet und stoppt weiterhin Serverprozesse auf der Grundlage der Laufzeitkonfiguration. Sie aktiviert und führt Spielsitzungen aus. Die Instanz wird möglicherweise als Reaktion auf ein Herunterskalierungsereignis oder ein anderes Ereignis heruntergefahren.
+ Alle Änderungen, die Sie an Dateien oder Einstellungen auf der Instanz vornehmen, können sich auf die aktiven Spielsitzungen der Instanz und auf die verbundenen Spieler auswirken.
# Connect zu Flotteninstanzen herstellen
Sie können eine Remoteverbindung zu jeder aktiven Amazon GameLift Servers verwalteten EC2- oder Managed Container Fleet-Instance herstellen, um Probleme mit dem Spielserver zu beheben, Logs zu überprüfen und das Laufzeitverhalten zu debuggen. Stellen Sie über die Amazon GameLift Servers Konsole oder die AWS CLI eine Verbindung her.
## Fernzugriff über die Konsole
Mit Amazon EC2 Systems Manager (SSM) können Sie direkt von der Amazon GameLift Servers Konsole aus eine Verbindung zu Flotteninstanzen herstellen. Diese Methode bietet sicheren Zugriff, ohne dass eine zusätzliche Einrichtung oder Verwaltung der Anmeldeinformationen erforderlich ist. Bei Container-Flotten können Sie nach dem Herstellen der Verbindung mit der Instance auf einzelne Container zugreifen, die darauf laufen. Weitere Informationen finden Sie unter [Connect zu Containern herstellen](containers-remote-access.md).
1. **Wählen Sie in der Amazon GameLift Servers Konsole im Navigationsbereich **Managed EC2** oder **Managed Containers** und dann Fleets aus.**
1. Wählen Sie die Flotten-ID aus, die die Instance enthält, auf die Sie zugreifen möchten.
1. Wählen Sie auf der Seite mit den Flottendetails den Tab **Instances**, um alle Compute-Instances für die Flotte anzuzeigen.
1. Wählen Sie die Instance aus, zu der Sie eine Verbindung herstellen möchten, und wählen Sie dann **Connect**. Daraufhin wird das Dialogfeld Mit Instanz Connect angezeigt, das Sie über die Details der Verbindung informiert und es Ihnen ermöglicht, das Skript anzuzeigen, das für die Verbindung mit Ihrer Instance verwendet wird. Bestätigen Sie, indem **Sie erneut Verbinden** wählen.
1. Wählen Sie im Verbindungsdialogfeld die Option **Ausführen**, um eine neue SSM-Sitzung zu erstellen. Das System authentifiziert Ihre Sitzung über den AWS Key Management Service (AWS KMS) und öffnet ein Terminal in Ihrem Browser.
**Anmerkung**
Konsolenbasierter Fernzugriff ist für Flotten verfügbar, auf denen das Server-SDK Version 5.x ausgeführt wird. Verwenden Sie für Flotten, auf denen frühere SDK-Versionen ausgeführt werden, die im folgenden Abschnitt beschriebene AWS CLI-Methode.
## Fernzugriff mit der AWS CLI
In den folgenden Anweisungen wird beschrieben, wie Sie mithilfe der AWS Befehlszeilenschnittstelle (CLI) eine Remoteverbindung zu einer Instance herstellen. Sie können mithilfe des AWS SDK auch programmatische Aufrufe tätigen, wie in der [Service-API-Referenz für Amazon GameLift Servers](https://docs.aws.amazon.com/gamelift/latest/apireference/) dokumentiert.
### Sammeln Sie Instanzdaten
Um eine Verbindung zu einer Amazon GameLift Servers verwalteten EC2-Flotteninstanz herzustellen, benötigen Sie die folgenden Informationen:
+ Die ID der Instance, zu der Sie eine Verbindung herstellen möchten. Sie können entweder die Instanz-ID oder den ARN verwenden.
+ das Server-SDK für die Amazon GameLift Servers Version, die auf der Instanz verwendet wird. Das Server-SDK ist in den Spiel-Build integriert, der auf der Instanz ausgeführt wird.
In den folgenden Anweisungen wird beschrieben, wie Sie diese Aufgaben mithilfe der AWS CLI ausführen. Sie müssen die Flotten-ID für die Instance kennen, zu der Sie eine Verbindung herstellen möchten.
1. **Rufen Sie den Computernamen ab.** Ruft eine Liste aller aktiven Computer in der Flotte ab. Rufen Sie [list-compute](https://docs.aws.amazon.com/cli/latest/reference/gamelift/list-compute.html) mit einer Flotten-ID oder einem ARN auf. Geben Sie für eine Flotte mit einem einzigen Standort nur die Flottenkennung an. Geben Sie für eine Flotte mit mehreren Standorten die Flottenkennung und einen Standort an. Gibt bei verwalteten EC2-Flotten eine Liste von Flotteninstanzen `list-compute` zurück, und die Eigenschaft `ComputeName` ist die Instance-ID. Suchen Sie den Computer, auf den Sie zugreifen möchten.
**Anforderung**
```
aws gamelift list-compute \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
--location sa-east-1
```
**Antwort**
```
{
"ComputeList": [
{
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"ComputeName": "i-0abc12d3e45fa6b78",
"IpAddress": "00.00.000.00",
"DnsName": "b08444ki909kvqu6zpw3is24x5pyz4b6m05i3jbxvpk9craztu0lqrbbrbnbkks.uwp57060n1k6dnlnw49b78hg1rw4rcz7.us-west-2.amazongamelift.com",
"ComputeStatus": "Active",
"Location": "sa-east-1",
"CreationTime": "2023-07-09T22:51:45.931000-07:00",
"OperatingSystem": "AMAZON_LINUX_2023",
"Type": "c4.large"
}
]
}
```
1. **Suchen Sie die Server-SDK-Version.** Um diese Informationen zu erhalten, müssen Sie nach dem Build suchen, das für die Flotte eingesetzt wird. Die Server-SDK-Version ist eine Build-Eigenschaft.
1. Rufen Sie [describe-fleet-attributes](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-attributes.html)mit einer Flotten-ID oder einem ARN an, um die Build-ID und den ARN der Flotte zu erhalten.
1. Rufen Sie [describe-build](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html) mit der Build-ID oder dem ARN auf, um die Server-SDK-Version des Builds abzurufen.
Beispiel:
**Anforderung**
```
aws gamelift describe-fleet-attributes \
--fleet-ids fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa
```
**Antwort**
```
{
"FleetAttributes": [
{
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"ComputeType": "EC2",
"BuildId": "build-3333cccc-44dd-55ee-66ff-00001111aa22",
. . .
}
]
}
```
**Anforderung**
```
aws gamelift describe-build \
--build-id build-3333cccc-44dd-55ee-66ff-00001111aa22
```
**Antwort**
```
"Build": {
"BuildId": "build-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
"Name": "My_Game_Server_Build_One",
"OperatingSystem": "AMAZON_LINUX_2023",
"ServerSdkVersion": "5.1.1",
. . .
}
```
## Connect zu einer Instanz herstellen (Server-SDK 5)
Wenn auf der Instance, zu der Sie eine Verbindung herstellen möchten, ein Game-Build mit Server-SDK Version 5.x ausgeführt wird, stellen Sie mithilfe von Amazon EC2 Systems Manager (SSM) eine Verbindung zu der Instance her. Sie können auf Remote-Instances zugreifen, die auf Windows oder Linux ausgeführt werden. Bei Container-Flotten können Sie nach dem Herstellen der Verbindung mit der Instance auf einzelne Container zugreifen, die darauf laufen. Weitere Informationen finden Sie unter [Connect zu Containern herstellen](containers-remote-access.md).
**Bevor Sie beginnen:**
Schließen Sie die SSM-Setup-Schritte ab und installieren Sie das SSM-Plugin auf Ihrem lokalen Computer. Weitere Informationen finden Sie unter [SSM einrichten](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-getting-started.html) und [das Session Manager-Plug-In für die AWS CLI installieren](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html) im *Amazon EC2 Systems Manager Manager-Benutzerhandbuch*.
1. **Fordern Sie Anmeldeinformationen für die Instance an.** Rufen Sie [get-compute-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-compute-access.html)mit der Flotten-ID und dem Computenamen für die Instance an, zu der Sie eine Verbindung herstellen möchten. Amazon GameLift Serversgibt einen Satz temporärer Anmeldeinformationen für den Zugriff auf die Instance zurück. Beispiel:
**Anforderung**
```
aws gamelift get-compute-access \
--compute-name i-11111111a222b333c \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa
--region us-west-2
```
**Antwort**
```
{
"ComputeName": "i-11111111a222b333c",
"Credentials": {
"AccessKeyId": "ASIAIOSFODNN7EXAMPLE",
"SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"SessionToken": "AQoDYXdzEJr..."
},
"FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"
}
```
1. **Exportieren Sie die Zugangsdaten (optional).** Sie können die Anmeldeinformationen in Umgebungsvariablen exportieren und sie verwenden, um die AWS CLI für den Standardbenutzer zu konfigurieren. Weitere Informationen finden Sie unter [Umgebungsvariablen zur Konfiguration der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html) im AWS Command Line Interface Benutzerhandbuch.
```
export AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_SESSION_TOKEN=AQoDYXdzEJr...
```
1. **Connect zur Flotteninstanz her.** Starten Sie eine SSM-Sitzung mit der Instance, zu der Sie eine Verbindung herstellen möchten. Geben Sie die AWS Region oder den Standort der Instanz an. Weitere Informationen, einschließlich der Einrichtung von SSM und des SSM-Plug-ins, finden Sie unter [Starten einer Sitzung (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html#sessions-start-cli) im *Amazon EC2 Systems Manager Manager-Benutzerhandbuch*.
Für die Anfrage zum Sitzungsstart werden automatisch die Anmeldeinformationen verwendet, die Sie in Schritt 1 erworben haben.
```
aws ssm start-session \
--target i-11111111a222b333c \
--region us-west-2 \
```
**Anmerkung**
Wenn Sie die Fehlermeldung „Zugriff verweigert“ erhalten, haben Sie möglicherweise eine `AWS_PROFILE` Umgebungsvariable auf ein AWS Profil gesetzt, was dazu führt, dass AWS CLI die falschen Anmeldeinformationen für den Remotezugriff verwendet. Um das Problem zu beheben, deaktivieren Sie vorübergehend Ihre `AWS_PROFILE` Umgebungsvariable. Alternativ können Sie ein benutzerdefiniertes AWS Profil für Ihre RAS-Anmeldeinformationen erstellen und den `--profile` Befehlszeilenparameter zu Ihrer `start-session` Anfrage hinzufügen.
## Stellen Sie eine Connect zu einer Instanz her (Server-SDK 4.x oder früher)
Wenn auf der Instance, zu der Sie eine Verbindung herstellen möchten, ein Spiel mit Server-SDK Version 4 oder früher ausgeführt wird, gehen Sie wie folgt vor. Sie können eine Verbindung zu Instances herstellen, auf denen entweder Windows oder Linux ausgeführt wird. Stellen Sie mithilfe eines RDP-Clients (Remote Desktop Protocol) eine Connect zu einer Windows-Instanz her. Stellen Sie mithilfe eines SSH-Clients eine Connect zu einer Linux-Instance her.
1. **Fordern Sie Anmeldeinformationen für die Instance an.** Wenn Sie eine Instanz-ID haben, verwenden Sie den Befehl, [get-instance-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-instance-access.html)um Zugangsdaten anzufordern. Wenn dies erfolgreich ist, gibt Amazon GameLift Servers das Betriebssystem, die IP-Adresse und einen Satz von Anmeldeinformationen (Benutzername und geheimer Schlüssel) für die Instance zurück. Das Format der Anmeldeinformationen ist vom Betriebssystem der Instance abhängig. Verwenden Sie die folgenden Anweisungen, um Anmeldeinformationen für RDP oder SSH abzurufen.
+ **Für Windows-Instanzen** — Um eine Verbindung zu einer Windows-Instanz herzustellen, benötigt RDP einen Benutzernamen und ein Passwort. Die `get-instance-access`-Anforderung gibt diese Werte als einfache Zeichenfolgen zurück. Daher können Sie die zurückgegebenen Werte unverändert verwenden. Beispiel für Anmeldeinformationen:
```
"Credentials": {
"Secret": "aA1bBB2cCCd3EEE",
"UserName": "gl-user-remote"
}
```
+ **Für Linux-Instances** — Um eine Verbindung zu einer Linux-Instance herzustellen, benötigt SSH einen Benutzernamen und einen privaten Schlüssel. Amazon GameLift Serversgibt private RSA-Schlüssel aus und gibt sie als einzelne Zeichenfolge zurück, wobei das Zeilenumbruchzeichen (`\n`) auf Zeilenumbrüche hinweist. Gehen Sie wie folgt vor, um den privaten Schlüssel nutzbar zu machen: (1) konvertieren Sie die Zeichenfolge in eine `.pem` Datei und (2) legen Sie die Berechtigungen für die neue Datei fest. Beispiel für zurückgegebene Anmeldeinformationen:
```
"Credentials": {
"Secret": "-----BEGIN RSA PRIVATE KEY-----nEXAMPLEKEYKCAQEAy7WZhaDsrA1W3mRlQtvhwyORRX8gnxgDAfRt/gx42kWXsT4rXE/b5CpSgie/\nvBoU7jLxx92pNHoFnByP+Dc21eyyz6CvjTmWA0JwfWiW5/akH7iO5dSrvC7dQkW2duV5QuUdE0QW\nZ/aNxMniGQE6XAgfwlnXVBwrerrQo+ZWQeqiUwwMkuEbLeJFLhMCvYURpUMSC1oehm449ilx9X1F\nG50TCFeOzfl8dqqCP6GzbPaIjiU19xX/azOR9V+tpUOzEL+wmXnZt3/nHPQ5xvD2OJH67km6SuPW\noPzev/D8V+x4+bHthfSjR9Y7DvQFjfBVwHXigBdtZcU2/wei8D/HYwIDAQABAoIBAGZ1kaEvnrqu\n/uler7vgIn5m7lN5LKw4hJLAIW6tUT/fzvtcHK0SkbQCQXuriHmQ2MQyJX/0kn2NfjLV/ufGxbL1\nmb5qwMGUnEpJaZD6QSSs3kICLwWUYUiGfc0uiSbmJoap/GTLU0W5Mfcv36PaBUNy5p53V6G7hXb2\nbahyWyJNfjLe4M86yd2YK3V2CmK+X/BOsShnJ36+hjrXPPWmV3N9zEmCdJjA+K15DYmhm/tJWSD9\n81oGk9TopEp7CkIfatEATyyZiVqoRq6k64iuM9JkA3OzdXzMQexXVJ1TLZVEH0E7bhlY9d8O1ozR\noQs/FiZNAx2iijCWyv0lpjE73+kCgYEA9mZtyhkHkFDpwrSM1APaL8oNAbbjwEy7Z5Mqfql+lIp1\nYkriL0DbLXlvRAH+yHPRit2hHOjtUNZh4Axv+cpg09qbUI3+43eEy24B7G/Uh+GTfbjsXsOxQx/x\np9otyVwc7hsQ5TA5PZb+mvkJ5OBEKzet9XcKwONBYELGhnEPe7cCgYEA06Vgov6YHleHui9kHuws\nayav0elc5zkxjF9nfHFJRry21R1trw2Vdpn+9g481URrpzWVOEihvm+xTtmaZlSp//lkq75XDwnU\nWA8gkn6O3QE3fq2yN98BURsAKdJfJ5RL1HvGQvTe10HLYYXpJnEkHv+Unl2ajLivWUt5pbBrKbUC\ngYBjbO+OZk0sCcpZ29sbzjYjpIddErySIyRX5gV2uNQwAjLdp9PfN295yQ+BxMBXiIycWVQiw0bH\noMo7yykABY7Ozd5wQewBQ4AdSlWSX4nGDtsiFxWiI5sKuAAeOCbTosy1s8w8fxoJ5Tz1sdoxNeGs\nArq6Wv/G16zQuAE9zK9vvwKBgF+09VI/1wJBirsDGz9whVWfFPrTkJNvJZzYt69qezxlsjgFKshy\nWBhd4xHZtmCqpBPlAymEjr/TOlbxyARmXMnIOWIAnNXMGB4KGSyl1mzSVAoQ+fqR+cJ3d0dyPl1j\njjb0Ed/NY8frlNDxAVHE8BSkdsx2f6ELEyBKJSRr9snRAoGAMrTwYneXzvTskF/S5Fyu0iOegLDa\nNWUH38v/nDCgEpIXD5Hn3qAEcju1IjmbwlvtW+nY2jVhv7UGd8MjwUTNGItdb6nsYqM2asrnF3qS\nVRkAKKKYeGjkpUfVTrW0YFjXkfcrR/V+QFL5OndHAKJXjW7a4ejJLncTzmZSpYzwApc=\n-----END RSA PRIVATE KEY-----",
"UserName": "gl-user-remote"
}
```
Wenn Sie die AWS CLI verwenden, können Sie automatisch eine `.pem` Datei generieren, indem Sie die Parameter *--query* und *--output* in Ihre `get-instance-access` Anfrage aufnehmen.
Um für die `.pem`-Datei Berechtigungen festzulegen, führen Sie den folgenden Befehl aus:
```
$ chmod 400 MyPrivateKey.pem
```
1. **Öffnen Sie einen Port für die Remote-Verbindung.** Sie können über jeden in der Amazon GameLift Servers Flottenkonfiguration autorisierten Port auf Instances in Flotten zugreifen. Sie können die Port-Einstellungen einer Flotte mit dem Befehl [https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-port-settings.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-port-settings.html) anzeigen.
Als bewährte Methode wird empfohlen, Ports für den Remote-Zugriff nur zu öffnen, wenn Sie diese benötigen, und sie zu schließen, wenn Sie diese nicht mehr benötigen. Sie können die Porteinstellungen nicht aktualisieren, nachdem Sie eine Flotte erstellt haben, sondern bevor sie aktiv ist. Wenn Sie nicht weiterkommen, erstellen Sie die Flotte mit geöffneten Porteinstellungen neu.
Verwenden Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-port-settings.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-port-settings.html), um eine Port-Einstellung für die Remote-Verbindung hinzuzufügen (z. B. `22` für SSH oder `3389` für RDP). Geben Sie als Wert für den IP-Adressbereich die IP-Adressen für die Geräte an, die Sie verwenden möchten, um eine Verbindung herzustellen (in das CIDR-Format konvertiert). Beispiel:
```
$ AWS gamelift update-fleet-port-settings
--fleet-id "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"
--inbound-permission-authorizations "FromPort=22,ToPort=22,IpRange=54.186.139.221/32,Protocol=TCP"
```
Das folgende Beispiel öffnet Port 3389 auf einer Windows-Flotte
```
$ AWS gamelift update-fleet-port-settings
--fleet-id "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"
--inbound-permission-authorizations "FromPort=3389,ToPort=3389,IpRange=54.186.139.221/32,Protocol=TCP"
```
1. **Öffnen Sie einen Remote-Verbindungs-Client.** Verwenden Sie Remote Desktop für Windows-Instances oder SSH für Linux-Instances. Stellen Sie die Verbindung mit der Instance unter Verwendung von IP-Adresse, Port-Einstellung und Anmeldeinformationen her.
SSH-Beispiel:
```
ssh -i MyPrivateKey.pem gl-user-remote@192.0.2.0
```
## Dateien auf Remote-Instances anzeigen
Sobald Sie mit einer Flotteninstanz verbunden sind, haben Sie vollen Benutzer- und Administratorzugriff. Das bedeutet, dass Sie auch Fehler oder Ausfälle beim Hosten von Spielen verursachen können. Wenn die Instanz Spiele mit aktiven Spielern hostet, besteht die Gefahr, dass Spielsitzungen abstürzen und Spieler fallen gelassen werden oder dass das Herunterfahren von Spielen unterbrochen wird, was zu Fehlern in den gespeicherten Spieldaten und Protokollen führen kann.
Für Container-Flotten gelten nach dem Zugriff auf den Container (siehe[Connect zu Containern herstellen](containers-remote-access.md)) die folgenden Dateispeicherorte innerhalb des Container-Dateisystems. Für EC2-Flotten gelten diese Dateispeicherorte direkt für die Instance.
Suchen Sie auf einer Hosting-Instance nach diesen Ressourcen:
+ **Build-Dateien von Spielen.** Bei diesen Dateien handelt es sich um den Spiel-Build, in den Sie hochgeladen habenAmazon GameLift Servers. Sie enthalten eine oder mehrere ausführbare Dateien, Ressourcen und Abhängigkeiten des Spielservers. Die Build-Dateien des Spiels befinden sich in einem Stammverzeichnis mit dem Namen: `game`
+ Bei Windows: `c:\game`
+ Bei Linux: `/local/game`
+ **Protokolldateien von Spielen.** Suchen Sie die Protokolldateien, die Ihr Spieleserver generiert, im `game` Stammverzeichnis in dem von Ihnen angegebenen Verzeichnispfad.
+ **Hosting-Ressourcen von Amazon GameLift Servers.** Das Stammverzeichnis `Whitewater` enthält Dateien, die vom Amazon GameLift Servers Dienst zur Verwaltung der Spielhosting-Aktivitäten verwendet werden. Verändern Sie diese Dateien aus keinem Grund.
+ **Laufzeitkonfiguration.** Greifen Sie nicht auf die Laufzeitkonfiguration für einzelne Instanzen zu. Um Änderungen an einer Laufzeitkonfigurationseigenschaft vorzunehmen, aktualisieren Sie die Laufzeitkonfiguration der Flotte (siehe den AWS SDK-Vorgang [UpdateRuntimeConfiguration](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateRuntimeConfiguration.html)oder den AWS CLI [update-runtime-configuration](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-runtime-configuration.html)).
+ **Flottendaten.** Eine JSON-Datei enthält Informationen über die Flotte, zu der die Instance gehört, zur Verwendung durch Serverprozesse, die auf der Instance ausgeführt werden. Die JSON-Datei befindet sich am folgenden Speicherort:
+ Bei Windows: `C:\GameMetadata\gamelift-metadata.json`
+ Bei Linux: `/local/gamemetadata/gamelift-metadata.json`
+ **TLS-Zertifikate.** Wenn sich die Instanz auf einer Flotte befindet, für die die Generierung von TLS-Zertifikaten aktiviert ist, suchen Sie am folgenden Speicherort nach Zertifikatsdateien, einschließlich des Zertifikats, der Zertifikatskette, des privaten Schlüssels und des Stammzertifikats:
+ Bei Windows: `c:\\GameMetadata\Certificates`
+ Bei Linux: `/local/gamemetadata/certificates/`
# Connect zu Containern herstellen
Bei Amazon GameLift Servers Container-Flotten kannst du auf Gameserver-Container zugreifen, die auf einer Flotteninstanz laufen. Verwenden Sie den Container-Zugriff, um Spielsitzungen zu beheben, Protokolle zu überprüfen und Laufzeitprobleme zu debuggen.
## Stellen Sie eine Connect zu einem Container her
**Bevor Sie beginnen:**
Connect zur Flotteninstanz her. Detaillierte Anweisungen finden Sie unter [Connect zu Flotteninstanzen herstellen](fleets-remote-access.md).
Führen Sie den folgenden Befehl aus, um die auf der Instance laufenden Container aufzulisten:
```
sudo docker ps
```
In der Ausgabe werden alle Container aufgeführt, die auf der Instance ausgeführt werden, einschließlich Spieleserver-Container und interner Amazon GameLift Servers Container. Suchen Sie nach Containern mit Ihrem Gameserver-Image, um die Gameserver-Container zu identifizieren.
**Beispielausgabe:**
```
CONTAINER ID IMAGE COMMAND CREATED STATUS
b9676e9489f5 game-server-container "/bin/sh -c ./$GAME_…" 2 days ago Up 2 days
1d1c8443efe2 support-container "/bin/sh -c ./$SUPPO…" 2 days ago Up 2 days
```
Um eine Verbindung zu einem Spieleserver-Container herzustellen, verwende die kurze Container-ID aus der `CONTAINER ID` Spalte. Dadurch erhältst du vollen Lese- und Schreibzugriff auf das Container-Dateisystem.
```
sudo docker exec -it container-short-id sh
```
## Stellen Sie über die Konsole eine Connect zu einem Container her
Mit Amazon EC2 Systems Manager (SSM) können Sie von der Amazon GameLift Servers Konsole aus eine Verbindung zu Spieleserver-Containern herstellen. Diese Methode bietet sicheren Zugriff, ohne dass eine zusätzliche Einrichtung oder Verwaltung der Anmeldeinformationen erforderlich ist. Sie können entweder über die Registerkarte „**Computer“ oder die Registerkarte „**Spielsitzungen****“ auf der Seite mit den Flottendetails eine Verbindung zu einem Container herstellen.
1. Wählen Sie in der Amazon GameLift Servers Konsole im Navigationsbereich **Verwaltete Container** und dann **Flotten** aus.
1. Wählen Sie die Flotten-ID aus, die den Container oder die Spielsitzung enthält, auf die Sie zugreifen möchten.
1. Wähle auf der Seite mit den Flottendetails einen der folgenden Tabs:
+ **Berechnet** — Listet die Container auf, die auf der Flotte laufen. Wählen Sie den Container aus, zu dem Sie eine Verbindung herstellen möchten.
+ **Spielsitzungen** — Listet die Spielsitzungen für die Flotte auf. Wählen Sie die Spielsitzung aus, um eine Verbindung zu dem Container herzustellen, der sie hostet.
1. Wählen Sie **Connect** aus. Kopieren Sie den angezeigten Befehl, um Connect dem Container herzustellen, und wählen Sie dann erneut **Verbinden**.
1. Wählen Sie im Verbindungsdialogfeld die Option **Ausführen** aus, um eine neue SSM-Sitzung zu erstellen. Das System authentifiziert Ihre Sitzung über den AWS Key Management Service (AWS KMS) und öffnet ein Terminal in Ihrem Browser.
1. Sobald Sie eine Verbindung mit der Instance hergestellt haben, fügen Sie den Docker-Befehl aus Schritt 4 ein und führen Sie ihn auf der Instance aus, um auf den Container zuzugreifen.
## Connect zum Container her, der eine Spielsitzung hostet
Gehen Sie wie folgt vor, um eine Verbindung zum Gameserver-Container herzustellen, der eine bestimmte Spielsitzung hostet.
1. **Ermitteln Sie den Computernamen.** Rufen Sie [describe-game-sessions](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-game-sessions.html)an, um das `ComputeName` für die Spielsitzung zu erhalten.
**Anforderung**
```
aws gamelift describe-game-sessions \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
--game-session-id arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/gs-1111aaaa-2222-3333-4444-5555bbbb66cc
```
**Antwort**
```
{
"GameSessions": [
{
"GameSessionId": "arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/gs-1111aaaa-2222-3333-4444-5555bbbb66cc",
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"ComputeName": "62c5ff7f7a9a445d84877074c80aeafc",
"Status": "ACTIVE",
. . .
}
]
}
```
Notieren Sie sich den `ComputeName` Wert aus der Antwort (z. B.`62c5ff7f7a9a445d84877074c80aeafc`).
1. **Rufen Sie Rechenzugriff und Containerattribute ab.** Rufen Sie [get-compute-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-compute-access.html)mit der Flotten-ID und dem Compute-Namen an.
Die Antwort umfasst die folgenden Felder:
+ `ContainerIdentifiers`— Das `ContainerName` und `ContainerRuntimeId` für jeden Container.
+ `GameServerContainerGroupDefinitionArn`— Der ARN der Container-Gruppendefinition.
+ `Credentials`— Temporäre Anmeldeinformationen für die Verbindung mit der Instance.
**Anforderung**
```
aws gamelift get-compute-access \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
--compute-name 62c5ff7f7a9a445d84877074c80aeafc
```
**Antwort**
```
{
"ComputeName": "62c5ff7f7a9a445d84877074c80aeafc",
"ContainerIdentifiers": [
{
"ContainerName": "game-server",
"ContainerRuntimeId": "02accb92cd9bef3373300e7151d5c2b3dcca3b06eff1bb4e345085fc008d4678"
}
],
"Credentials": {
"AccessKeyId": "ASIAIOSFODNN7EXAMPLE",
"SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"SessionToken": "AQoDYXdzEJr..."
},
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"GameServerContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2::containergroupdefinition/MyGameServerGroup"
}
```
1. **Stellen Sie eine Verbindung zur Instance her.** Verwenden Sie die Anmeldeinformationen aus Schritt 2, um eine Verbindung zur Flotteninstanz herzustellen. Detaillierte Anweisungen finden Sie unter [Connect zu Flotteninstanzen herstellen](fleets-remote-access.md).
1. **Suchen Sie den Namen des Spielserver-Containers.** Rufen Sie [describe-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-container-group-definition.html)mit dem `GameServerContainerGroupDefinitionArn` aus Schritt 2 stammenden Code auf, um den Namen des Gameserver-Containers zu identifizieren.
**Anforderung**
```
aws gamelift describe-container-group-definition \
--name arn:aws:gamelift:us-west-2::containergroupdefinition/MyGameServerGroup
```
**Antwort**
```
{
"ContainerGroupDefinition": {
"ContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2:123456789012:containergroupdefinition/MyGameServerGroup:3",
"Name": "MyGameServerGroup",
"ContainerGroupType": "GAME_SERVER",
"GameServerContainerDefinition": {
"ContainerName": "game-server",
. . .
},
. . .
}
}
```
Notieren Sie sich den `GameServerContainerDefinition.ContainerName` Wert (zum Beispiel`game-server`).
1. **Identifizieren Sie die Laufzeit-ID des Spielserver-Containers.** Suchen Sie anhand des Namens des Spieleserver-Containers aus dem vorherigen Schritt `ContainerIdentifiers` nach dem passenden Eintrag in der `get-compute-access` Antwort aus Schritt 2. Notieren Sie sich den `ContainerRuntimeId`-Wert.
1. **Connect zum Container her.** Verwenden Sie die `ContainerRuntimeId` als Container-ID und führen Sie den folgenden Befehl aus:
```
sudo docker exec -it 02accb92cd9bef3373300e7151d5c2b3dcca3b06eff1bb4e345085fc008d4678 sh
```