Esegui l'upgrade di un'istanza alla nuova architettura di rete


Questa pagina descrive come eseguire l'upgrade delle istanze Cloud SQL dalla vecchia architettura di rete alla nuova architettura di rete.

Questa pagina di upgrade dell'architettura di rete Cloud SQL si applica solo ad alcune istanze Cloud SQL. Se le tue istanze Cloud SQL utilizzano un progetto di rete Virtual Private Cloud (VPC) creato prima di agosto 2021, devi eseguire l'upgrade dell'architettura di rete di Cloud SQL per le tue istanze.

Panoramica

La seguente tabella mostra i vantaggi della nuova architettura di rete rispetto alla vecchia architettura di rete:

Capacità Architettura di rete precedente Nuova architettura di rete
Migrazione da Cloud SQL ad AlloyDB per PostgreSQL e da AlloyDB per PostgreSQL a Cloud SQL utilizzando Database Migration Service Richiede la configurazione di un indirizzo IP privato per la migrazione Non è richiesta alcuna configurazione di rete aggiuntiva.

Ad esempio, la migrazione da Cloud SQL ad AlloyDB per PostgreSQL o la migrazione da AlloyDB per PostgreSQL a Cloud SQL.
Connetti la tua istanza Cloud SQL utilizzando l'IP privato a servizi privati come Cloud Build o Vertex AI Non supportata a causa di un'intransitività del peering di rete Supportato
Istanze conformi ad Assured Workloads Funzionalità non supportata Supportato
Microsoft AD gestito Funzionalità non supportata Supportato
Private Service Connect Funzionalità non supportata Supportato
Quota di istanza predefinita di Cloud SQL per progetto 100 1000

Pianifica l'upgrade

Prima di eseguire l'upgrade dell'architettura di rete delle istanze Cloud SQL, pianifica l'upgrade in base ai seguenti vincoli:

  • Se esegui l'upgrade dell'architettura di rete, sono previsti fino a 4 minuti di inattività per l'istanza del database.

  • Se è in corso una migrazione dei dati, non puoi eseguire l'upgrade dell'istanza di origine alla nuova architettura durante la migrazione dei dati.

  • Se nella rete sono presenti due o più istanze nella stessa regione nel corso degli ultimi quattro giorni, puoi eseguire l'upgrade solo delle istanze per cui è abilitata l'alta disponibilità.

    Nota: in questo scenario, Cloud SQL utilizza temporaneamente un intervallo /24 aggiuntivo per ospitare temporaneamente le istanze sottoposte ad upgrade nella nuova architettura. Dopo che Cloud SQL ha eseguito l'upgrade di tutte le istanze nella combinazione di rete e regione, Cloud SQL rilascia l'intervallo.

    Ad esempio, se la tua rete contiene due istanze e una è in us-east1 e l'altra è in us-central1, puoi eseguire l'upgrade di entrambe le istanze, indipendentemente dal fatto che l'alta disponibilità sia abilitata o meno. Tuttavia, se la rete contiene tre istanze di cui una in us-east1 e le altre due in us-central1, puoi eseguire l'upgrade delle istanze in us-central1 per le quali è abilitata l'alta disponibilità. Poiché l'istanza in us-east1 è l'unica istanza in quella regione, puoi eseguirne l'upgrade, indipendentemente dal fatto che l'alta disponibilità sia abilitata.

  • Dopo aver eseguito l'upgrade di un'istanza ad alta disponibilità alla nuova architettura di rete, non puoi disabilitare l'alta disponibilità nell'istanza.

  • Le istanze ad alta disponibilità (HA) legacy con repliche di failover non sono supportate per un upgrade.

  • Dopo aver eseguito l'upgrade dell'architettura di rete, non puoi creare repliche di failover legacy ad alta disponibilità per le istanze di cui è stato eseguito l'upgrade.

  • Se il recupero point-in-time (PITR) o la replica è stato abilitato per la tua istanza Cloud SQL dopo l'11 agosto 2023, non puoi eseguire l'upgrade dell'istanza. Questo perché dopo l'11 agosto 2023 i log PITR vengono archiviati in Cloud Storage.

Pianifica l'upgrade di tutte le istanze Cloud SQL in un progetto di rete

Le istanze Cloud SQL possono trovarsi nello stesso progetto della rete VPC oppure in un progetto separato. Il progetto che ospita la rete VPC è il progetto di rete.

Se almeno un'istanza Cloud SQL in un progetto di rete utilizza la vecchia architettura di rete, l'intero progetto utilizza la vecchia architettura di rete. In questo caso, l'upgrade del progetto alla nuova architettura di rete non è stato eseguito.

Puoi utilizzare gcloud CLI o l'API Cloud SQL Admin per eseguire query sull'architettura di rete per tutte le istanze Cloud SQL all'interno di un progetto.

