Auf dieser Seite wird erläutert, wie Sie Game Servers-Bereiche erstellen, auflisten, beschreiben und aktualisieren. Ein Bereich ist eine benutzerdefinierte Gruppierung von Gameserver-Clustern, die auf den Latenzanforderungen des Spiels für die Anzahl an Spielern basiert.
Hinweis
Bevor Sie beginnen, sollten Sie sich mit den wichtigsten Konzepten in der Übersicht über Game Servers vertraut machen. Führen Sie außerdem die folgenden Aufgaben aus:
- Prüfen Sie, ob die Game Services API aktiviert ist. Game Services API aktivieren
- Wählen Sie entweder eine Shell mit installierter gcloud-CLI aus oder verwenden Sie einen API-Client:
Rufen Sie die Google Cloud Console auf.
Klicken Sie in der oberen rechten Ecke der Console auf die Schaltfläche Cloud Shell aktivieren:
- Erstellen Sie ein Dienstkonto:
- Laden Sie einen privaten Schlüssel als JSON-Datei herunter.
-
Set the environment variable
GOOGLE_APPLICATION_CREDENTIALS
to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.
Cloud Shell
So starten Sie Cloud Shell:
In einem Frame im unteren Teil der Console wird eine Cloud Shell-Sitzung geöffnet.
Mit dieser Shell führen Sie gcloud
-Befehle aus.
Lokale Shell
Installieren Sie die gcloud CLI.
Prüfen Sie, ob Sie das gewünschte Standardprojekt für die Google Cloud CLI festgelegt haben. Andernfalls müssen Sie das Flag --project
später für jeden Befehl explizit angeben:
gcloud config list project
Wenn Sie den folgenden Befehl nicht ausführen können, um ein Standardprojekt festzulegen, ersetzen Sie PROJECT_ID
durch Ihre gewünschte Projekt-ID:
gcloud config set project PROJECT_ID
Führen Sie den folgenden Befehl aus, um Ihre Version der Google Cloud CLI zu prüfen.
Für Game Servers ist mindestens die Version 306.0.0
der gcloud CLI erforderlich.
gcloud version
Aktualisieren Sie Ihre Installation mit dem folgenden Befehl:
gcloud components update
curl / PowerShell
So verwenden Sie die REST API mit curl
oder Windows PowerShell:
Clientbibliothek
Google Cloud Game Servers können mithilfe einer Clientbibliothek programmatisch gesteuert werden. Wie Sie die Bibliothek und die Authentifizierung verwenden, erfahren Sie in der Übersicht zu Clientbibliotheken.
Bereich erstellen
Bereiche können global oder regional sein. Ein globaler Bereich ist eine gute Option, wenn die in einem Bereich registrierten Cluster aus Regionen stammen, die sich über verschiedene geografische Standorte erstrecken, z. B. Nordamerika und Südamerika oder Europa und Asien. Ein regionaler Bereich ist eine gute Option, wenn sich Cluster in derselben Region befinden, z. B. Westeuropa. Bei einem Netzwerkausfall zwischen Regionen kann ein globaler Bereich Cluster möglicherweise nicht in jeder Region verwalten. Um die Ausfallsicherheit zwischen Regionen zu erhöhen, sollten Sie regionale Bereiche in Regionen erstellen, die den entsprechenden Gameserver-Clustern so nah wie möglich sind.
Wenn Sie beispielsweise Cluster in den Regionen europe-west1
, europe-west2
und europe-west3
erstellen, um Nutzer im westlichen Europa zu bedienen, können Sie auch einen regionalen Bereich in einer dieser Regionen erstellen. Mit dieser Konfiguration kann der Bereich weiter Cluster verwalten, falls diese Regionen aufgrund eines Netzwerkausfalls aus anderen Regionen der Welt nicht erreichbar sind.
Wenn Sie nicht sicher sind, wo Sie Ihren Bereich erstellen sollten, können Sie ihn als globalen Bereich erstellen. Wenn sich Ihre Anforderungen ändern, können Sie ein neues Feld in einer Region erstellen, die näher an den zu verwaltenden Clustern liegt. Anschließend können Sie vorhandene Cluster in den neuen regionalen Bereich verschieben, wenn Sie zuerst Cluster aus dem globalen Bereich löschen und abmelden und anschließend´im neuen Bereich registrieren.
Console
Rufen Sie in der Google Cloud Console die Seite Realms & Cluster auf.
Klicken Sie auf Bereich erstellen.
Geben Sie im Feld Bereichsname eine eindeutige Kennzeichnung für diesen Bereich ein.
Wählen Sie im Feld Zeitzone eine Zeitzone für diesen Bereich aus. Wenn Sie zeitbasierte Ereignisse wie Skalierungsrichtlinien planen, gilt das für diese Zeitzone.
Klicken Sie auf Erstellen.
gcloud
Sie können Bereiche über die Google Cloud CLI erstellen. Führen Sie den folgenden Befehl aus, um einen globalen Bereich zu erstellen, und ersetzen Sie die Platzhalterwerte wie realmID durch die entsprechenden Werte:
gcloud game servers realms create realmID --time-zone tz
Führen Sie den folgenden Befehl aus, um einen regionalen Bereich zu erstellen und ersetzen Sie die Platzhalterwerte wie realmID durch die entsprechenden Werte:
gcloud game servers realms create realmID --time-zone tz --location=region
Die Variablenplatzhalter entsprechen den folgenden Beschreibungen:
- realmID ist eine eindeutige Kennung, die Sie für diesen Bereich angeben können.
- tz ist die Zeitzone für diesen Bereich. Wenn Sie zeitbasierte Ereignisse wie Skalierungsrichtlinien planen, gilt das für diese Zeitzone.
- region ist die Region für den Bereich. Wenn Sie fehlerhafte Domains steuern möchten, geben Sie eine Region an. Wir empfehlen Ihnen, einen globalen Bereich zu erstellen und diese Option auszulassen.
REST UND BEFEHLSZEILE
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
- PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist.
- LOCATION: die Region für den Bereich. Wenn Sie fehlerhafte Domains steuern möchten, geben Sie eine Region aus der Liste der unterstützten Standorte an.
Wir empfehlen, einen
global
-Bereich anzugeben. - REALM_ID: eine benutzerdefinierte Kennung für den neuen Bereich
- TIME_ZONE: die Zeitzone für diesen Bereich (z. B.
US/Eastern
). Sie planen zeitbasierte Ereignisse wie Skalierungsrichtlinien für diese Zeitzone.
JSON-Text der Anfrage:
{ "timeZone": "TIME_ZONE" }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Bereiche auflisten
Console
Rufen Sie in der Google Cloud Console die Seite Realms & Cluster auf.
Mit dem Filterfeld können Sie die Bereichsliste nach verschiedenen Attributen filtern.
REST UND BEFEHLSZEILE
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
- PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist.
- LOCATION: Region für den Bereich oder
global
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "realms": [ { "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm1", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "timeZone": "US/Eastern", "etag": "PlXtLrUJ5pHQoZk0Lz-pWkPFN_dt3PXhIpRrJ5HHWu8" }, { "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm2", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "timeZone": "America/Eirunepe", "etag": "ay1tXqeujLSsSd93n6uhlZwlxdNTOfG7El992Tsiz98" }, { "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm3", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "timeZone": "Asia/Anadyr", "etag": "cBxzV2AWK_zgijSmYA-oXPWv3giwhUzssoWcqjPZFuk" } ] }
gcloud
Sie können globale oder regionale Bereiche mithilfe der Google Cloud CLI auflisten.
Führen Sie den folgenden Befehl aus, um sowohl globale als auch regionale Bereiche aufzulisten:
gcloud game servers realms list
Führen Sie den folgenden Befehl aus und ersetzen Sie region durch global
oder eine Google Cloud-Region, um Bereiche an einem bestimmten Standort aufzulisten:
gcloud game servers realms list --location=region
Bereiche beschreiben
Console
Rufen Sie in der Google Cloud Console die Seite Realms & Cluster auf.
Mit dem Filterfeld können Sie die Bereichsliste nach verschiedenen Attributen filtern.
Klicken Sie in der letzten Tabellenspalte auf die drei Punkte more_vert und wählen Sie Details ansehen aus.
gcloud
Mit der Google Cloud CLI können Sie Details zu einem Bereich abrufen, z. B. die Erstellungszeit oder Zeitzone.
Führen Sie den folgenden Befehl aus, um einen globalen Bereich zu beschreiben, und ersetzen Sie realmID durch die ID für einen von Ihnen erstellten Bereich:
gcloud game servers realms describe realmID
Wenn Sie einen oder mehrere Bereiche erstellt haben, die nicht global sind, können Sie Details eines Bereichs in einer bestimmten Region beschreiben. Zum Beschreiben eines Bereichs in einer Region ersetzen Sie realmID durch die ID für einen von Ihnen erstellten Bereich und region durch die Region, in dem sich der Bereich befindet:
gcloud game servers realms describe realmID --location=region
REST UND BEFEHLSZEILE
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
- PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist.
- LOCATION: Region für den Bereich oder
global
- REALM_ID: eine benutzerdefinierte Kennung für den Bereich
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "timeZone": "Asia/Anadyr", "etag": "cBxzV2AWK_zgijSmYA-oXPWv3giwhUzssoWcqjPZFuk" }
Bereich aktualisieren
gcloud
Führen Sie den Befehl gcloud game servers realms
update
aus, nachdem Sie realmID und region für einen vorhandenen Bereich ersetzt haben, um ein Feld für einen Bereich zu aktualisieren. Mit dem folgenden Befehl wird der Zeitzonenwert für einen Bereich aktualisiert. Ersetzen Sie tz durch einen unterstützten Zeitzonenwert.
gcloud game servers realms update realmID --location=region \ --time-zone=tz --no-dry-run
Die Flags für andere Bereichsfelder finden Sie in der gcloud
-Referenz.
REST UND BEFEHLSZEILE
Im folgenden Beispiel wird das Feld timeZone
aktualisiert. Zum Aktualisieren anderer Felder fügen Sie die Feldnamen zum Abfrageparameter ?updateMask=
und zum JSON-Text der Anfrage hinzu.
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
- PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
- LOCATION: die Region für den Bereich.
- REALM_ID: die benutzerdefinierte Kennung für den Bereich
- TIME_ZONE: die aktualisierte Zeitzone für diesen Bereich (z. B.
US/Eastern
). Sie planen zeitbasierte Ereignisse wie Skalierungsrichtlinien für diese Zeitzone.
JSON-Text der Anfrage:
{ "timeZone": "TIME_ZONE" }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Weitere Informationen
- Cluster registrieren
- Hier erfahren Sie, wie Sie einen Bereich löschen