Upgrade einer Instanz auf die neue Netzwerkarchitektur ausführen


Auf dieser Seite wird beschrieben, wie Sie Ihre Cloud SQL-Instanzen von der alten Netzwerkarchitektur auf die neue Netzwerkarchitektur umstellen.

Diese Seite zum Upgrade der Cloud SQL-Netzwerkarchitektur gilt nur für einige Cloud SQL-Instanzen. Wenn für Ihre Cloud SQL-Instanzen ein VPC-Netzwerkprojekt (Virtual Private Cloud) verwendet wird, das vor August 2021 erstellt wurde, müssen Sie die Cloud SQL-Netzwerkarchitektur für Ihre Instanzen aktualisieren.

Übersicht

Die folgende Tabelle zeigt die Vorteile der neuen Netzwerkarchitektur im Vergleich zur alten Netzwerkarchitektur:

Funktion Alte Netzwerkarchitektur Neue Netzwerkarchitektur
Mit dem Database Migration Service von Cloud SQL zu AlloyDB for PostgreSQL und von AlloyDB for PostgreSQL zu Cloud SQL migrieren Sie müssen eine private IP-Adresse für die Migration konfigurieren. Es ist keine zusätzliche Netzwerkkonfiguration erforderlich.

Beispiele: Migration von Cloud SQL zu AlloyDB for PostgreSQL oder Migration von AlloyDB for PostgreSQL zu Cloud SQL.
Cloud SQL-Instanz über eine private IP-Adresse mit privaten Diensten wie Cloud Build oder Vertex AI verbinden Nicht unterstützt, da das Netzwerk-Peering nicht transitiv ist Unterstützt
Instanzen, die mit Assured Workloads konform sind Nicht unterstützt Unterstützt
Verwaltetes Microsoft Active Directory Nicht unterstützt Unterstützt
Private Service Connect Nicht unterstützt Unterstützt
Standardmäßiges Cloud SQL-Instanzkontingent pro Projekt 100 1000

Upgrade planen

Bevor Sie die Netzwerkarchitektur Ihrer Cloud SQL-Instanzen aktualisieren, planen Sie das Upgrade gemäß den folgenden Upgrade-Einschränkungen:

  • Wenn Sie Ihre Netzwerkarchitektur aktualisieren, kann es bei Ihrer Instanz zu einer Ausfallzeit von durchschnittlich bis zu vier Minuten kommen.

  • Wenn eine Datenmigration aktiv ist, können Sie die Quellinstanz während der Datenmigration nicht auf die neue Architektur aktualisieren.

  • Wenn Sie von einer externen Quelle eine Verbindung zu einer Instanz herstellen, prüfen Sie, ob alle Peering-Verbindungen aktualisiert sind, um den Export benutzerdefinierter Routen zu ermöglichen.

  • Sie können die Netzwerkarchitektur von Instanzen in einem Netzwerk mit mehr als 300 Cloud SQL-Instanzen nicht aktualisieren.

  • Wenn Ihr Netzwerk zwei oder mehr Instanzen mit privaten IP-Adressen in derselben Region umfasst, muss Cloud SQL einen oder mehrere zusätzliche /24-Bereiche aus dem zugewiesenen IP-Adressbereich für den Zugriff auf private Dienste verwenden, um die Instanzen in der neuen Netzwerkarchitektur zu hosten. Dieser zusätzliche Verbrauch ist nur vorübergehend und wird bei einem nachfolgenden Cloud SQL-Wartungsereignis wieder entfernt.

Upgrade aller Cloud SQL-Instanzen in einem Netzwerkprojekt planen

Ihre Cloud SQL-Instanzen können sich im selben Projekt wie das VPC-Netzwerk befinden oder in einem separaten Projekt gehostet werden. Das Projekt, in dem das VPC-Netzwerk gehostet wird, ist das Netzwerkprojekt.

Wenn mindestens eine Cloud SQL-Instanz in einem Netzwerkprojekt die alte Netzwerkarchitektur verwendet, verwendet das gesamte Projekt die alte Netzwerkarchitektur. In diesem Fall wurde Ihr Projekt nicht vollständig auf die neue Netzwerkarchitektur umgestellt.

Sie können die gcloud CLI oder die Cloud SQL Admin API verwenden, um die Netzwerkarchitektur für alle Cloud SQL-Instanzen in einem Projekt abzufragen.