Quando modifichi la rete privata di un'istanza o abiliti l'IP privato per un'istanza, non puoi modificare l'architettura di rete nella stessa richiesta. In caso contrario, la richiesta viene rifiutata. Per evitare che questo accada, ti consigliamo di eseguire l'upgrade di tutte le istanze in un progetto di rete prima di modificare il progetto di rete.

Esegui l'upgrade dell'architettura di rete Cloud SQL

Per eseguire l'upgrade dell'architettura di rete delle istanze Cloud SQL:

  1. Verifica l'architettura di rete di una singola istanza Cloud SQL o di più istanze Cloud SQL.
  2. Esegui l'upgrade dell'architettura di rete di un'istanza Cloud SQL.

Verifica l'architettura di rete di una singola istanza Cloud SQL

Per verificare l'architettura di rete attuale di una singola istanza, utilizza il comando gcloud sql instances describe o il metodo instances.get.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, vedi Utilizzare Cloud Shell.

Per verificare l'architettura di rete di una singola istanza, esegui questo comando: 

   gcloud sql instances describe INSTANCE_NAME

Se l'istanza utilizza la vecchia architettura di rete, la risposta è simile alla seguente:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: OLD_NETWORK_ARCHITECTURE

Se l'istanza utilizza la nuova architettura di rete, la risposta è simile alla seguente:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: NEW_NETWORK_ARCHITECTURE

Il parametro sql_network_architecture indica se l'istanza utilizza la vecchia architettura di rete (OLD_NETWORK_ARCHITECTURE) o la nuova architettura di rete (NEW_NETWORK_ARCHITECTURE).

REST v1

Per verificare l'architettura di rete di un'istanza, utilizza il metodo instances.get dell'API Cloud SQL Admin.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • INSTANCE_NAME: il nome dell'istanza.
  • NETWORK_ARCHITECTURE_TYPE: il tipo di architettura di rete è definito come segue:
    • OLD_NETWORK_ARCHITECTURE: l'istanza utilizza la vecchia architettura di rete.
    • NEW_NETWORK_ARCHITECTURE: l'istanza utilizza la nuova architettura di rete.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

Per verificare l'architettura di rete di un'istanza, utilizza il metodo instances.get dell'API Cloud SQL Admin.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • INSTANCE_NAME: il nome dell'istanza.
  • NETWORK_ARCHITECTURE_TYPE: il tipo di architettura di rete è definito come segue:
    • OLD_NETWORK_ARCHITECTURE: l'istanza utilizza la vecchia architettura di rete.
    • NEW_NETWORK_ARCHITECTURE: l'istanza utilizza la nuova architettura di rete.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Verifica l'architettura di rete di più istanze Cloud SQL

Per verificare l'architettura di rete di più istanze in un progetto, utilizza il comando gcloud sql instances list o il metodo instance.list.

gcloud

Per verificare l'architettura di rete di più istanze in un progetto, esegui questo comando: 

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

L'output è simile al seguente.

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 v1

Per verificare l'architettura di rete di più istanze in un progetto, utilizza il metodo instance.list.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • NETWORK_ARCHITECTURE_TYPE: il tipo di architettura di rete come segue:
    • OLD_NETWORK_ARCHITECTURE: l'istanza utilizza la vecchia architettura di rete.
    • NEW_NETWORK_ARCHITECTURE: l'istanza utilizza la nuova architettura di rete.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

Per verificare l'architettura di rete di più istanze in un progetto, utilizza il metodo instance.list.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • NETWORK_ARCHITECTURE_TYPE: il tipo di architettura di rete è definito come segue:
    • OLD_NETWORK_ARCHITECTURE: l'istanza utilizza la vecchia architettura di rete.
    • NEW_NETWORK_ARCHITECTURE: l'istanza utilizza la nuova architettura di rete.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Esegui l'upgrade dell'architettura di rete di una singola istanza Cloud SQL

Per eseguire l'upgrade dell'architettura di rete per una singola istanza, utilizza il comando gcloud sql instances patch, il metodo instance.update o il metodo instance.patch.

gcloud

Per eseguire l'upgrade dell'architettura di rete di un'istanza, esegui questo comando: 

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

L'operazione di upgrade richiede alcuni minuti.

Durante l'upgrade, viene avviata un'operazione a lunga esecuzione e viene restituito un token dell'operazione:

operation_id

REST v1

Per eseguire l'upgrade dell'architettura di rete di un'istanza, utilizza i metodi instance.update o instance.patch dell'API Cloud SQL Admin.

Quando esegui l'upgrade dell'architettura di rete Cloud SQL, nella richiesta non sono consentiti ulteriori aggiornamenti all'istanza. Il corpo della richiesta contiene un'istanza dell'oggetto DatabaseInstance, con sqlNetworkArchitecture impostato su NEW_NETWORK_ARCHITECTURE.

Durante l'upgrade, viene avviata un'operazione a lunga esecuzione e viene restituito un token dell'operazione:

