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:

Upgrade planen

Bevor Sie die Netzwerkarchitektur Ihrer Cloud SQL-Instanzen aktualisieren, planen Sie das Upgrade unter Berücksichtigung der folgenden 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.

• Hochverfügbare Legacy-Instanzen mit Failover-Replikaten werden für ein Upgrade nicht unterstützt.

• Nach dem Upgrade der Netzwerkarchitektur können Sie keine hochverfügbaren Failover-Replikate von Legacy-Instanzen für aktualisierte Instanzen mehr erstellen.

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 wird 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. Aktualisieren Sie die Netzwerkarchitektur einer Cloud SQL-Instanz

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 sql instances describe INSTANCE_NAME
   

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

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "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 sql instances list --show-sql-network-architecture

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

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

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

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

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "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 sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

operation_id

operation_id

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

operation_id

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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?
• Funktionieren alle Funktionen nach dem Upgrade genau so wie davor?
• Welche Instanzen verwenden die alte Netzwerkarchitektur?
• Werden alle neuen Cloud SQL-Instanzen in der neuen Netzwerkarchitektur erstellt?
• Ist es möglich, alle Instanzen in einem Projekt mit einem einzigen Befehl zu aktualisieren?
• Wird das Replikat automatisch aktualisiert, wenn ich die primäre Instanz aktualisiere?
• Ich habe eine Benachrichtigung erhalten, dass die Netzwerkarchitektur meiner Cloud SQL-Instanzen aktualisiert wird. Was muss ich tun?
• Warum kann ich die Netzwerkarchitektur meiner zonalen Instanz nicht aktualisieren?
• Wenn ich versuche, meine Instanz zu aktualisieren, erhalte ich die Fehlermeldung „Außerhalb des reservierten IP-Adressbereichs“. Was muss ich tun?

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.

Welche Instanzen verwenden die alte Netzwerkarchitektur?

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

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

Nein. Das Upgrade auf die neue Netzwerkarchitektur erfolgt für jede Instanz einzeln. Jedes Replikat 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 gleiche gilt auch umgekehrt. Wenn Sie ein Replikat upgraden, hat dies keine Auswirkungen auf die primäre Instanz.

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 der ursprünglich zugewiesene IP-Adressbereich 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

• Mehr über Private Service Connect
• Weitere Informationen zu Assured Workloads
• Weitere Informationen zum Konfigurieren des Zugriffs auf private Dienste für Cloud SQL
• Weitere Informationen zum Database Migration Service für AlloyDB for PostgreSQL