Creazione di repliche di lettura

Console

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

   Vai a Istanze Cloud SQL

2. Trova l'istanza per cui vuoi creare una replica, quindi apri il menu more actions accanto alla scheda.
3. Seleziona Crea replica di lettura.

   Se non vedi questa scelta, l'istanza è una replica e non puoi creare una replica di una replica.

4. Se l'istanza aveva backup e logging binario abilitati, continua con il passaggio successivo. Altrimenti, seleziona Backup automatici e Abilita logging binario, fai clic su Continua e poi su Salva e riavvia per riavviare l'istanza.

   L'abilitazione del logging binario comporta il riavvio dell'istanza.

5. Nella sezione Personalizza la tua istanza della pagina, aggiorna le impostazioni per la replica. Inizia facendo clic su Mostra opzioni di configurazione per visualizzare i gruppi di impostazioni. Poi espandi i gruppi che ti interessano per esaminare e personalizzare le impostazioni. A destra viene visualizzato un Riepilogo di tutte le opzioni selezionate. La personalizzazione di queste impostazioni è facoltativa. I valori predefiniti vengono assegnati in tutti i casi in cui non vengono apportate personalizzazioni.

   Per maggiori dettagli su ciascuna impostazione, consulta la pagina Informazioni sulle impostazioni per le istanze.

   Ad esempio, per consentire ad altri servizi, come BigQuery, di accedere ai dati in Cloud SQL ed eseguire query su questi dati tramite una connessione interna, espandi il gruppo Connessioni e deseleziona la casella di controllo IP pubblico. Google Cloud

6. Fai clic su Crea replica.

   Cloud SQL crea un backup, se necessario, e crea la replica. Tornerai alla pagina dell'istanza primaria.

gcloud

1. Controlla lo stato dell'istanza primaria:

   gcloud sql instances describe PRIMARY_INSTANCE_NAME
         

   Se la proprietà databaseReplicationEnabled è true, l'istanza è una replica; non puoi creare una replica di una replica.

2. Se la proprietà enabled in backupConfiguration è false, abilita ora i backup per l'istanza principale:

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --backup-start-time=>HH:MM
         

   Il parametro backup-start-time è specificato nel formato orario 24 ore, nel fuso orario UTC±00 e specifica l'inizio di un periodo di backup di 4 ore. I backup possono iniziare in qualsiasi momento durante la finestra di backup.
3. Se la proprietà binaryLogEnabled è false, abilita i log binari sull'istanza primaria:

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --enable-bin-log

   L'abilitazione dei log binari causa il riavvio dell'istanza.
4. Crea la replica:

   gcloud sql instances create REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME

   Se necessario, puoi specificare una dimensione del livello diversa utilizzando il parametro --tier. Se crei una replica da un'istanza primaria per MySQL 8.4 e versioni successive e la versione di Cloud SQL per l'istanza è Enterprise o Enterprise Plus, non devi specificare un valore per questo parametro. La replica eredita il tipo di macchina dall'istanza principale.

   Puoi specificare una regione diversa utilizzando il parametro --region.

   Puoi aggiungere altri parametri per altre impostazioni dell'istanza. Per saperne di più, consulta gcloud sql instances create.

   Se l'istanza primaria ha solo un indirizzo IP interno e vuoi consentire ad altri servizi, come BigQuery, di accedere ai dati in Cloud SQL ed eseguire query su questi dati tramite una connessione interna, aggiungi il parametro --enable-google-private-path al comando. Google Cloud

   Devi creare la replica nella stessa rete VPC dell'istanza principale. Puoi anche specificare un allocated-ip-range-name in quella rete VPC. Se non viene specificato alcun intervallo, la replica viene creata in un intervallo casuale.

