Deployment erstellen

Auf dieser Seite wird erläutert, wie Sie Game Servers-Bereitstellungen erstellen, auflisten, beschreiben und aktualisieren. Eine Bereitstellung verwaltet eine oder mehrere Softwareversionen, die Sie für jeden oder alle Bereiche bereitstellen können. Ein End-to-End-Beispiel als Anleitung zum Erstellen eines Deployments, zum Hinzufügen einer Konfiguration und zum anschließenden Rollout finden Sie unter Verhalten der Clusterskalierung konfigurieren.

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.

   Beispiel: Linux oder macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihre Anmeldedaten enthält.

   Beispiel:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Beispiel: Windows

   Für PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihre Anmeldedaten enthält.

   Beispiel:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Für Eingabeaufforderung:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihre Anmeldedaten enthält.

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.

Deployment erstellen

Console

1. Rufen Sie in der Google Cloud Console die Seite Bereitstellungen von Game Server auf.

   Zu Game Servers

2. Klicken Sie auf Deployment erstellen.

3. Geben Sie im Feld Name eine eindeutige ID für diese Bereitstellung ein.

4. (Optional) Geben Sie im Feld Beschreibung eine Beschreibung für dieses Deployment ein.

5. Klicken Sie auf Erstellen.

gcloud

Sie können eine Bereitstellung mit der Google Cloud CLI erstellen.

Führen Sie zum Erstellen einer Bereitstellung den folgenden Befehl aus und ersetzen Sie deploymentID durch einen geeigneten Wert:

gcloud game servers deployments create deploymentID

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
• DEPLOYMENT_ID: eine benutzerdefinierte Kennung für das Deployment

JSON-Text der Anfrage:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

1. Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Kopieren Sie den folgenden Befehl und führen Sie ihn im Terminal aus, um diese Datei zu erstellen.
   Hinweis: Mit dem folgenden Befehl werden alle request.json-Dateien im aktuellen Verzeichnis überschrieben.

   cat > request.json << 'EOF'
   {
     "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
   }
   EOF

2. Führen Sie im Terminal folgenden Befehl aus. Es verweist auf die request.json-Datei, die Sie gerade erstellt haben.

   curl -X POST \
   -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
   -H "Content-Type: application/json; charset=utf-8" \
   -d @request.json \
   "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments?deploymentId=DEPLOYMENT_ID"

PowerShell (Windows)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

1. Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Kopieren Sie den folgenden Befehl und führen Sie ihn im Terminal aus, um diese Datei zu erstellen.
   Hinweis: Mit dem folgenden Befehl werden alle request.json-Dateien im aktuellen Verzeichnis überschrieben.

   @'
   {
     "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

2. Führen Sie im Terminal folgenden Befehl aus. Es verweist auf die request.json-Datei, die Sie gerade erstellt haben.

   $cred = gcloud auth application-default print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
     -Method POST `
     -Headers $headers `
     -ContentType: "application/json; charset=utf-8" `
     -InFile request.json `
     -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments?deploymentId=DEPLOYMENT_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Deployments auflisten

Console

1. Rufen Sie in der Google Cloud Console die Seite Bereitstellungen von Game Server auf.

   Zu Game Servers

2. Mit dem Filterfeld können Sie die Deploymentliste nach unterschiedlichen Attributen filtern.

gcloud

Sie können Bereitstellungen über die Google Cloud CLI auflisten.

Führen Sie den folgenden Befehl aus, um Bereitstellungen aufzulisten:

gcloud game servers deployments list

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

Führen Sie folgenden Befehl aus:

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments"

PowerShell (Windows)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "gameServerDeployments": [
    {
      "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-1",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A"
    },
    {
      "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-2",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "etag": "az38kwIY4X3WdP2SA0fkTGib9hwVj7iXLFXAtIzMLpc"
    }
  ]
}

Deployment beschreiben

Console

1. Rufen Sie in der Google Cloud Console die Seite Bereitstellungen von Game Server auf.

   Zu Game Servers

2. Mit dem Filterfeld können Sie die Deploymentliste nach unterschiedlichen Attributen filtern.

3. Klicken Sie in der letzten Tabellenspalte auf die drei Punkte und wählen Sie Konfigurationen auflisten aus. Auf dieser Seite können Sie die aktiven und inaktiven Konfigurationen für das Deployment aufrufen.

4. Klicken Sie zum Erstellen einer neuen Konfiguration für das Deployment auf Konfiguration erstellen. Klicken Sie zum Aktualisieren des Rollouts auf Einführung verwalten.

gcloud

Mit der Google Cloud CLI können Sie Details zu einer Bereitstellung abrufen, z. B. den Erstellungs- oder Aktualisierungszeitpunkt.

Führen Sie den folgenden Befehl aus, um eine Bereitstellung zu beschreiben und ersetzen Sie deploymentID durch die ID einer Bereitstellung, die Sie zuvor erstellt haben:

gcloud game servers deployments describe deploymentID

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
• DEPLOYMENT_ID: die benutzerdefinierte Kennung für das Deployment

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

Führen Sie folgenden Befehl aus:

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID"

PowerShell (Windows)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "createTime": CREATE_TIME,
  "updateTime": UPDATE_TIME,
  "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A"
}

Deployment aktualisieren

gcloud

Führen Sie den Befehl gcloud game servers deployments update aus, nachdem Sie die deploymentID für eine vorhandene Bereitstellung ersetzt haben, um das Feld für eine Bereitstellung zu aktualisieren. Mit dem folgenden Befehl wird das Beschreibungsfeld für eine Bereitstellung aktualisiert.

gcloud game servers deployments update deploymentID --description="My updated description"

Die Flags für andere Bereitstellungsfelder finden Sie in der gcloud-Referenz.

REST UND BEFEHLSZEILE

Im folgenden Beispiel wird das Feld description 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
• DEPLOYMENT_ID: die benutzerdefinierte Kennung für das Deployment

JSON-Text der Anfrage:

{
  "description": "My updated description"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

1. Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Kopieren Sie den folgenden Befehl und führen Sie ihn im Terminal aus, um diese Datei zu erstellen.
   Hinweis: Mit dem folgenden Befehl werden alle request.json-Dateien im aktuellen Verzeichnis überschrieben.

   cat > request.json << 'EOF'
   {
     "description": "My updated description"
   }
   EOF

2. Führen Sie im Terminal folgenden Befehl aus. Es verweist auf die request.json-Datei, die Sie gerade erstellt haben.

   curl -X PATCH \
   -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
   -H "Content-Type: application/json; charset=utf-8" \
   -d @request.json \
   "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID?updateMask=description"

PowerShell (Windows)

Hinweis: Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest.

1. Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Kopieren Sie den folgenden Befehl und führen Sie ihn im Terminal aus, um diese Datei zu erstellen.
   Hinweis: Mit dem folgenden Befehl werden alle request.json-Dateien im aktuellen Verzeichnis überschrieben.

   @'
   {
     "description": "My updated description"
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

2. Führen Sie im Terminal folgenden Befehl aus. Es verweist auf die request.json-Datei, die Sie gerade erstellt haben.

   $cred = gcloud auth application-default print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
     -Method PATCH `
     -Headers $headers `
     -ContentType: "application/json; charset=utf-8" `
     -InFile request.json `
     -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID?updateMask=description" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Weitere Informationen

• Konfiguration erstellen
• Weitere Informationen zum Erstellen oder Aktualisieren eines Rollouts
• Erfahren Sie, wie Sie eine Bereitstellung löschen.