Wenn Sie das private Netzwerk einer Instanz ändern oder eine private IP-Adresse für eine Instanz aktivieren, können Sie die Netzwerkarchitektur nicht in derselben Anfrage ändern. Wenn Sie sie doch ändern, wird die Anfrage abgelehnt. Um dies zu vermeiden, empfehlen wir, alle Instanzen in einem Netzwerkprojekt zu aktualisieren, bevor Sie das Netzwerkprojekt ändern.

Cloud SQL-Netzwerkarchitektur aktualisieren

So führen Sie ein Upgrade der Netzwerkarchitektur Ihrer Cloud SQL-Instanz durch:

  1. Prüfen Sie die Netzwerkarchitektur entweder einer einzelnen Cloud SQL-Instanz oder mehrerer Cloud SQL-Instanzen.
  2. Netzwerkarchitektur einer Cloud SQL-Instanz aktualisieren

Netzwerkarchitektur einer einzelnen Cloud SQL-Instanz prüfen

Verwenden Sie den Befehl gcloud sql instances describe oder die Methode instances.get, um die aktuelle Netzwerkarchitektur einer einzelnen Instanz zu prüfen.

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Führen Sie den folgenden Befehl aus, um die Netzwerkarchitektur einer einzelnen Instanz zu prüfen: 

   gcloud sql instances describe INSTANCE_NAME

Wenn die Instanz die alte Netzwerkarchitektur verwendet, sieht die Antwort in etwa so aus:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: OLD_NETWORK_ARCHITECTURE

Wenn die Instanz die neue Netzwerkarchitektur verwendet, sieht die Antwort in etwa so aus:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: NEW_NETWORK_ARCHITECTURE

Der Parameter sqlNetworkArchitecture gibt an, ob für Ihre Instanz die alte Netzwerkarchitektur (OLD_NETWORK_ARCHITECTURE) oder die neue Netzwerkarchitektur (NEW_NETWORK_ARCHITECTURE) verwendet wird.

REST Version 1

Verwenden Sie die Methode instances.get der Cloud SQL Admin API, um die Netzwerkarchitektur einer Instanz zu prüfen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp wird so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

Verwenden Sie die Methode instances.get der Cloud SQL Admin API, um die Netzwerkarchitektur einer Instanz zu prüfen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp wird so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Netzwerkarchitektur mehrerer Cloud SQL-Instanzen prüfen

Verwenden Sie den Befehl gcloud sql instances list oder die Methode instance.list, um die Netzwerkarchitektur mehrerer Instanzen in einem Projekt zu prüfen.

gcloud

Führen Sie den folgenden Befehl aus, um die Netzwerkarchitektur mehrerer Instanzen in einem Projekt zu prüfen: 

gcloud sql instances list --show-sql-network-architecture

Die Ausgabe sieht ungefähr so aus:

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

REST Version 1

Mit der Methode instance.list können Sie die Netzwerkarchitektur mehrerer Instanzen in einem Projekt prüfen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • NETWORK_ARCHITECTURE_TYPE: Den Netzwerkarchitekturtyp so:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

LIST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

Mit der Methode instance.list können Sie die Netzwerkarchitektur mehrerer Instanzen in einem Projekt prüfen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp wird so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

LIST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Netzwerkarchitektur einer einzelnen Cloud SQL-Instanz aktualisieren

Verwenden Sie zum Aktualisieren der Netzwerkarchitektur für eine einzelne Instanz den Befehl gcloud sql instances patch, die Methode instance.update oder die Methodeinstance.patch.

gcloud

Führen Sie den folgenden Befehl aus, um die Netzwerkarchitektur einer Instanz zu aktualisieren: 

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

Das Upgrade dauert einige Minuten.

Während des Upgrades wird ein Vorgang mit langer Ausführungszeit gestartet und ein Vorgangstoken wird zurückgegeben:

operation_id

REST Version 1

Verwenden Sie zum Upgrade der Netzwerkarchitektur einer Instanz den instance.update oder instance.patch der Cloud SQL Admin API.

Wenn Sie die Cloud SQL-Netzwerkarchitektur aktualisieren, sind in der Anfrage keine zusätzlichen Updates für die Instanz zulässig. Der Anfragetext enthält eine Instanz des DatabaseInstance-Objekts, wobei sqlNetworkArchitecture auf NEW_NETWORK_ARCHITECTURE gesetzt ist.