• Il logging binario è supportato sulle istanze di replica di lettura (solo MySQL 5.7 e versioni successive). Non supportato sulle repliche di failover HA legacy. Attiva la registrazione binaria su una replica con lo stesso comando gcloud CLI, utilizzando il nome dell'istanza della replica anziché quello dell'istanza primaria.

  gcloud sql instances patch REPLICA_INSTANCE_NAME \
  --enable-bin-log
      

  La durabilità del logging binario sulla replica (ma non sull'istanza primaria) può essere impostata con il flag sync_binlog, che controlla la frequenza con cui il server MySQL sincronizza il log binario sul disco.

  I backup non possono essere abilitati sulle istanze di replica, ma il logging binario può essere abilitato su una replica anche quando i backup sono disattivati, a differenza della replica primaria.

  Il periodo di conservazione dei log binari sulle istanze di replica è impostato automaticamente su un giorno, a differenza dei sette giorni delle istanze principali.

Terraform

Per creare una replica di lettura, utilizza la risorsa Terraform.

resource "google_sql_database_instance" "read_replica" {
  name                 = "mysql-replica-instance-name"
  master_instance_name = google_sql_database_instance.primary.name
  region               = "europe-west4"
  database_version     = "MYSQL_8_0"

  replica_configuration {
    failover_target = false
  }

  settings {
    tier              = "db-n1-standard-2"
    availability_type = "ZONAL"
    disk_size         = "100"
  }
  # 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 di Terraform in un progetto Google Cloud , completa i passaggi nelle sezioni seguenti.

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 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 di 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 viene 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 file main.tf appena creato.

   (Facoltativo) Copia il codice da GitHub. Questa operazione è 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 effettuare 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 di Terraform eseguendo il comando seguente e inserendo yes al prompt:

   terraform apply

   Attendi che Terraform visualizzi il messaggio "Apply complete!" (Applicazione completata).

3. Apri il tuo Google Cloud progetto 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 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

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

   terraform destroy

REST v1

1. Ottenere la configurazione di backup attuale

   Utilizza il metodo get della risorsa delle istanze per restituire la versione del database e la configurazione di backup corrente per il database primario.

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

   • project-id: l'ID progetto
   • primary-instance-name: il nome dell'istanza principale

   Metodo HTTP e URL:

   GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Esegui questo comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name"

   PowerShell (Windows)

   Esegui questo comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": false,
       "binaryLogEnabled": false
   }
   

2. Verificare che i campi di replica siano impostati

   Se enabled o pointInTimeEnabled sono false, utilizza il metodo patch della risorsa delle istanze per abilitarli entrambi. Nella richiesta, specifica le proprietà della configurazione di backup che vuoi modificare.

   Per abilitare i backup, imposta enabled su true e startTime su un orario del giorno nel formato HH:MM. Il parametro startTime è specificato in formato 24 ore, nel fuso orario UTC±00 e specifica l'inizio di un periodo di backup di 4 ore. I backup possono iniziare in qualsiasi momento durante la finestra di backup.

   Per abilitare il recupero point-in-time, imposta pointInTimeEnabled su true.

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

   • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
   • INSTANCE_NAME: il nome dell'istanza primaria o di replica di lettura che stai configurando per l'alta disponibilità
   • START_TIME: l'ora (in ore e minuti)

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   {
     "settings":
     {
       "backupConfiguration":
       {
         "startTime": "START_TIME",
         "enabled": true,
         "binaryLogEnabled": true
       }
     }
   }
   

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   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"

   PowerShell (Windows)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   $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

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

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

3. Crea la replica di lettura

   Utilizza il metodo insert della risorsa delle istanze per creare la replica di lettura. La proprietà databaseVersion deve essere uguale a quella principale. Se l'istanza primaria utilizza un indirizzo IP interno, puoi specificare un allocatedIpRange nello stesso modo in cui crei un'istanza primaria. Se non viene specificato alcun intervallo, la replica viene creata in un intervallo casuale. Per una replica di lettura tra regioni, specifica una regione diversa da quella dell'istanza principale.

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

   • project-id: l'ID progetto
   • database-version: stringa di versione dell'enumerazione (ad esempio, MYSQL_8_0)
   • primary-instance-name: il nome dell'istanza principale
   • primary-instance-region: la regione dell'istanza primaria
   • replica-region: La regione dell'istanza di replica
   • replica-name: il nome dell'istanza di replica
   • machine-type: stringa enum del tipo di macchina. Ad esempio: "db-custom-1-3840"
   • private-network: la rete autorizzata che stai aggiungendo o selezionando per creare una connessione privata.

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   {
     "masterInstanceName": "primary-instance-name",
     "project": "project-id",
     "databaseVersion": "database-version",
     "name": "replica-name",
     "region": "replica-region",
     "settings":
     {
       "tier": "machine-type",
       "settingsVersion": 0,
       "ipConfiguration": {
       object (IpConfiguration)
     },
     {
     "ipv4Enabled": false,
     "privateNetwork": private-network,
     "requireSsl": boolean,
     "authorizedNetworks": [
       {
         object (AclEntry)
       }
     ],
     "allocatedIpRange": string
       }
     }
   }
   

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   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"

   PowerShell (Windows)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   $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" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

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

REST v1beta4

1. Ottenere la configurazione di backup attuale

   Utilizza il metodo get della risorsa delle istanze per restituire la versione del database e la configurazione di backup corrente per il master.

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

   • project-id: l'ID progetto
   • primary-instance-name: il nome dell'istanza principale

   Metodo HTTP e URL:

   GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Esegui questo comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name"

   PowerShell (Windows)

   Esegui questo comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": false,
       "binaryLogEnabled": false
   }
   

