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 una copia dell'istanza di origine. La nuova istanza è completamente indipendente l'istanza di origine.

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. Manuale i backup non vengono copiati dall'istanza di origine.
La nuova istanza ha lo stesso indirizzo o gli stessi indirizzi IP? No. La nuova istanza ha uno o più indirizzi IP nuovi.
La nuova istanza ha le stesse impostazioni di configurazione? Sì. La nuova istanza ha le stesse impostazioni, ad esempio database flag, opzioni di connettività, tipo di macchina e spazio di archiviazione e memoria impostazioni.
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 un evento distruttivo.
Le impostazioni di manutenzione dell'istanza di origine copiata automaticamente nell'istanza di clonazione? No. Devi configurare le impostazioni di manutenzione per l'istanza di clone.
Puoi clonare un'istanza quando la zona per l'istanza non è disponibile? Sì. Quando cloni un'istanza, puoi specificare una zona diversa per l'istanza.
Puoi clonare un database in un altro progetto? No. Non puoi clonare un database in un altro progetto.
Puoi clonare un'istanza che in precedenza era 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. Password per questi vengono copiati in modo che non sia necessario ricrearli.

clona un'istanza

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

Console

  1. Nella console Google Cloud, 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 Clona lo stato attuale dell'istanza selezionato.

    Tornerai alla pagina di elenco delle istanze durante l'inizializzazione del clone.

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

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 Google Cloud che contiene le istanze di origine e di destinazione

Per eseguire gcloud sql instances clone devi disporre dell'autorizzazione cloudsql.instances.clone. Per ulteriori informazioni sulle autorizzazioni necessarie 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 a un progetto Google Cloud, completa i passaggi nella le sezioni seguenti.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Google Cloud predefinito dove 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 in Terraform di configurazione del deployment.

Prepara la directory

Ogni file di configurazione Terraform deve avere una directory (inoltre chiamato modulo principale).

  1. In Cloud Shell, crea una directory e un nuovo all'interno di quella directory. Il nome del file deve contenere .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 nuovo oggetto main.tf.

    Facoltativamente, copia il codice da GitHub. Opzione consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

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

    Facoltativamente, per utilizzare la versione più recente del provider Google, includi -upgrade : 

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o che l'aggiornamento soddisfi le tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes alla richiesta: 
    terraform apply

    Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". .

  3. Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti create o aggiornate da Terraform.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disabilitare la protezione dall'eliminazione, nel file di configurazione Terraform imposta la classe Argomento deletion_protection per false. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente inserendo yes alla richiesta: 
    terraform apply

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

    terraform destroy

REST v1

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud 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

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"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud 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

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"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

clona un'istanza non disponibile

Console

Clona un'istanza che non è disponibile in un'altra zona per i seguenti motivi:

  • La zona corrente in cui è configurata l'istanza non è accessibile. Questa istanza ha uno stato FAILED.
  • È in corso la manutenzione dell'istanza. Questa istanza ha uno stato MAINTENANCE.

Per clonare un'istanza non disponibile:

  1. Nella console Google Cloud, 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, completa le seguenti azioni:
      .
    1. Nel campo ID istanza, aggiorna l'ID istanza, se necessario.
    2. Fai clic su Clona da un momento precedente.
    3. Nel campo Momento nel tempo, seleziona la data e l'ora di cui vuoi clonare i dati. Questa operazione consente di recuperare lo stato dell'istanza da quel momento specifico.
    4. Fai clic su Crea clone.

    6. Durante l'inizializzazione del clone, tornerai alla pagina di elenco delle istanze.

gcloud

Clona un'istanza che non è disponibile in una zona diversa perché la zona attuale in cui è configurata l'istanza non è accessibile.

gcloud sql instances clone SOURCE_INSTANCE_NAME TARGET_INSTANCE_NAME \
--point-in-time DATE_AND_TIME_STAMP \
--preferred-zone ZONE_NAME

