Clonazione delle istanze

Console

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Individua la riga dell'istanza da clonare.
3. Nella colonna Azioni, fai clic sul menu more_vert 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 corrente dell'istanza.

   Tornerai alla pagina dell'elenco di istanze durante l'inizializzazione della copia.

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 Google Cloud contenente le istanze di origine e di destinazione.
• ZONE_NAME: facoltativo. Il nome della zona principale per l'istanza di destinazione. Utilizzalo se vuoi che l'istanza di destinazione si trovi in una zona principale diversa da quella dell'istanza Cloud SQL che stai clonando. Per un'istanza regionale, questa zona sostituisce la zona principale, ma la zona secondaria rimane invariata rispetto all'istanza di origine.
• SECONDARY_ZONE_NAME: facoltativo. Il nome della zona secondaria per l'istanza di destinazione. Utilizzalo 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 principale che quella secondaria devono essere zone valide.
• Entrambe le zone devono appartenere alla stessa regione dell'istanza di origine.
• Le zone principali e secondarie devono essere diverse.
• Per le istanze zonali, non puoi utilizzare il parametro --preferred-secondary-zone. In questo caso, il processo di clonazione dell'istanza non va a buon fine.
• Se non specifichi valori per i parametri --preferred-zone o --preferred-secondary-zone, l'istanza clonata avrà le stesse zone principali e secondarie dell'istanza di origine.

Per eseguire il comando gcloud sql instances clone, devi disporre dell'autorizzazione cloudsql.instances.clone. Per ulteriori informazioni 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 Google Cloud, completa i passaggi nelle seguenti sezioni.

Prepara Cloud Shell

1. Avvia Cloud Shell.

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

   Devi eseguire questo comando una sola volta per progetto e puoi farlo 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 di Terraform deve avere una propria directory (chiamata anche modulo principale).

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.

   Se vuoi, copia il codice da GitHub. Questa 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

   Se vuoi, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione di Terraform eseguendo il seguente comando e inserendo yes al prompt:

   terraform apply

   Attendi che Terraform mostri il messaggio "Applicazione completata".

3. Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, 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 dell'eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform.

   deletion_protection =  "false"

2. Applica la configurazione Terraform aggiornata eseguendo il seguente comando e inserendo yes al prompt:

   terraform apply

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

   terraform destroy

REST v1

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

• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud contenente 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. Utilizzalo se vuoi che l'istanza di destinazione si trovi in una zona principale diversa da quella dell'istanza Cloud SQL che stai clonando. Per un'istanza regionale, questa zona sostituisce la zona principale, ma la zona secondaria rimane invariata rispetto all'istanza di origine.
• SECONDARY_ZONE_NAME: facoltativo. Il nome della zona secondaria per l'istanza di destinazione. Utilizzalo 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:

curl -X POST \
     -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/SOURCE_INSTANCE_NAME/clone"

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "DESTINATION_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

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

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

REST v1beta4

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

• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud contenente 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. Utilizzalo se vuoi che l'istanza di destinazione si trovi in una zona principale diversa da quella dell'istanza Cloud SQL che stai clonando. Per un'istanza regionale, questa zona sostituisce la zona principale, ma la zona secondaria rimane invariata rispetto all'istanza di origine.
• SECONDARY_ZONE_NAME: facoltativo. Il nome della zona secondaria per l'istanza di destinazione. Utilizzalo 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:

curl -X POST \
     -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/SOURCE_INSTANCE_NAME/clone"

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "DESTINATION_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

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

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

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'account utente o di servizio che esegue il comando gcloud sql instances clone debe disporre dell'autorizzazione cloudsql.instances.clone. Per ulteriori informazioni 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 seguenti sostituzioni:

• project-id: l'ID progetto
• source-instance-id: l'ID 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 di queste opzioni:

curl -X POST \
     -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/source-instance-id/clone"

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

L'account utente o di servizio che utilizza il metodo dell'API instances.clone deve disporre dell'autorizzazione cloudsql.instances.clone. Per ulteriori informazioni sulle autorizzazioni richieste per utilizzare i metodi dell'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 seguenti sostituzioni:

• project-id: l'ID progetto
• source-instance-id: l'ID 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 di queste opzioni:

curl -X POST \
     -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/source-instance-id/clone"

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

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