Bereich erstellen

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:
  • Cloud Shell

    So starten Sie Cloud Shell:

    1. Rufen Sie die Google Cloud Console auf.

      Google Cloud Console

    2. Klicken Sie in der oberen rechten Ecke der Console auf die Schaltfläche Cloud Shell aktivieren:

    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:

    1. Erstellen Sie ein Dienstkonto:
    2. Laden Sie einen privaten Schlüssel als JSON-Datei herunter.
    3. Legen Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS auf den Pfad der JSON-Datei fest, die Ihre Anmeldedaten enthält. Diese Variable gilt nur für Ihre aktuelle Shell-Sitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable neu festlegen.

    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

  1. Rufen Sie in der Google Cloud Console die Seite Realms & Cluster auf.

    Zu Game Servers

  2. Klicken Sie auf Bereich erstellen.

  3. Geben Sie im Feld Bereichsname eine eindeutige Kennzeichnung für diesen Bereich ein.

  4. 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.

  5. 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

  1. Rufen Sie in der Google Cloud Console die Seite Realms & Cluster auf.

    Zu Game Servers

  2. 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

  1. Rufen Sie in der Google Cloud Console die Seite Realms & Cluster auf.

    Zu Game Servers

  2. Mit dem Filterfeld können Sie die Bereichsliste nach verschiedenen Attributen filtern.

  3. Klicken Sie in der letzten Tabellenspalte auf die drei Punkte 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