L'account utente o di servizio che esegue gcloud sql instances clone deve avere l'autorizzazione cloudsql.instances.clone. Per ulteriori informazioni sulle autorizzazioni necessarie per eseguire i comandi gcloud CLI, consulta Autorizzazioni Cloud SQL.

REST v1

Clona un'istanza che non è disponibile in una zona diversa perché la zona attuale in cui è configurata l'istanza non è accessibile.

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

  • PROJECT_ID: l'ID progetto.
  • SOURCE_INSTANCE_NAME: il nome dell'istanza di origine.
  • TARGET_INSTANCE_NAME: il nome dell'istanza di destinazione (clonata).
  • DATE_AND_TIME_STAMP: un timestamp per l'istanza di origine nel fuso orario UTC e nel formato RFC 3339 (ad esempio,
    2012-11-15T16:19:00.094Z).
  • ZONE_NAME: facoltativo. Il nome della zona per l'istanza di destinazione. Viene utilizzato per specificare una zona diversa per l'istanza Cloud SQL che vuoi clonare. Per un'istanza a livello di regione, questa zona sostituisce la zona principale, ma la zona secondaria rimane la stessa dell'istanza.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "cloneContext":
  {
    "destinationInstanceName": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

Clona un'istanza che non è disponibile in una zona diversa perché la zona attuale in cui è configurata l'istanza non è accessibile.

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

  • PROJECT_ID: l'ID progetto.
  • SOURCE_INSTANCE_NAME: il nome dell'istanza di origine.
  • TARGET_INSTANCE_NAME: il nome dell'istanza di destinazione (clonata).
  • DATE_AND_TIME_STAMP: un indicatore di data e ora per l'istanza di origine in Il fuso orario UTC e nel formato RFC 3339 (ad es.
    2012-11-15T16:19:00.094Z).
  • ZONE_NAME: facoltativo. Il nome della zona per l'istanza di destinazione. Viene utilizzato per specificare diversa per l'istanza Cloud SQL che vuoi clonare. Per un'istanza a livello di regione, questa zona sostituisce la zona principale, ma la zona secondaria rimane la stessa dell'istanza.

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": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

L'account utente o di servizio che utilizza il metodo API instances.clone deve disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni necessarie 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 vuoi utilizzare:

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

L'account utente o di servizio che esegue gcloud sql instances clone deve avere l'autorizzazione cloudsql.instances.clone. Per ulteriori informazioni sulle autorizzazioni necessarie per eseguire i comandi gcloud CLI, consulta Autorizzazioni Cloud SQL.

REST v1

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

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

  • project-id: ID progetto
  • source-instance-id: l'ID dell'istanza di origine
  • target-instance-id: l'ID 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 delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

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

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

  • project-id: ID progetto
  • source-instance-id: l'ID dell'istanza di origine
  • target-instance-id: l'ID 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 delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

L'account utente o di servizio che utilizza il metodo API instances.clone deve disporre dell'autorizzazione cloudsql.instances.clone. Per saperne di più sulle autorizzazioni necessarie 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 creato nello stesso intervallo.
  • Se l'istanza di origine non è stata creata con un intervallo specificato, l'istanza clonata vengono create in un intervallo casuale.

Risoluzione dei problemi

Problema Risoluzione dei problemi
La clonazione non è riuscita e viene restituito constraints/sql.restrictAuthorizedNetworks errore. L'operazione di clonazione è bloccata dalla configurazione Authorized Networks. Authorized Networks è configurato per gli indirizzi IP pubblici nella sezione Connettività della console Google Cloud e la clonazione non è consentita a causa considerazioni sulla sicurezza.

Rimuovi tutte le voci Authorized Networks da Cloud SQL se puoi. Altrimenti, 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 Google Cloud per clonare un'istanza con un IP privato ma non hai specificato l'intervallo IP allocato desiderato da utilizzare e l'istanza di origine non viene creata con l'intervallo specificato. Come come risultato, 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 ulteriori informazioni, consulta Clonare un'istanza con un IP privato.