Clonazione delle istanze

Questa pagina spiega la clonazione e descrive come clonare un'istanza.

Panoramica

La clonazione di un'istanza Cloud SQL crea una nuova istanza che è una copia dell'istanza di origine. La nuova istanza è completamente indipendente dall'istanza di origine.

Clonazione standard

La clonazione standard crea un backup completo dell'istanza di origine. L'istanza utilizza quindi questo backup per eseguire il provisioning di una nuova istanza separata. La nuova istanza è una copia funzionalmente indipendente dell'origine al momento dell'inizio dell'operazione. La durata di un'operazione di clonazione standard è proporzionale alle dimensioni del database.

Clonazione rapida

La clonazione rapida utilizza uno Instant Snapshot per creare una nuova istanza, che è un'evoluzione significativa rispetto a un'operazione di clonazione standard.

Quando avvii un'operazione di clonazione nella stessa zona dell'istanza di origine, la clonazione rapida crea unoInstant Snapshoto. Quindi crea il nuovo disco utilizzando questoInstant Snapshoto. Questa operazione riguarda solo i metadati, quindi le dimensioni dei dati non influiscono sul tempo di creazione del clone.

Quando viene utilizzata la clonazione rapida

Cloud SQL utilizza automaticamente la clonazione rapida quando vengono soddisfatte le seguenti condizioni:

  • Operazioni nella stessa zona: l'operazione di clonazione deve essere avviata nella stessa zona dell'istanza di origine. Se specifichi una zona diversa (o anche la stessa zona), il processo verrà impostato sul flusso di lavoro di clonazione standard.
  • Coerenza delle proprietà del disco: le proprietà del disco del nuovo clone devono corrispondere esattamente all'istanza di origine (ad es. Persistent Disk e Google Cloud Hyperdisk, tipo di crittografia, dimensione del blocco).
  • Supporto del motore di database: il motore del database è Cloud SQL per MySQL o Cloud SQL per PostgreSQL

Se l'operazione di clonazione richiede il ripristino a un timestamp specifico di recupero point-in-time (PITR), il sistema utilizza il flusso di lavoro di clonazione standard.

Confronto tra i metodi di clonazione

La seguente tabella confronta le funzionalità di clonazione rapida e clonazione standard:

Funzionalità Clonazione standard Clonazione rapida
Tecnologia Snapshot standard Snapshot istantanei
Spostamento dei dati Copia completa dei dati da e verso Cloud Storage. La durata è proporzionale alle dimensioni del database. Operazione solo metadati per la clonazione nella stessa zona. Le dimensioni dei dati non influiscono sul tempo di creazione della clonazione.
Durata Ore per database di grandi dimensioni. Secondi o minuti per i passaggi di creazione della clonazione.
Requisito di backup Crea un backup completo temporaneo in Cloud Storage. Utilizza uno Instant Snapshot che viene eliminato dopo la creazione del nuovo disco.
Applicabilità Supporta i cloni tra zone e regioni. Supporta solo cloni nella stessa zona.

Domande frequenti

Domanda Risposta
La clonazione influisce sulle prestazioni? No. La clonazione non ha alcun impatto sulle prestazioni dell'istanza di origine.
I backup vengono copiati nella nuova istanza? No. La nuova istanza crea nuovi backup automatici. I backup manuali non vengono copiati dall'istanza di origine.
La nuova istanza ha lo stesso indirizzo o gli stessi indirizzi IP? No. La nuova istanza ha un nuovo indirizzo o nuovi indirizzi IP.
La nuova istanza ha le stesse impostazioni di configurazione? Sì. La nuova istanza ha le stesse impostazioni, ad esempio i flag del database, le opzioni di connettività, il tipo di macchina e le impostazioni di archiviazione e memoria.
Le repliche vengono copiate nella nuova istanza? No, devi creare nuove repliche per la nuova istanza.
Puoi clonare una replica? No, non puoi clonare una replica.
Puoi creare un clone da un momento precedente? Sì. Il recupero point-in-time utilizza la clonazione per ripristinare un'istanza da un momento precedente. In questo modo, puoi recuperare il database da un evento distruttivo.
Le impostazioni di manutenzione dell'istanza di origine vengono copiate automaticamente nell'istanza clone? No. Devi configurare le impostazioni di manutenzione per l'istanza clone.
Puoi clonare un'istanza quando la zona dell'istanza non è disponibile? Sì. Se cloni un'istanza zonale, puoi specificare una zona primaria diversa per l'istanza. Se cloni un'istanza ad alta disponibilità (regionale), puoi specificare zone primarie e secondarie diverse per l'istanza.
Puoi clonare un database in un altro progetto? Sì. Puoi clonare un'istanza in un progetto diverso se questo progetto si trova nella stessa organizzazione del progetto di origine. Per maggiori informazioni, vedi Clonare un'istanza in un altro progetto.
Puoi clonare un'istanza che era già un clone? Sì. Puoi clonare un'istanza clonata da un'altra istanza.
Gli utenti del database vengono copiati nella nuova istanza? Sì, gli utenti del database vengono copiati nella nuova istanza. Vengono copiate anche le password di questi utenti, in modo che non debbano essere ricreate.

