Blau/Grün-Bereitstellungen beschreiben und auflisten

In diesem Dokument wird beschrieben, wie Sie Cloud SQL-Blue-Green-Bereitstellungen auflisten und beschreiben, Verbindungsdetails und Konfigurationsunterschiede prüfen und eine Verbindung zur grünen Staging-Umgebung herstellen, um Ihre Arbeitslasten zu testen und zu validieren.

Hinweis

Wenn Sie ein Blau/Grün-Deployment auflisten oder beschreiben und eine Verbindung zur grünen Staging-Instanz herstellen möchten, müssen Sie die erforderlichen Rollen und Datenbankanmeldedaten haben.

Erforderliche Rollen und Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Auflisten und Beschreiben von Blue-Green-Bereitstellungen benötigen:

  • Cloud SQL-Betrachter (roles/cloudsql.viewer)
  • Cloud SQL-Bearbeiter (roles/cloudsql.editor)
  • Cloud SQL-Administrator (roles/cloudsql.admin)

Wenn Sie benutzerdefinierte Rollen verwenden, müssen Sie die folgenden Berechtigungen haben:

  • cloudsql.blueGreenDeployments.get
  • cloudsql.blueGreenDeployments.list

Um eine Verbindung zur grünen Staging-Instanz herzustellen und Testabfragen auszuführen, benötigen Sie außerdem Datenbanknutzeranmeldedaten, die in der Quellinstanz konfiguriert sind.

Weitere Informationen zu IAM-Rollen und Berechtigungen in Cloud SQL finden Sie unter Rollen und Berechtigungen.

Übersicht

Mit dem Befehl „describe“ können Sie den Status einer Blau/Grün-Bereitstellung von Cloud SQL während des gesamten Lebenszyklus überwachen und verfolgen – von der ersten Bereitstellung und dem Staging bis zum Abschluss der Umstellung.

Die Beschreibung einer Blau/Grün-Bereitstellung bietet Einblick in Folgendes:

  • Lebenszyklusstatus des Deployments:Sie können den Echtzeitstatus Ihres Deployments beobachten, während es verschiedene Status durchläuft, z. B. PROVISIONING, SWITCHOVER_READY, SWITCHOVER_NOT_READY, SWITCHOVER_IN_PROGRESS und SWITCHOVER_COMPLETED.
  • Details zur Verbindung der Zielinstanz:Rufen Sie den eindeutigen Verbindungsnamen und die Netzwerkendpunkte für die grüne Staging-Instanz ab. So können Datenbankadministratoren und QA-Ingenieure Anwendungen verbinden, Testanfragen ausführen und die Leistung in der grünen Instanz validieren, ohne den Live-Produktionsverkehr der blauen Instanz zu beeinträchtigen.
  • Replikationsstatus und Switchover-Bereitschaft:Prüfen Sie, ob die kontinuierliche logische Replikation von Blau nach Grün fehlerfrei ist, und sehen Sie sich die Details zu Diagnosefehlern an, falls Probleme auftreten. Hinweis: Beim Beschreiben eines Deployments wird keine Replikationsverzögerung angezeigt.
  • Konfigurationsunterschiede:Wenn Sie die detaillierte Ansicht aufrufen, können Sie die Datenbankversionen, Maschinenklassen, Speichereinstellungen und Hochverfügbarkeitskonfigurationen der blauen und grünen Instanzen nebeneinander vergleichen (diffs).

Blau/Grün-Bereitstellungen auflisten

So listen Sie Blau/Grün-Bereitstellungen in einem Projekt auf:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud SQL-Instanzen auf.

    Cloud SQL-Instanzen aufrufen

  2. Sehen Sie sich in der Instanzenliste die Spalte ID der Blau/Grün-Bereitstellung an, um die mit Ihren Instanzen verknüpften Blau/Grün-Bereitstellungen zu sehen. Bei Instanzen, die Teil einer Blau/Grün-Bereitstellung sind, wird neben dem Instanznamen auch ein Rollen-Tag (Blau, Grün, Alt-Blau oder Neu-Blau) angezeigt.

gcloud

Führen Sie den Befehl blue-green-deployments list aus, um Blau/Grün-Bereitstellungen mit gcloud aufzulisten:

gcloud beta sql blue-green-deployments list \
  --region=REGION