Während des Upgrades wird ein Vorgang mit langer Ausführungszeit gestartet und ein Vorgangstoken wird zurückgegeben:

operation_id

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp wird so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

Wenn das Upgrade Ihrer Instanz fehlschlägt, wiederholen Sie den Upgradevorgang.

REST v1beta4

Verwenden Sie zum Upgrade der Netzwerkarchitektur einer Instanz den instance.update method oder instance.patch method der Cloud SQL Admin API.

Wenn Sie die Cloud SQL-Netzwerkarchitektur aktualisieren, sind in der Anfrage keine zusätzlichen Updates für die Instanz zulässig. Der Anfragetext enthält eine Instanz des DatabaseInstance-Objekts, wobei sqlNetworkArchitecture auf NEW_NETWORK_ARCHITECTURE gesetzt ist.

Während des Upgrades wird ein Vorgang mit langer Ausführungszeit gestartet und das folgende Vorgangstoken wird zurückgegeben:

operation_id

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp wird so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

Wenn das Upgrade Ihrer Instanz aus irgendeinem Grund fehlschlägt, können Sie den Upgradevorgang noch einmal versuchen.

Häufig gestellte Fragen

In diesem Abschnitt finden Sie Antworten auf häufig gestellte Fragen zum Upgrade Ihrer Cloud SQL-Netzwerkarchitektur.

Welche Auswirkungen hat das Upgrade auf meine Cloud SQL-Instanz?

Beim Upgrade Ihrer Netzwerkarchitektur hat die Cloud SQL-Instanz den Zustand MAINTENANCE. In diesem Zustand kommt es durchschnittlich zu einer Ausfallzeit von bis zu vier Minuten. Bis das Upgrade abgeschlossen ist, sind keine weiteren Änderungen an der Instanz zulässig. Andere Instanzen in Ihrem Projekt oder Netzwerk sind vom Upgrade nicht betroffen.

Funktionieren alle Funktionen nach dem Upgrade genau so wie davor?

Alle Funktionen Ihrer Cloud SQL-Instanz funktionieren in der neuen Architektur genauso wie in der alten. Wenn Sie nach dem Upgrade einer Instanz auf die neue Netzwerkarchitektur das Netzwerk dieser Instanz wechseln möchten, müssen Sie prüfen, ob alle Instanzen im Zielnetzwerk auch auf die neue Netzwerkarchitektur aktualisiert werden.

Für welche Instanzen wird die alte Netzwerkarchitektur verwendet?

Bei allen neuen Projekten, die nach August 2021 erstellt wurden, wird automatisch die neue Netzwerkarchitektur verwendet. Vorhandene Projekte können Cloud SQL-Instanzen enthalten, die älter als zwei Jahre sind und noch die alte Netzwerkarchitektur verwenden. Daher müssen alle Instanzen in einem vorhandenen Projekt aktualisiert werden, bevor neue Instanzen in diesem Projekt die neue Netzwerkarchitektur verwenden können.

Werden alle neuen Cloud SQL-Instanzen in der neuen Netzwerkarchitektur erstellt?

Neue Cloud SQL-Instanzen, die in Projekten erstellt wurden, die nach August 2021 erstellt wurden, verwenden standardmäßig die neue Netzwerkarchitektur. Wenn Sie eine Instanz in einem vor August 2021 erstellten Projekt erstellen und die neue Netzwerkarchitektur verwenden möchten, gehen Sie so vor:

  1. Aktualisieren Sie alle vorhandenen Instanzen in diesem Projekt auf die neue Netzwerkarchitektur.

  2. Wenn Sie einen Google Cloud-Supportvertrag haben, erstellen Sie eine Supportanfrage, um die Standardnetzwerkarchitektur des Projekts in die neue Architektur zu ändern.

  3. Wenn Sie keinen Supportvertrag haben, erstellen Sie die Instanz und führen Sie dann ein Upgrade auf die neue Netzwerkarchitektur aus.

Nachdem die Standardeinstellung des Projekts geändert wurde, können Sie in diesem Projekt Instanzen mit der neuen Netzwerkarchitektur erstellen.

Wenn Sie die Standardnetzwerkarchitektur Ihres Projekts nicht ändern, wird für alle neuen Instanzen in diesem Projekt die alte Netzwerkarchitektur verwendet. Anschließend müssen Sie jede dieser Instanzen einzeln auf die neue Netzwerkarchitektur umstellen.