Clonare un'istanza

Puoi clonare un'istanza Cloud SQL utilizzando la console Cloud de Confiance , gcloud CLI, Terraform o l'API.

Console

  1. Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Trova la riga dell'istanza da clonare.
  3. Nella colonna Azioni, fai clic sul menu Altre azioni.
  4. Fai clic su Crea clone.
  5. Nella pagina Crea un clone, aggiorna l'ID istanza, se necessario, e fai clic su Crea clone, lasciando selezionata l'opzione Clona lo stato attuale dell'istanza.

    Tornerai alla pagina dell'elenco delle istanze mentre il clone viene inizializzato.

gcloud

Per clonare un'istanza, utilizza il comando gcloud sql instances clone:

gcloud sql instances clone SOURCE_INSTANCE_NAME DESTINATION_INSTANCE_NAME \
--project PROJECT_ID \
--preferred-zone ZONE_NAME \
--preferred-secondary-zone SECONDARY_ZONE_NAME

Effettua le seguenti sostituzioni:

  • SOURCE_INSTANCE_NAME: il nome dell'istanza Cloud SQL da clonare.
  • DESTINATION_INSTANCE_NAME: il nome dell'istanza clonata.
  • PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene le istanze di origine e di destinazione.
  • ZONE_NAME: (Facoltativo) Il nome della zona principale per l'istanza di destinazione. Utilizza questa opzione se vuoi che l'istanza di destinazione si trovi in una zona primaria diversa rispetto all'istanza Cloud SQL che stai clonando. Per un'istanza regionale, questa zona sostituisce la zona primaria, ma la zona secondaria rimane la stessa dell'istanza di origine.
  • SECONDARY_ZONE_NAME: (Facoltativo) Il nome della zona secondaria per l'istanza di destinazione. Utilizza questo campo per specificare una zona secondaria diversa per l'istanza Cloud SQL regionale che vuoi clonare.

Se utilizzi i parametri --preferred-zone e --preferred-secondary-zone, si applicano le seguenti condizioni:

  • Sia la zona primaria che quella secondaria devono essere zone valide.
  • Entrambe le zone devono appartenere alla stessa regione dell'istanza di origine.
  • Le zone primaria e secondaria devono essere diverse.
  • Per le istanze di zona, non puoi utilizzare il parametro --preferred-secondary-zone. In caso contrario, il processo di clonazione dell'istanza non andrà a buon fine.
  • Se non specifichi valori per i parametri --preferred-zone o --preferred-secondary-zone, l'istanza clonata ha le stesse zone primaria e secondaria dell'istanza di origine.

Per eseguire il comando gcloud sql instances clone, devi disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni richieste per eseguire i comandi gcloud CLI, consulta Autorizzazioni Cloud SQL.

Terraform

Per clonare l'istanza, utilizza una risorsa Terraform.