Wenn Sie Bereitstellungen in allen Regionen Ihres Projekts auflisten möchten, lassen Sie das Flag --region weg.

REST Version 1

Wenn Sie Bereitstellungen mit der Cloud SQL Admin API auflisten möchten, senden Sie eine GET-Anfrage an die Methode blueGreenDeployments.list:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/blueGreenDeployments

REST v1beta4

Wenn Sie Bereitstellungen mit der Cloud SQL Admin API auflisten möchten, senden Sie eine GET-Anfrage an die Methode blueGreenDeployments.list:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/blueGreenDeployments

Blau/Grün-Bereitstellung beschreiben

So prüfen Sie den Bereitstellungsstatus und rufen die Details zur grünen Instanzverbindung ab:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud SQL-Instanzen auf.

    Cloud SQL-Instanzen aufrufen

  2. Führen Sie einen der folgenden Schritte aus, um die Seite Bereitstellungsübersicht zu öffnen:
    • Klicken Sie in der Spalte ID der Blau/Grün-Bereitstellung auf die Bereitstellungs-ID.
    • Klicken Sie auf den Instanznamen, um die Seite Übersicht zu öffnen. Klicken Sie dann auf der Karte Blue/Green-Bereitstellungsstatus auf Details.
  3. Prüfen Sie auf der Seite Bereitstellungsübersicht auf der Karte Bereitstellungsdetails den Status, die Quellinstanz, die Zielinstanz, den Zielinstanzendpunkt und die Zielversion der Bereitstellung. Prüfen Sie auf der Karte Bereitstellungsfortschritt die Aufgabenstatus.

gcloud

Führen Sie den Befehl blue-green-deployments describe aus, um eine Bereitstellung mit gcloud zu beschreiben:

gcloud beta sql blue-green-deployments describe DEPLOYMENT_NAME \
  --region=REGION

Ersetzen Sie Folgendes:

  • DEPLOYMENT_NAME: Der Name Ihrer Blue-Green-Bereitstellung.
  • REGION: die Google Cloud Region, in der die Bereitstellung erstellt wurde.

REST Version 1

Wenn Sie eine Bereitstellung mit der Cloud SQL Admin API beschreiben möchten, senden Sie eine GET-Anfrage an die Methode blueGreenDeployments.get:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

REST v1beta4

Wenn Sie eine Bereitstellung mit der Cloud SQL Admin API beschreiben möchten, senden Sie eine GET-Anfrage an die Methode blueGreenDeployments.get:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

Status und Verbindungsdetails prüfen

Prüfen Sie in der Befehlsausgabe den Bereitstellungsstatus und suchen Sie nach den Verbindungsinformationen für die grüne Zielinstanz:

name: projects/my-project/locations/us-central1/
  blueGreenDeployments/my-deployment
createTime: '2026-08-13T10:00:00.000Z'
state: SWITCHOVER_READY
sourceInstance: my-source-instance
switchoverTargetInstance: my-target-instance
requestedConfig:
  databaseVersion: MYSQL_8_4
deploymentMappings:
- source:
    connection: my-project:us-central1:my-source-instance
    dns: my-source-instance.123456789012.us-central1.sql.goog.
    instance: projects/my-project/instances/my-source-instance
    ipAddresses:
    - ipAddress: 10.0.0.1
      type: PRIMARY
  state: PROVISIONED
  target:
    connection: my-project:us-central1:my-target-instance
    dns: my-target-instance.123456789012.us-central1.sql.goog.
    instance: projects/my-project/instances/my-target-instance
    ipAddresses:
    - ipAddress: 10.0.0.2
      type: PRIMARY
  tasks:
  - type: PROVISION
    state: SUCCEEDED
    startTime: '2026-08-13T10:00:00.000Z'
    endTime: '2026-08-13T10:15:00.000Z'
deploymentTasks:
- type: PROVISION
  state: SUCCEEDED
  startTime: '2026-08-13T10:00:00.000Z'
  endTime: '2026-08-13T10:15:00.000Z'