operation_id

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • INSTANCE_NAME: il nome dell'istanza.
  • NETWORK_ARCHITECTURE_TYPE: il tipo di architettura di rete è definito come segue:
    • OLD_NETWORK_ARCHITECTURE: l'istanza utilizza la vecchia architettura di rete.
    • NEW_NETWORK_ARCHITECTURE: l'istanza utilizza la nuova architettura di rete.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Se l'upgrade dell'istanza non riesce, riprova a eseguire l'operazione.

REST v1beta4

Per eseguire l'upgrade dell'architettura di rete di un'istanza, utilizza instance.update method o instance.patch method dell'API Cloud SQL Admin.

Quando esegui l'upgrade dell'architettura di rete Cloud SQL, nella richiesta non sono consentiti ulteriori aggiornamenti all'istanza. Il corpo della richiesta contiene un'istanza dell'oggetto DatabaseInstance, con sqlNetworkArchitecture impostato su NEW_NETWORK_ARCHITECTURE.

Durante l'upgrade, viene avviata un'operazione a lunga esecuzione e viene restituito il seguente token operativo:

operation_id

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • INSTANCE_NAME: il nome dell'istanza.
  • NETWORK_ARCHITECTURE_TYPE: il tipo di architettura di rete è definito come segue:
    • OLD_NETWORK_ARCHITECTURE: l'istanza utilizza la vecchia architettura di rete.
    • NEW_NETWORK_ARCHITECTURE: l'istanza utilizza la nuova architettura di rete.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Se per qualsiasi motivo l'upgrade dell'istanza non va a buon fine, puoi riprovare a eseguire l'operazione.

Domande frequenti

Questa sezione fornisce risposte alle domande frequenti sull'upgrade dell'architettura di rete Cloud SQL.

Qual è l'impatto dell'upgrade sulla mia istanza Cloud SQL?

Durante l'upgrade dell'architettura di rete, l'istanza Cloud SQL ha uno stato di MANUTENZIONE. In questo stato, l'istanza ha un tempo di inattività medio massimo di 4 minuti. Eventuali modifiche aggiuntive all'istanza non sono consentite fino al completamento dell'upgrade. Le altre istanze nel progetto o nella rete non sono interessate dall'upgrade.

Tutte le funzionalità funzionano allo stesso modo dopo l'upgrade?

Tutte le funzionalità dell'istanza Cloud SQL funzionano allo stesso modo nella nuova architettura e nella vecchia architettura. Dopo aver eseguito l'upgrade di un'istanza per utilizzare la nuova architettura di rete, se vuoi cambiare la rete dell'istanza, assicurati che venga eseguito anche l'upgrade di tutte le istanze nella rete di destinazione alla nuova architettura di rete.

Quali istanze utilizzano la vecchia architettura di rete?

Tutti i nuovi progetti creati dopo agosto 2021 utilizzeranno automaticamente la nuova architettura di rete. I progetti esistenti possono contenere istanze Cloud SQL che risalgono a più di due anni fa e che utilizzano ancora la vecchia architettura di rete. Di conseguenza, devi eseguire l'upgrade di tutte le istanze all'interno di un progetto esistente prima che le nuove istanze nel progetto possano iniziare a utilizzare la nuova architettura di rete.

Tutte le nuove istanze Cloud SQL sono state create nella nuova architettura di rete?

Per impostazione predefinita, le nuove istanze Cloud SQL create nei progetti creati dopo agosto 2021 utilizzano la nuova architettura di rete. Se vuoi creare un'istanza in un progetto creato prima di agosto 2021 e utilizzare la nuova architettura di rete, devi:

  1. Aggiorna tutte le istanze esistenti nel progetto alla nuova architettura di rete.

  2. Se hai un contratto di assistenza per Google Cloud, crea una richiesta di assistenza per modificare l'architettura di rete predefinita del progetto con la nuova architettura.

  3. Se non hai un contratto di assistenza, crea la tua istanza e poi esegui l'upgrade alla nuova architettura di rete.

Dopo aver modificato le impostazioni predefinite del progetto, puoi creare istanze con la nuova architettura di rete in quel progetto.

Se non modifichi l'architettura di rete predefinita del progetto, tutte le nuove istanze nel progetto utilizzeranno la vecchia architettura di rete. Dovrai quindi eseguire l'upgrade singolarmente di ciascuna di queste istanze alla nuova architettura di rete.

È possibile aggiornare tutte le istanze in un progetto con un singolo comando?

No, l'upgrade alla nuova architettura di rete si basa su ciascuna istanza.

L'upgrade della replica viene eseguito automaticamente se eseguo l'upgrade dell'istanza principale?

No, l'upgrade alla nuova architettura di rete si basa su ogni singola istanza. Ogni replica viene trattata come un'istanza separata e deve essere sottoposta ad upgrade separatamente. Ciò significa che se viene eseguito l'upgrade dell'istanza principale e la replica utilizza la vecchia architettura di rete, la replica non è interessata. Vale anche il contrario. Se esegui l'upgrade di una replica, quella principale non sarà interessata.

Passaggi successivi