resource "google_sql_database_instance" "clone" {
  name             = "postgres-instance-clone-name"
  region           = "us-central1"
  database_version = "POSTGRES_12"
  clone {
    source_instance_name = google_sql_database_instance.source.id
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Applica le modifiche

Per applicare la configurazione Terraform in un progetto Cloud de Confiance , completa i passaggi nelle sezioni seguenti.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Cloud de Confiance predefinito in cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo radice).

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

    Copia il codice campione nel main.tf appena creato.

    (Facoltativo) Copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

  3. Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
  4. Salva le modifiche.
  5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory. 
    terraform init

    (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes al prompt: 
    terraform apply

    Attendi che Terraform visualizzi il messaggio "Apply complete!".

  3. Apri il tuo Cloud de Confiance progetto per visualizzare i risultati. Nella console Cloud de Confiance , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disattivare la protezione dall'eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

  1. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il comando seguente e inserendo yes al prompt:

    terraform destroy

REST v1

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene le istanze di origine e di destinazione.
  • SOURCE_INSTANCE_NAME: il nome dell'istanza Cloud SQL da clonare.
  • DESTINATION_INSTANCE_NAME: il nome dell'istanza clonata.
  • ZONE_NAME: (Facoltativo) Il nome della zona principale per l'istanza di destinazione. Utilizza questa opzione se vuoi che l'istanza di destinazione si trovi in una zona primaria diversa rispetto all'istanza Cloud SQL che stai clonando. Per un'istanza regionale, questa zona sostituisce la zona primaria, ma la zona secondaria rimane la stessa dell'istanza di origine.
  • SECONDARY_ZONE_NAME: (Facoltativo) Il nome della zona secondaria per l'istanza di destinazione. Utilizza questo campo per specificare una zona secondaria diversa per l'istanza Cloud SQL regionale che vuoi clonare.

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

Corpo JSON della richiesta: 

{
  "cloneContext":
  {
    "destinationInstanceName": "DESTINATION_INSTANCE_NAME",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Se utilizzi i parametri preferredZone e preferredSecondaryZone, si applicano le seguenti condizioni:

  • Sia la zona primaria che quella secondaria devono essere zone valide.
  • Entrambe le zone devono appartenere alla stessa regione dell'istanza di origine.
  • Le zone primaria e secondaria devono essere diverse.
  • Per le istanze di zona, non puoi utilizzare il parametro preferredSecondaryZone. In caso contrario, il processo di clonazione dell'istanza non andrà a buon fine.
  • Se non specifichi valori per i parametri preferredZone o preferredSecondaryZone, l'istanza clonata ha le stesse zone primaria e secondaria dell'istanza di origine.

Per utilizzare il metodo API instances.clone, devi disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni richieste per utilizzare i metodi API, consulta Autorizzazioni Cloud SQL.

REST v1beta4

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene le istanze di origine e di destinazione.
  • SOURCE_INSTANCE_NAME: il nome dell'istanza Cloud SQL da clonare.
  • DESTINATION_INSTANCE_NAME: il nome dell'istanza clonata.
  • ZONE_NAME: (Facoltativo) Il nome della zona principale per l'istanza di destinazione. Utilizza questa opzione se vuoi che l'istanza di destinazione si trovi in una zona primaria diversa rispetto all'istanza Cloud SQL che stai clonando. Per un'istanza regionale, questa zona sostituisce la zona primaria, ma la zona secondaria rimane la stessa dell'istanza di origine.
  • SECONDARY_ZONE_NAME: (Facoltativo) Il nome della zona secondaria per l'istanza di destinazione. Utilizza questo campo per specificare una zona secondaria diversa per l'istanza Cloud SQL regionale che vuoi clonare.

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

Corpo JSON della richiesta: 

{
  "cloneContext":
  {
    "destinationInstanceName": "DESTINATION_INSTANCE_NAME",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Se utilizzi i parametri preferredZone e preferredSecondaryZone, si applicano le seguenti condizioni:

  • Sia la zona primaria che quella secondaria devono essere zone valide.
  • Entrambe le zone devono appartenere alla stessa regione dell'istanza di origine.
  • Le zone primaria e secondaria devono essere diverse.
  • Per le istanze di zona, non puoi utilizzare il parametro preferredSecondaryZone. In caso contrario, il processo di clonazione dell'istanza non andrà a buon fine.
  • Se non specifichi valori per i parametri preferredZone o preferredSecondaryZone, l'istanza clonata ha le stesse zone primaria e secondaria dell'istanza di origine.

Per utilizzare il metodo API instances.clone, devi disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni richieste per utilizzare i metodi API, consulta Autorizzazioni Cloud SQL.

Clona un'istanza che utilizza un indirizzo IP interno

Se la tua istanza Cloud SQL utilizza un indirizzo IP interno, puoi specificare facoltativamente un intervallo IP allocato per il nuovo indirizzo IP del clone. Ad esempio, google-managed-services-default.

gcloud

Clona l'istanza, specificando facoltativamente l'intervallo IP allocato che vuoi utilizzare:

gcloud sql instances clone SOURCE_INSTANCE_NAME TARGET_INSTANCE_NAME \
--allocated-ip-range-name ALLOCATED_IP_RANGE_NAME

L'utente o il account di servizio che esegue il comando gcloud sql instances clone deve disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni richieste per eseguire i comandi gcloud CLI, consulta Autorizzazioni Cloud SQL.

REST v1

Clona l'istanza, specificando facoltativamente l'intervallo IP allocato che vuoi utilizzare:

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

  • project-id: l'ID progetto
  • source-instance-id: l'ID dell'istanza di origine
  • target-instance-id: l'ID dell'istanza di destinazione
  • allocated-ip-range-name: il nome di un intervallo IP allocato

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone

Corpo JSON della richiesta: 

{
  "cloneContext":
  {
    "destinationInstanceName": "target-instance-id",
    "allocatedIpRange": "allocated-ip-range-name"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

L'utente o il account di servizio che utilizza il metodo API instances.clone deve disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni richieste per utilizzare i metodi API, consulta Autorizzazioni Cloud SQL.

REST v1beta4

Clona l'istanza, specificando facoltativamente l'intervallo IP allocato che vuoi utilizzare:

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

  • project-id: l'ID progetto
  • source-instance-id: l'ID dell'istanza di origine
  • target-instance-id: l'ID dell'istanza di destinazione
  • allocated-ip-range-name: il nome di un intervallo IP allocato

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

Corpo JSON della richiesta: 

{
  "cloneContext":
  {
    "destinationInstanceName": "target-instance-id",
    "allocatedIpRange": "allocated-ip-range-name"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

L'utente o il account di servizio che utilizza il metodo API instances.clone deve disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni richieste per utilizzare i metodi API, consulta Autorizzazioni Cloud SQL.

Se non specifichi un intervallo IP allocato, viene applicato il seguente comportamento:

  • Se l'istanza di origine è stata creata con un intervallo specificato, l'istanza clonata viene creata nello stesso intervallo.
  • Se l'istanza di origine non è stata creata con un intervallo specificato, l'istanza clonata viene creata in un intervallo casuale.

Clona un'istanza in un altro progetto

Puoi clonare un'istanza in un altro progetto all'interno dello stesso organization. Se cloni i dati all'interno della stessa zona, Cloud SQL utilizza uno Instant Snapshot, che accelera il processo di clonazione. Di conseguenza, puoi clonare istanze di grandi dimensioni in pochi minuti anziché in ore con i metodi convenzionali di esportazione e importazione. Se esegui la clonazione in una zona diversa, Cloud SQL utilizza il metodo di snapshot standard, che richiede più tempo per essere completato rispetto al meccanismo di Instant Snapshot.

Prima di iniziare

Prima di clonare un'istanza in un altro progetto, assicurati di soddisfare i seguenti requisiti:

  • I progetti di origine e di destinazione devono appartenere alla stessa organizzazione.
  • La rete di destinazione deve essere configurata con private services access.
  • L'account utente che esegue l'operazione di clonazione deve disporre delle seguenti autorizzazioni IAM:
    • cloudsql.instances.clone sul progetto di origine
    • cloudsql.instances.create sul progetto di destinazione.

Per saperne di più, consulta Autorizzazioni IAM di Cloud SQL.

  • Nel progetto di destinazione devono essere abilitate le seguenti API:
    • API Cloud SQL Admin (sqladmin.googleapis.com)
    • API Service Networking (servicenetworking.googleapis.com)
    • API Compute Engine (compute.googleapis.com)

Per saperne di più, consulta Guida introduttiva alle API Cloud.

Esegui una clonazione tra progetti

Puoi eseguire un'operazione di clonazione tra progetti utilizzando gcloud CLI o Terraform.

gcloud

Per clonare un'istanza in un progetto diverso, utilizza il comando gcloud sql instances clone con i parametri --destination-project e --destination-network:

gcloud sql instances clone SOURCE_INSTANCE_NAME DESTINATION_INSTANCE_NAME \
--project=SOURCE_PROJECT_ID \
--destination-project=DESTINATION_PROJECT_ID \
--destination-network=DESTINATION_NETWORK_NAME

Effettua le seguenti sostituzioni:

  • SOURCE_INSTANCE_NAME: il nome dell'istanza Cloud SQL che vuoi clonare.
  • DESTINATION_INSTANCE_NAME: il nome dell'istanza clonata risultante. Al termine dell'operazione, il clone si trova nel progetto di destinazione.
  • SOURCE_PROJECT_ID: l'ID o il nome del progetto che contiene l'istanza di origine.
  • DESTINATION_PROJECT_ID: l'ID o il nome del progetto in cui vuoi che risieda l'istanza clonata risultante.
  • DESTINATION_NETWORK_NAME: il nome completo della rete Virtual Private Cloud (VPC) nel progetto di destinazione. Ad esempio, projects/DESTINATION_PROJECT_ID/global/networks/NETWORK_NAME.

Per eseguire questo comando, devi disporre dell'autorizzazione cloudsql.instances.clone nel progetto di origine e dell'autorizzazione cloudsql.instances.create nel progetto di destinazione. Per saperne di più sulle autorizzazioni richieste per eseguire i comandi gcloud CLI, consulta Autorizzazioni Cloud SQL.

Terraform

Per clonare un'istanza in un altro progetto, utilizza una risorsa Terraform. Nel blocco clone, specifica il campo source_project per l'ID progetto dell'istanza di origine e imposta project sull'ID progetto di destinazione per la risorsa.

La seguente configurazione di esempio clona l'istanza source-instance-name dal progetto source-project-id all'istanza my-db-clone nel progetto destination-project-id e la connette alla rete dest-network nel progetto di destinazione.

resource "google_sql_database_instance" "cloned_instance" {
  name             = "my-db-clone"
  project          = "destination-project-id"
  database_version = "POSTGRES_13"

  settings {
    tier = "db-custom-2-7680"

    ip_configuration {
      ipv4_enabled    = false
      private_network = "projects/destination-project-id/global/networks/dest-network"
    }
  }

  clone {
    source_instance_name = "source-instance-name"
    source_project       = "source-project-id"
  }
}

Applica le modifiche

Per applicare la configurazione Terraform in un progetto Cloud de Confiance , completa i passaggi nelle sezioni seguenti.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Cloud de Confiance predefinito in cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo radice).

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

    Copia il codice campione nel main.tf appena creato.

    (Facoltativo) Copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

  3. Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
  4. Salva le modifiche.
  5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory. 
    terraform init

    (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes al prompt: 
    terraform apply

    Attendi che Terraform visualizzi il messaggio "Apply complete!".

  3. Apri il tuo Cloud de Confiance progetto per visualizzare i risultati. Nella console Cloud de Confiance , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disattivare la protezione dall'eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

  1. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il comando seguente e inserendo yes al prompt:

    terraform destroy

Limitazioni

Quando cloni un'istanza in un altro progetto, si applicano le seguenti limitazioni:

  • Le operazioni di clonazione rapida tra progetti sono supportate solo all'interno della stessa zona.
  • Private Service Connect non supporta le operazioni di clonazione tra progetti.
  • L'istanza clonata riceve un nuovo indirizzo IP privato nella rete di destinazione. L'indirizzo IP di origine non viene conservato.
  • Per impostazione predefinita, l'indirizzo IP pubblico è disabilitato nell'istanza clonata.
  • Le seguenti risorse e impostazioni di configurazione non vengono mantenute con la nuova istanza:
    • Repliche di lettura.
    • Chiavi di crittografia gestite dal cliente (CMEK).
    • Utenti o criteri IAM. Devi concedere nuovamente le autorizzazioni a livello di progetto nel progetto di destinazione.
    • Cronologia del backup e del recupero point-in-time. Se vuoi che i backup siano abilitati nell'istanza clonata, devi attivare manualmente questa funzionalità. Una volta attivati i backup sull'istanza clonata, iniziano i nuovi backup e la cronologia del recupero point-in-time sulla nuova istanza.

Risoluzione dei problemi

Problema Risoluzione dei problemi
La clonazione non riesce a causa dell'errore constraints/sql.restrictAuthorizedNetworks. L'operazione di clonazione è bloccata dalla configurazione Authorized Networks. Authorized Networks sono configurati per gli indirizzi IP pubblici nella sezione Connettività della console Cloud de Confiance e la clonazione non è consentita per motivi di sicurezza.

Rimuovi tutte le voci Authorized Networks dall'istanza Cloud SQL, se possibile. In caso contrario, crea una replica senza voci Authorized Networks.
Messaggio di errore: Failed to create subnetwork. Couldn't find free blocks in allocated IP ranges. Please allocate new ranges for this service provider. Help Token: [help-token-id].

Stai tentando di utilizzare la console Cloud de Confiance per clonare un'istanza con un indirizzo IP privato, ma non hai specificato l'intervallo IP allocato che vuoi utilizzare e l'istanza di origine non è stata creata con l'intervallo specificato. Di conseguenza, l'istanza clonata viene creata in un intervallo casuale.

Utilizza gcloud per clonare l'istanza e fornire un valore per il parametro
--allocated-ip-range-name. Per saperne di più, consulta Clonazione di un'istanza con un IP privato.