Prüfen Sie die folgenden Felder in der Antwort:

  • name:Der vollständig qualifizierte Ressourcenpfad der Bereitstellung im Format projects/PROJECT_ID/locations/REGION/blueGreenDeployments/DEPLOYMENT_NAME.
  • createTime:Der Zeitstempel, der angibt, wann die Bereitstellung erstellt wurde.
  • state:Der allgemeine Lebenszyklusstatus der Bereitstellung:
    • PROVISIONING: Bei der Bereitstellung wird die grüne Umgebung bereitgestellt und die Replikation eingerichtet.
    • SWITCHOVER_READY: Das Staging ist abgeschlossen, die logische Replikation ist fehlerfrei und die Bereitstellung ist für den Wechsel bereit. Prüfen Sie diesen Status, bevor Sie Tests ausführen.
    • SWITCHOVER_NOT_READY: Das Deployment ist nicht für den Wechsel bereit. Informationen zur Fehlerbehebung findest du unter errorDetail.
    • SWITCHOVER_IN_PROGRESS: Ein Switchover-Vorgang wird gerade ausgeführt.
    • SWITCHOVER_COMPLETED: Die Umstellung wurde erfolgreich abgeschlossen und die grüne Instanz verarbeitet jetzt Produktionsdatenverkehr als aktive Lese- und Schreibinstanz.
    • DELETING: Die Bereitstellungsressource wird gelöscht.
  • sourceInstance:Die Instanz-ID Ihrer ursprünglichen blauen Produktionsinstanz.
  • switchoverTargetInstance:Die Instanzkennung der grünen Staging-Instanz, die während der Umstellung zur Lese- und Schreibinstanz für die Produktion wird.
  • requestedConfig:Die Konfiguration, die für die Zielinstanz bei der Erstellung vorgesehen ist, z. B. databaseVersion für Upgrades der Hauptversion.
  • errorDetail:Details zu Diagnosefehlern, die erklären, warum die Umstellung nicht bereit ist oder warum eine Bereitstellungs- oder Umstellungsaufgabe fehlgeschlagen ist.
  • deploymentMappings:Die Liste der Paare aus Quell- und Zielinstanzen in der Bereitstellung. Prüfen Sie für jedes Paar Folgendes:
    • source:Verbindungs- und Netzwerkdetails für die blaue Instanz, einschließlich des Instanzressourcenpfads (instance), des Verbindungsnamens (connection), des DNS-Hostnamens (dns) und der IP-Adressen (ipAddresses).
    • target:Verbindungs- und Netzwerkdetails für die grüne Instanz. Verwenden Sie den Namen des Zielservers connection oder ipAddresses, um Staginganwendungen und Test-Suites mit der grünen Umgebung zu verbinden.
    • diffs:Konfigurationsunterschiede zwischen den blauen und grünen Instanzen bei Verwendung der Detailansicht. Während der Vorschau werden keine Änderungen an Datenbankflags angezeigt.
    • state:Der Betriebsstatus des gekoppelten Knotens (z. B. PROVISIONING, PROVISIONED, UPGRADING, UPGRADED, UPGRADE_FAILED, SWITCHOVER_IN_PROGRESS, SWITCHOVER_FAILED, SWITCHOVER_SUCCEEDED oder DELETING).
    • tasks:Der Ausführungsstatus, die Startzeit, die Endzeit und die Fehlerdetails für Bereitstellungsaufgaben, die auf diesem Knoten ausgeführt wurden.
  • deploymentTasks:Eine konsolidierte Liste aller Bereitstellungsaufgaben für alle Knoten, einschließlich der Aufgaben type (PROVISION, UPGRADE, SWITCHOVER, DELETE oder POST_SWITCHOVER_OPERATIONS), state (PENDING, RUNNING, SUCCEEDED oder FAILED), startTime, endTime und errorMessage.

Konfigurationsunterschiede ansehen

Wenn Sie eine Bereitstellung beschreiben, wird standardmäßig die einfache Ansicht mit den wichtigsten Metadaten zurückgegeben. Wenn Sie die Konfigurationsunterschiede zwischen den blauen und grünen Instanzen prüfen möchten, rufen Sie die Einstellungsunterschiede in der Google Cloud Console auf oder fordern Sie die detaillierte Ansicht mit der gcloud CLI oder der Cloud SQL Admin API an:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud SQL-Instanzen auf.

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
  3. Klicken Sie auf der Karte Status der Blau/Grün-Bereitstellung auf Details, um die Seite Bereitstellungsübersicht zu öffnen.
  4. Klicken Sie auf der Karte Bereitstellungsdetails auf Einstellungsunterschiede ansehen.
  5. Sehen Sie sich im Dialogfeld Instance Setting Differences (Unterschiede bei Instanzeinstellungen) den Vergleich zwischen der Source- und der Target-Instanz an und klicken Sie dann auf Close (Schließen).