Ist es möglich, alle Instanzen in einem Projekt mit einem einzigen Befehl zu aktualisieren?

Nein. Das Upgrade auf die neue Netzwerkarchitektur erfolgt für jede Instanz.

Wird das Replikat automatisch aktualisiert, wenn ich die primäre Instanz aktualisiere?

Nein. Das Upgrade auf die neue Netzwerkarchitektur erfolgt für jede einzelne Instanz. Jedes Replik wird als separate Instanz behandelt und muss separat aktualisiert werden. Dies bedeutet, dass das Replikat keine Änderung erlebt, wenn die primäre Instanz aktualisiert wird und das Replikat die alte Netzwerkarchitektur verwendet. Das Gegenteil ist auch der Fall. Wenn Sie ein Replikat upgraden, hat dies keine Auswirkungen auf die primäre.

Ich habe eine Benachrichtigung erhalten, dass die Netzwerkarchitektur meiner Cloud SQL-Instanzen aktualisiert wird. Was muss ich tun?

Es besteht kein Handlungsbedarf Ihrerseits.

In einigen Fällen wird die Anfrage beim automatischen Upgrade in einem privaten Netzwerk vorübergehend abgelehnt. Als Problemumgehung können Sie die Netzwerkarchitektur Ihrer Instanz selbst aktualisieren. Folgen Sie dazu der Anleitung unter Netzwerkarchitektur einer einzelnen Cloud SQL-Instanz aktualisieren.

Warum kann ich die Netzwerkarchitektur meiner zonalen Instanz nicht aktualisieren?

Wenn Ihre Instanz mit zonaler Verfügbarkeit konfiguriert ist und das letzte geplante Wartungsereignis übersprungen wurde, unterstützt sie möglicherweise nicht das Upgrade auf die neue Netzwerkarchitektur. Um dieses Problem zu umgehen, aktivieren Sie die Hochverfügbarkeit für Ihre Instanz und führen Sie dann ein Upgrade der Netzwerkarchitektur durch. Nach dem Upgrade können Sie die Instanzkonfiguration wieder auf die zonale Verfügbarkeit umstellen.

Wenn ich versuche, meine Instanz zu aktualisieren, erhalte ich die Fehlermeldung „Außerhalb des reservierten IP-Adressbereichs“. Was muss ich tun?

Wenn Sie Cloud SQL-Instanzen in einem VPC-Netzwerk mit privater IP-Adresse verwenden möchten, müssen Sie IP-Adressbereiche zuweisen, wenn Sie den Zugriff auf private Dienste für das VPC-Netzwerk einrichten.

Wenn beispielsweise ein zugewiesener IP-Adressbereich geändert oder gelöscht wird, kann ein Fehler ähnlich dem folgenden auftreten:

Network architecture upgrade not allowed for private-ip instance PROJECT_ID:INSTANCE_NAME
whose IP address range 10.0.0.0/24 is outside the reserved IP address range for
private services access. Re-allocate the IP address range for private services access and retry.

In diesem Beispiel hat der ursprünglich zugewiesene IP-Adressbereich den Namen google-managed-services-VPC_NETWORK_NAME und die ursprünglich zugewiesene IP-Adressspanne ist 10.0.0.0/16. Anschließend erstellen Sie eine Instanz mit der privaten IP-Adresse 10.0.0.1. Wenn der IP-Adressbereich google-managed-services-VPC_NETWORK_NAME gelöscht oder so aktualisiert wird, dass er sich auf den Bereich 10.1.0.0/16 bezieht, deckt dieser Bereich nicht die private IP-Adresse 10.0.0.1 der Instanz ab. Wenn Sie danach versuchen, die Netzwerkarchitektur Ihrer Instanz zu aktualisieren, tritt der Fehler outside the reserved IP address range auf.

Führen Sie die Schritte unter Zugriff auf private Dienste für Cloud SQL konfigurieren aus, um das Problem zu beheben. Weisen Sie einen IP-Adressbereich, der die IP-Adresse Ihrer Instanz enthält, den Bereichen zu, die für den Zugriff auf private Dienste zugewiesen sind. Sie können mindestens den in der Fehlermeldung angegebenen IP-Adressbereich zuweisen (im vorherigen Beispiel 10.0.0.0/24).

Wiederholen Sie dann das Upgrade der Netzwerkarchitektur.

Nächste Schritte