Nachdem Sie die grüne Umgebung getestet und validiert haben, starten Sie einen Wechsel, um die grüne Umgebung in Ihre neue Lese- und Schreibumgebung für die Produktion umzuwandeln.
Hinweis
Bevor Sie einen Wechsel initiieren, müssen Sie die erforderlichen Berechtigungen haben und Ihre Bereitstellung muss für die Umstellung bereit sein.
Erforderliche Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die folgende IAM-Rolle für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen eines Switchovers benötigen:
- Cloud SQL-Administrator (
roles/cloudsql.admin)
Für benutzerdefinierte Rollen benötigen Sie die folgenden Berechtigungen:
cloudsql.blueGreenDeployments.switchovercloudsql.blueGreenDeployments.getcloudsql.instances.switchovercloudsql.operations.get
Weitere Informationen zu IAM-Rollen und -Berechtigungen in Cloud SQL finden Sie unter Rollen und Berechtigungen.
Überprüfung vor der Umstellung
Prüfen Sie vor dem Initiieren eines Switchovers die folgenden Bedingungen:
- Bereitstellungsstatus: Die Bereitstellung muss den Status
SWITCHOVER_READYhaben. - Arbeitslastvalidierung: Schließen Sie alle Tests und Validierungen auf der grünen Staging-Instanz ab.
- Geringe Replikationsverzögerung: Achten Sie darauf, dass die Replikationsverzögerung zwischen Blau und Grün minimal ist, um die Umstellungszeit zu verkürzen.
Funktionsweise des Switchovers
Wenn Sie einen Wechsel starten, führt Cloud SQL die folgende automatisierte Sequenz aus:
- Validierung vor dem Switchover: Vor dem Switchover prüft Cloud SQL, ob die Replikation funktioniert, und führt eine Reihe von Konfigurationsprüfungen durch, um sicherzustellen, dass die Bereitstellung bereit ist.
- Ausführung des Switchover-Workflows: Während der Workflowausführung bereitet Cloud SQL die Instanzen für die Umstellung vor. Wenn die Replikationsverzögerung zu hoch ist oder eine aktive Transaktion die Umstellung blockiert, schlägt der Umstellungsvorgang fehl und die blaue Produktionsumgebung bleibt online.
- Traffic-Weiterleitung: Cloud SQL tauscht die Verbindungsendpunkte zwischen den blauen und grünen Instanzen aus.
- Rollenkonvertierung: Die grüne Instanz wird zur aktiven Lese- und Schreibinstanz für die Produktion und die blaue Instanz wird zu einer eigenständigen Lese- und Schreibinstanz.
Während der Umstellung werden die Anwendungsverbindungen kurz unterbrochen (in der Regel nur für Sekunden), bevor sie automatisch wieder mit der aktualisierten Produktionsinstanz verbunden werden. Die Ausfallzeit bei der Umstellung variiert je nach Cloud SQL-Version:
- Cloud SQL Enterprise Plus-Version: Die Ausfallzeit bei der Umstellung beträgt in der Regel weniger als eine Sekunde.
- Cloud SQL Enterprise-Version: Die Ausfallzeit bei der Umstellung beträgt in der Regel weniger als 60 Sekunden, je nach Arbeitslast und Replikationsverzögerung. Es sind keine Änderungen an der Anwendungskonfiguration oder am Verbindungsstring erforderlich.
Lebenszyklusstatus der Umstellung
Vor, während und nach einem Switchover durchläuft die Bereitstellung die folgenden Status im Antwortfeld state:
SWITCHOVER_READY: Die logische Replikation von Blau zu Grün ist fehlerfrei und die Bereitstellung ist für den Wechsel bereit. Der StatusSWITCHOVER_READYhängt nur davon ab, ob die Replikation fehlerfrei ist. Cloud SQL wertet die Replikationsverzögerung beim Festlegen dieses Status nicht aus.SWITCHOVER_NOT_READY: Die Bereitstellung ist bereitgestellt, aber der Wechsel kann nicht initiiert werden. Dies geschieht, wenn die logische Replikation fehlerhaft, pausiert oder beendet ist oder wenn ein zugrunde liegender Knotenfehler aufgetreten ist. Cloud SQL wertet die Replikationsverzögerung beim Festlegen dieses Status nicht aus. Prüfen SieerrorDetailund beheben Sie den Fehler, bevor Sie den Wechsel versuchen.SWITCHOVER_IN_PROGRESS: Der Switchover-Befehl wird gerade ausgeführt. Cloud SQL tauscht die Verbindungsendpunkte aus und wandelt die grüne Instanz in die Produktionsinstanz für Lese- und Schreibvorgänge um.SWITCHOVER_COMPLETED: Der Wechsel wurde erfolgreich abgeschlossen. Die grüne Instanz ist jetzt Ihre aktive Produktionsdatenbankinstanz, die Lese- und Schreibzugriffe verarbeitet. Die blaue Instanz wird als eigenständige Lese- und Schreibinstanz beibehalten, bis Sie das Deployment löschen.
Best Practices vor dem Wechsel
- Planung während Zeitfenstern mit geringem Traffic: Obwohl die Ausfallzeit minimal ist (normalerweise in Sekunden), sollten Sie die Umstellung in Zeiten mit geringer Schreibaktivität starten (z. B. außerhalb der Spitzenzeiten oder während Wartungsfenstern, wenn die Anzahl der Schreibabfragen pro Sekunde am niedrigsten ist). Dadurch wird die Replikationsverzögerung minimiert und das Risiko abgebrochener Transaktionen verringert.
- Replikationsverzögerung prüfen: Achten Sie darauf, dass die Replikationsverzögerung minimal ist, bevor Sie mit der Umstellung beginnen. Beim Beschreiben einer Blau/Grün-Bereitstellung wird die Replikationsverzögerung nicht angezeigt und Cloud SQL prüft die Replikationsverzögerung vor dem Wechselvorgang nicht. Während der Workflowausführung schlägt der Wechsel jedoch fehl, wenn die Replikationsverzögerung zu hoch ist. Wenn Sie die Replikationsverzögerung überwachen möchten, prüfen Sie die Cloud Monitoring-Messwerte (z. B.
replica_lag) oder den Replikationsstatus direkt auf der grünen Instanz. Weitere Informationen finden Sie unter Replikationsverzögerung. - Aktive Transaktionen prüfen: Achten Sie darauf, dass lang andauernde DDL-Vorgänge oder Batch-Schreibvorgänge abgeschlossen sind, bevor Sie den Switchover starten.
Wechsel starten
Starten Sie den Switchover-Vorgang mit der Google Cloud Console, der gcloud CLI oder der Cloud SQL Admin API:
Console
-
Rufen Sie in der Google Cloud Console die Seite Cloud SQL-Instanzen auf.
- Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
- Klicken Sie auf der Karte Status der Blau/Grün-Bereitstellung auf Details, um die Seite Bereitstellungsübersicht zu öffnen.
- Klicken Sie auf Deployment umstellen.
- Prüfen Sie im Dialogfeld Unterschiede bei den Instanzeinstellungen die Unterschiede bei den Einstellungen zwischen der Quelle und dem Ziel und klicken Sie dann auf Weiter, um die Umstellung zu starten.
gcloud
Führen Sie den Befehl blue-green-deployments switchover aus:
gcloud beta sql blue-green-deployments switchover DEPLOYMENT_NAME \ --region=REGION \ --async
Umschaltvorgänge können einige Minuten dauern. Möglicherweise wird eine Meldung angezeigt, die angibt, dass der Vorgang länger als erwartet dauert. Sie können diese Nachricht entweder ignorieren oder den Befehl gcloud sql
operations wait ausführen, um sie zu verwerfen und zu warten, bis der Vorgang abgeschlossen ist:
gcloud sql operations wait OPERATION_ID
Führen Sie den Befehl gcloud sql
operations describe aus, um den Status des Switchover-Vorgangs zu prüfen:
gcloud sql operations describe OPERATION_ID
Ersetzen Sie Folgendes:
- DEPLOYMENT_NAME: der Name Ihres Blau/Grün-Deployments.
- REGION: die Google Cloud -Region, in der die Bereitstellung erstellt wurde.
- OPERATION_ID: die ID des Switchover-Vorgangs.
REST Version 1
Senden Sie eine POST-Anfrage an die Methode blueGreenDeployments.switchover:
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/ locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME:switchover
Ersetzen Sie Folgendes:
- PROJECT_ID: die ID Ihres Projekts in Google Cloud .
- REGION: die Google Cloud -Region, in der die Bereitstellung erstellt wurde.
- DEPLOYMENT_NAME: der Name Ihres Blau/Grün-Deployments.
REST v1beta4
Senden Sie eine POST-Anfrage an die Methode blueGreenDeployments.switchover:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/ locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME:switchover
Ersetzen Sie Folgendes:
- PROJECT_ID: die ID Ihres Projekts in Google Cloud .
- REGION: die Google Cloud -Region, in der die Bereitstellung erstellt wurde.
- DEPLOYMENT_NAME: der Name Ihres Blau/Grün-Deployments.
Monitoring nach dem Wechsel
Nach Abschluss des Wechsels:
- Prüfen Sie, ob die Anwendung erfolgreich wieder verbunden wird und die Vorgänge in der Produktionsdatenbank fortgesetzt werden.
- Überwachen Sie den Abfragedurchsatz, die Fehlerlogs und den Replikationsstatus auf der neuen Produktionsinstanz.
- Lassen Sie die blaue eigenständige Instanz während des ersten Überprüfungszeitraums nach dem Upgrade intakt. Nachdem Sie die Stabilität bestätigt haben, löschen Sie das Deployment. Weitere Informationen finden Sie unter Blau/Grün-Bereitstellung löschen.
Nächste Schritte
- Löschen Sie eine Blau/Grün-Bereitstellung, um Bereitstellungsmetadaten zu entfernen und die ehemalige blaue Instanz zu löschen.
- Instanzen überwachen
- Informationen zu Sicherung und Wiederherstellung