gcloud

Führen Sie den Befehl blue-green-deployments describe mit dem Flag --show-config-diff aus.

gcloud beta sql blue-green-deployments describe DEPLOYMENT_NAME \
  --region=REGION \
  --show-config-diff

REST Version 1

Senden Sie eine GET-Anfrage an die Methode blueGreenDeployments.get mit dem Suchparameter view=DETAILED:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME?view=DETAILED

REST v1beta4

Senden Sie eine GET-Anfrage an die Methode blueGreenDeployments.get mit dem Suchparameter view=DETAILED:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME?view=DETAILED

Konfigurationsunterschiede prüfen

Wenn Sie die Detailansicht angeben, enthält die Antwort für jeden gekoppelten Knoten unter deploymentMappings den Abschnitt diffs:

deploymentMappings:
- diffs:
  - field: database_version
    sourceValue: MYSQL_8_0
    targetValue: MYSQL_8_4
  - field: settings/tier
    sourceValue: db-custom-2-7680
    targetValue: db-custom-4-15360
  source:
    instance: projects/PROJECT_ID/instances/my-source-instance
  target:
    connection: PROJECT_ID:REGION:my-target-instance
    instance: projects/PROJECT_ID/instances/my-target-instance

Im Abschnitt diffs werden Unterschiede zwischen der Quell- und der Zielinstanz für Attribute wie die folgenden hervorgehoben:

  • database_version:die Version des Datenbankmoduls auf den blauen und grünen Instanzen.
  • settings/tier:Der Maschinentyp (vCPU und Arbeitsspeicher), der der Instanz zugewiesen ist.
  • edition:die Cloud SQL-Version (Cloud SQL Enterprise- oder Cloud SQL Enterprise Plus-Version).
  • availability_type:Konfiguration mit Hochverfügbarkeit (HA) (ZONAL oder REGIONAL).
  • settings/data_disk_size_gb:Speicherkapazität in Gigabyte.
  • settings/data_disk_type:Speichertyp (PD_SSD).

Prüfen Sie, ob alle aufgeführten Änderungen Ihren geplanten Bereitstellungsspezifikationen entsprechen, bevor Sie mit dem Testen der funktionalen Arbeitslast beginnen.

Anwendungsarbeitslasten verbinden und validieren

Stellen Sie mit dem eindeutigen Verbindungsstring eine Verbindung zwischen Ihrer Anwendung oder Ihren Clienttools und der grünen Instanz her:

gcloud sql connect TARGET_INSTANCE_NAME --user=DB_USER

Ersetzen Sie Folgendes:

  • TARGET_INSTANCE_NAME: der Name der grünen Zielinstanz.
  • DB_USER: Der Datenbanknutzername.

Führen Sie die folgenden Validierungsschritte aus:

  • Integrationstests ausführen:Prüfen Sie, ob Anwendungsabfragen und gespeicherte Prozeduren auf der grünen Instanz fehlerfrei ausgeführt werden.
  • Fehlerlogs prüfen:Suchen Sie in den Fehlerlogs von Cloud Logging und der Cloud SQL-Datenbank nach Warnungen zur eingestellten Syntax oder nach unerwarteten Engine-Fehlern.
  • Leistungsstatistiken ansehen:Überwachen Sie die CPU-, Arbeitsspeicher- und E/A-Messwerte der grünen Instanz, um sicherzustellen, dass die Leistung den betrieblichen SLOs entspricht.

Nächste Schritte

  • Wenn die Validierung erfolgreich ist und die grüne Instanz alle funktionalen und Leistungsanforderungen erfüllt, fahren Sie mit Switchover einer Blue-Green-Bereitstellung fort.
  • Wenn Sie während der Validierung Probleme feststellen, können Sie die Blau/Grün-Bereitstellung problemlos löschen, ohne dass sich dies auf Ihre aktive blaue Umgebung auswirkt.