2. Verificare che i campi di replica siano impostati

   Se enabled o binaryLogEnabled sono false nell'istanza principale, utilizza il metodo patch della risorsa delle istanze per attivarli entrambi. Nella richiesta, specifica le proprietà della configurazione di backup che vuoi modificare.

   Per abilitare i backup, imposta enabled su true e startTime su un orario del giorno nel formato HH:MM. Il parametro startTime è specificato in formato 24 ore, nel fuso orario UTC±00 e specifica l'inizio di un periodo di backup di 4 ore. I backup possono iniziare in qualsiasi momento durante la finestra di backup.

   Per abilitare il recupero point-in-time, imposta binaryLogEnabled su true nell'istanza primaria.

   Il logging binario è supportato sulle istanze di replica di lettura (solo MySQL 5.7 e versioni successive). Attiva la registrazione binaria su una replica con la stessa API, utilizzando l'ID istanza della replica anziché quello del database primario.

   La durabilità del logging binario sulla replica (ma non sull'istanza primaria) può essere impostata con il flag sync_binlog, che controlla la frequenza con cui il server MySQL sincronizza il log binario sul disco.

   I backup non possono essere abilitati sulle istanze di replica, ma il logging binario può essere abilitato su una replica anche quando i backup sono disattivati, a differenza della replica primaria.

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

   • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
   • INSTANCE_NAME: il nome dell'istanza primaria o di replica di lettura che stai configurando per l'alta disponibilità
   • START_TIME: l'ora (in ore e minuti)

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   {
     "settings":
     {
       "backupConfiguration":
       {
         "startTime": "START_TIME",
         "enabled": true,
         "binaryLogEnabled": true
       }
     }
   }
   

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   $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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

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

3. Crea la replica di lettura

   Utilizza il metodo insert della risorsa delle istanze per creare la replica di lettura. La proprietà databaseVersion deve essere uguale a quella principale. Se l'istanza primaria utilizza un indirizzo IP interno, puoi specificare un allocatedIpRange nello stesso modo in cui crei un'istanza primaria. Per una replica di lettura tra regioni, specifica una regione diversa da quella dell'istanza principale.

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

   • project-id: l'ID progetto
   • database-version: stringa di versione dell'enumerazione (ad esempio, MYSQL_8_0)
   • primary-instance-name: il nome dell'istanza principale
   • primary-instance-region: la regione dell'istanza primaria
   • replica-region: La regione dell'istanza di replica
   • replica-name: il nome dell'istanza di replica
   • machine-type: stringa enum del tipo di macchina. Ad esempio: "db-custom-1-3840"
   • private-network: la rete autorizzata che stai aggiungendo o selezionando per creare una connessione privata.

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   {
     "masterInstanceName": "primary-instance-name",
     "project": "project-id",
     "databaseVersion": "database-version",
     "name": "replica-name",
     "region": "replica-region",
     "settings":
     {
       "tier": "machine-type",
       "settingsVersion": 0,
       
       "ipConfiguration": {
       object (IpConfiguration)
     },
     {
     "ipv4Enabled": false,
     "privateNetwork": private-network,
     "requireSsl": boolean,
     "authorizedNetworks": [
       {
         object (AclEntry)
       }
     ],
     "allocatedIpRange": string
       }
       
     }
   }
   

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   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"

   PowerShell (Windows)

   Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

   $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" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

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

gcloud

Per creare una replica di lettura di un'istanza, utilizza il comando gcloud sql instances create:

gcloud sql instances create REPLICA_INSTANCE_NAME \
--master-instance-name=PRIMARY_INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--availability-type=AVAILABILITY_TYPE \
--no-assign-ip

Effettua le seguenti sostituzioni:

• REPLICA_INSTANCE_NAME: il nome dell'istanza di replica.
• PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
• REGION_NAME: il nome della regione per l'istanza di replica.

• ALLOWED_PROJECTS: un elenco di ID o numeri di progetto consentiti, separati da virgole. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.

  Cloud SQL non copia i progetti consentiti per l'istanza principale nella replica. Per ogni replica, devi creare un endpoint Private Service Connect. Se utilizzi il proxy di autenticazione Cloud SQL o i connettori dei linguaggi di Cloud SQL, crea una zona DNS e un record DNS per le repliche.

• AVAILABILITY_TYPE: attiva l'alta disponibilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
  • REGIONAL: abilita l'alta disponibilità ed è consigliato per le istanze di produzione. L'istanza esegue il failover a un'altra zona all'interno della regione selezionata.
  • ZONAL: non forniscono funzionalità di failover. Questo è il valore predefinito.

  Per saperne di più su come impostare e rimuovere l'alta disponibilità per le istanze, consulta Configurare un'istanza esistente per l'alta disponibilità e Disattivare l'alta disponibilità per un'istanza.

REST v1

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

• PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
• REPLICA_INSTANCE_NAME: il nome dell'istanza di replica.
• REGION_NAME: il nome della regione per l'istanza di replica.
• MACHINE_TYPE: il tipo di macchina per l'istanza
• AVAILABILITY_TYPE: attiva l'alta disponibilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
  • REGIONAL: abilita l'alta disponibilità ed è consigliato per le istanze di produzione. L'istanza esegue il failover a un'altra zona all'interno della regione selezionata.
  • ZONAL: non forniscono funzionalità di failover. Questo è il valore predefinito.

  Per saperne di più su come impostare e rimuovere l'alta disponibilità per le istanze, consulta Configurare un'istanza esistente per l'alta disponibilità e Disattivare l'alta disponibilità per un'istanza.

• ALLOWED_PROJECTS: un elenco di ID o numeri di progetto consentiti, separati da virgole. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.

  Cloud SQL non copia i progetti consentiti per l'istanza principale nella replica. Per ogni replica, devi creare un endpoint Private Service Connect. Se utilizzi il proxy di autenticazione Cloud SQL o i connettori dei linguaggi di Cloud SQL, devi creare una zona DNS e un record DNS per le repliche.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

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"

$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" | 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/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

• PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
• REPLICA_INSTANCE_NAME: il nome dell'istanza di replica.
• REGION_NAME: il nome della regione per l'istanza di replica.
• MACHINE_TYPE: il tipo di macchina per l'istanza
• AVAILABILITY_TYPE: attiva l'alta disponibilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
  • REGIONAL: abilita l'alta disponibilità ed è consigliato per le istanze di produzione. L'istanza esegue il failover a un'altra zona all'interno della regione selezionata.
  • ZONAL: non forniscono funzionalità di failover. Questo è il valore predefinito.

  Per saperne di più su come impostare e rimuovere l'alta disponibilità per le istanze, consulta Configurare un'istanza esistente per l'alta disponibilità e Disattivare l'alta disponibilità per un'istanza.

• ALLOWED_PROJECTS: un elenco di ID o numeri di progetto consentiti, separati da virgole. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.

  Cloud SQL non copia i progetti consentiti per l'istanza principale nella replica. Per ogni replica, devi creare un endpoint Private Service Connect. Se utilizzi il proxy di autenticazione Cloud SQL o i connettori dei linguaggi di Cloud SQL, devi creare una zona DNS e un record DNS per le repliche.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],  
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

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"

$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" | 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/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Console

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

   Vai a Istanze Cloud SQL

2. Per MySQL 5.7 o versioni successive, attiva la replica.
3. Fai clic sulla scheda Repliche per la replica che fungerà da elemento principale per la replica che vuoi creare.
4. Fai clic su Crea replica.
5. Nella pagina Crea replica di lettura, aggiorna l'ID istanza e qualsiasi altra opzione di configurazione, inclusi nome, regione e zona.
6. Fai clic su Crea.

   Cloud SQL crea una replica. Tornerai alla pagina dell'istanza della replica principale.

7. Segui i passaggi 4-6 per ogni nuova replica in cascata che vuoi creare.

gcloud

1. Se utilizzi MySQL versione 5.7 o successive, abilita i binlog per il primario della nuova replica:
   

   gcloud sql instances patch --enable-bin-log PARENT_REPLICA_NAME

   Sostituisci PARENT_REPLICA_NAME con il nome della replica principale.
2. Crea la nuova replica specificando la replica primaria come istanza primaria utilizzando il flag --master-instance-name:

gcloud sql instances create REPLICA_NAME \
      --master-instance-name=PARENT_REPLICA_NAME \

Sostituisci quanto segue:

• REPLICA_NAME: l'ID univoco della replica che stai creando
• PARENT_REPLICA_NAME: il nome della replica principale
3. Dopo aver creato la replica a cascata, puoi notare che le modifiche apportate all'istanza principale vengono replicate in tutte le repliche della catena di repliche a cascata.

curl

1. Se utilizzi MySQL versione 5.7 o successive, abilita la registrazione binaria:
   
   Per abilitare la registrazione binaria, salva il seguente JSON in un file denominato request.JSON, poi richiama il comando curl per abilitare la registrazione binaria.
   

   {
     "settings":
     {
       "backupConfiguration":
       {
         "enabled": false,
         "binaryLogEnabled": true
       }
     }
   }

2. Per creare una replica nella replica principale, modifica il seguente esempio di codice JSON e salvalo in un file denominato request.json:

   {
     "masterInstanceName": "PARENT_REPLICA_NAME",
     "project": "PROJECT_ID",
     "name": "REPLICA_NAME",
     "region": "REPLICA_REGION",
     "settings":
       {
         "tier": "MACHINE_TYPE",
       }
   }

3. Esegui questo comando:

   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"