Utilizzare la replica tra regioni

La replica tra regioni consente di creare istanze secondarie da un'istanza principale per rendere l'istanza disponibile in regioni diverse. Se la regione dell'istanza principale non è più disponibile, puoi scollegare o eseguire il cambio a un'istanza secondaria in un'altra regione per gestire le richieste di lettura e scrittura. Le istanze secondarie gestiscono le richieste di lettura senza scollegare o eseguire il cambio all'istanza principale. La distribuzione geografica dei dati li avvicina a te e riduce la latenza di lettura. Se in una regione si verificano connessioni lente o sovraccariche, puoi instradare il traffico verso un'altra regione.

Nota: per creare un'istanza secondaria, devi avere una policy di rete di servizio nella regione in cui vuoi che si trovi l'istanza l'istanza. Per saperne di più sulle policy di rete di servizio, consulta Networking.

Per una panoramica concettuale della replica tra regioni, consulta Informazioni sulla replica tra regioni.

Creare un'istanza secondaria

Quando crei un'istanza secondaria, Memorystore for Valkey copia e applica alcune impostazioni dell'istanza principale come impostazioni dell'istanza secondaria. Per saperne di più, consulta Impostazioni dell'istanza.

Puoi creare un'istanza secondaria in Memorystore for Valkey utilizzando la Google Cloud console o la Google Cloud CLI.

Console

1. Nella Google Cloud console, vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic su un'istanza principale. L'istanza principale è il parent dell'istanza secondaria che stai creando.

   Nota: non fare clic su un'istanza secondaria perché Memorystore for Valkey non supporta le repliche a cascata. Inoltre, non fare clic su un'istanza principale se ha già due istanze secondarie, perché un'istanza principale può avere al massimo due istanze secondarie.

   Se non vengono visualizzate istanze principali, creane una. Dopo averla creata, puoi farci clic sopra.

3. Nel riquadro laterale, fai clic sulla scheda Istanze secondarie.

4. Fai clic su Aggiungi istanza secondaria.

5. Nella finestra Aggiungi istanze secondarie, apporta le seguenti modifiche:

   1. Nel campo ID istanza, inserisci l'ID dell'istanza secondaria che stai creando. L'ID deve contenere da 1 a 63 caratteri e utilizzare solo lettere minuscole, numeri o trattini. Deve iniziare con una lettera minuscola, terminare con una lettera minuscola o un numero ed essere univoco nella sua regione.

   2. Dal menu Regione, seleziona la regione in cui vuoi che si trovi l'istanza secondaria.

   3. Nella sezione Disponibilità a livello di zona, seleziona una delle seguenti opzioni:

      • Se vuoi che tutti gli shard e le repliche dell'istanza siano distribuiti in tre zone della regione in cui Memorystore for Valkey crea l'istanza, seleziona l'opzione Più zone.

        Ad esempio, se la regione selezionata è us-central1, e selezioni l'opzione Più zone, Memorystore for Valkey distribuisce gli shard e le repliche dell'istanza nelle zone us-central1-a, us-central1-b e
        us-central1-c. In caso di errore a livello di zona, i nodi dell'istanza eseguono il failover nelle repliche.

      • Se vuoi che tutti gli shard e le repliche dell'istanza si trovino in una zona della regione in cui Memorystore for Valkey crea l'istanza, seleziona l'opzione Zona singola, quindi seleziona la zona dal menu Zona.

        L'utilizzo di una singola zona riduce i costi di rete. Tuttavia, in caso di errore a livello di zona, il failover non viene eseguito.

   4. Dal menu Repliche, seleziona il numero di repliche (per shard) per l'istanza. Puoi avere zero, una o due repliche.

   5. Dal menu Rete, seleziona una rete per l'istanza. Per saperne di più sul networking per Memorystore for Valkey, consulta Networking.

6. Fai clic su Aggiungi istanza secondaria.

gcloud

Nota: se hai installato gcloud CLI, assicurati di avere l'ultima versione eseguendo gcloud components update. Per gestire la replica tra regioni per Memorystore for Valkey, devi avere almeno gcloud CLI versione 488.0.0.

Per creare un'istanza secondaria, utilizza il gcloud memorystore instances create comando.

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=NETWORK,projectId=PROJECT_ID \
--primary-instance=PRIMARY_INSTANCE_PATH

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza secondaria che stai creando. L'ID deve contenere da 1 a 63 caratteri e utilizzare solo lettere minuscole, numeri o trattini. Deve iniziare con una lettera minuscola, terminare con una lettera minuscola o un numero ed essere univoco nella sua regione.
• PROJECT_ID: l'ID del progetto in cui vuoi creare l'istanza secondaria. Si tratta dello stesso progetto in cui si trova l'istanza principale.
• REGION_ID: l'ID della regione in cui vuoi che si trovi l'istanza secondaria.
• NETWORK: la rete utilizzata per creare l'istanza. Deve utilizzare questo formato: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. L'ID rete deve corrispondere all'ID rete utilizzato dalla policy di connessione al servizio. In caso contrario, non puoi creare l'istanza secondaria.
• PRIMARY_INSTANCE_PATH: il percorso dell'istanza principale. Ad esempio: projects/my-project/locations/us-central1/instances/my-primary-instance. Puoi scegliere qualsiasi istanza del tuo progetto come istanza principale, purché non sia un'istanza secondaria.

Ad esempio:

gcloud memorystore instances create my-secondary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=projects/my-project/global/networks/default,projectId=my-project \
--primary-instance=projects/my-project/locations/us-central1/instances/my-primary-instance

Visualizzare un'istanza secondaria

Puoi visualizzare le informazioni di riepilogo su un'istanza secondaria utilizzando la Google Cloud console o Google Cloud CLI.

Console

1. Nella Google Cloud console, vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic sulla freccia di espansione accanto a un'istanza principale. Questa istanza è il parent dell'istanza secondaria di cui vuoi visualizzare le informazioni.

3. Fai clic sull'istanza secondaria. Vengono visualizzate le informazioni di riepilogo sull'istanza.

gcloud

Per visualizzare le informazioni su un'istanza secondaria, incluso un campo di appartenenza che elenca le istanze principali e secondarie nel gruppo di replica, utilizza il gcloud memorystore instances describe comando.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza secondaria
• PROJECT_ID: l'ID del progetto che contiene l'istanza secondaria
• REGION_ID: l'ID della regione in cui si trova l'istanza secondaria

Eseguire un cambio

Un cambio consente di invertire i ruoli delle istanze principali e secondarie promuovendo un'istanza secondaria a istanza principale per scopi di ripristino di emergenza. Per saperne di più, consulta Informazioni sulla replica tra regioni.

Puoi eseguire un cambio utilizzando la Google Cloud console o il Google Cloud CLI.

Nota: prima di eseguire un cambio, segui le istruzioni riportate in Best practice per il cambio di istanze principali e secondarie. Seguendo queste istruzioni, la tua applicazione può tenere traccia delle scritture che esegue e inviarle all'istanza appropriata.

Console

1. Nella Google Cloud console, vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic sulla freccia di espansione accanto a un'istanza principale. Questa istanza è il parent dell'istanza secondaria a cui vuoi eseguire il cambio.

3. Fai clic sull'istanza secondaria.

4. Fai clic su Promuovi a principale.

5. Nella finestra di dialogo Promuovere l'istanza secondaria a principale?, inserisci l'ID dell'istanza secondaria, quindi fai clic su Promuovi.

Una volta completato il cambio, devi riconnettere le applicazioni alla nuova istanza principale.

gcloud

Per eseguire un cambio, utilizza il gcloud memorystore instances update comando.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCE_PATH]

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza secondaria che vuoi promuovere a istanza principale eseguendo il cambio.
• PROJECT_ID: l'ID del progetto che contiene l'istanza secondaria.
• REGION_ID: l'ID della regione in cui si trova l'istanza secondaria.

• SECONDARY_INSTANCE_PATH: il percorso dell'istanza secondaria. Ad esempio: projects/my-project/locations/us-central1/instances/my-secondary-instance.

  Se hai più istanze secondarie, separale con virgole. Ad esempio: [instance=projects/my-project/locations/us-central1/instances/my-first-secondary-instance,instance=projects/my-project/locations/europe-west1/instances/my-second-secondary-instance].

Supponiamo che tu abbia le seguenti istanze contenute nel progetto my-project:

• instance-1: questa istanza principale si trova nella regione us-east1.
• instance-2: questa istanza secondaria si trova nella regione asia-east1.
• instance-3: questa istanza secondaria si trova nella regione southamerica-east1.

Vuoi invertire i ruoli di instance-1 e instance-2 in modo che instance-2 sia la nuova istanza principale e instance-1 sia un'istanza secondaria.

Per farlo, utilizza il seguente codice:

gcloud memorystore instances update instance-2 \
--project=my-project \
--location=asia-east1 \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-east1/instances/instance-1,instance=projects/my-project/locations/southamerica-east1/instances/instance-3]

Una volta completato il cambio, devi riconnettere le applicazioni alla nuova istanza principale.

Scollegare le istanze secondarie

Lo scollegamento di una o più istanze secondarie dalla relativa istanza principale le rende istanze indipendenti e completamente funzionali che consentono operazioni di lettura e scrittura. Per saperne di più, consulta Come gestire la replica tra regioni.

Puoi scollegare le istanze secondarie utilizzando la Google Cloud console o il Google Cloud CLI.

Scollegare un'istanza secondaria

Questa sezione spiega come scollegare un'istanza secondaria dalla relativa istanza principale.

Console

1. Nella Google Cloud console, vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic su un'istanza principale. Questo è il parent dell'istanza secondaria che stai scollegando dall'istanza principale.

3. Nel riquadro laterale, fai clic sulla scheda Istanze secondarie.

4. Seleziona la casella di controllo accanto all'ID dell'istanza secondaria che stai scollegando dall'istanza principale.

5. Fai clic su Scollega da principale.

6. Nella finestra di dialogo Scollegare l'istanza secondaria?, inserisci l'ID dell'istanza secondaria, quindi fai clic su Scollega.

gcloud

Per scollegare un'istanza secondaria, utilizza il gcloud memorystore instances update comando.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=none \
--clear-primary-instance

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza secondaria che vuoi scollegare
• PROJECT_ID: l'ID del progetto che contiene l'istanza secondaria
• REGION_ID: la regione in cui si trova l'istanza secondaria

Scollegare più istanze secondarie

Questa sezione spiega come scollegare più istanze secondarie dalla relativa istanza principale. Puoi anche utilizzare la procedura descritta in questa sezione per scollegare un'istanza secondaria non disponibile dalla relativa istanza principale.

Console

1. Nella Google Cloud console, vai alla pagina Memorystore for Valkey.

   Memorystore for Valkey

2. Fai clic su un'istanza principale. Questo è il parent delle istanze secondarie che stai scollegando dall'istanza principale.

3. Nel riquadro laterale, fai clic sulla scheda Istanze secondarie.

4. Seleziona le caselle di controllo accanto agli ID delle istanze secondarie che stai scollegando dall'istanza principale.

5. Fai clic su Scollega da principale.

6. Nella finestra di dialogo Scollegare le istanze secondarie?:

   1. Inserisci gli ID delle istanze secondarie. Utilizza le virgole per separare gli ID.

   2. Fai clic su Scollega.

gcloud

Per scollegare più istanze secondarie, utilizza il gcloud memorystore instances update comando.

gcloud memorystore instances update PRIMARY_INSTANCE_ID \
--project=PROJECT_ID \
--location=PRIMARY_INSTANCE_REGION_ID \
--remove-cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCES] \
--cross-instance-replication-config-role=none

Sostituisci quanto segue:

• PRIMARY_INSTANCE_ID: l'ID dell'istanza principale.
• PROJECT_ID: l'ID del progetto che contiene le istanze secondarie.
• PRIMARY_INSTANCE_REGION_ID: l'ID della regione in cui si trova l' istanza principale.
• SECONDARY_INSTANCES: le istanze secondarie che vuoi scollegare. Utilizza le virgole per separare gli ID istanza. Ogni istanza secondaria deve avere questo formato: projects/PROJECT_ID/locations/SECONDARY_INSTANCE_REGION_ID/instances/INSTANCE_ID.

Ad esempio:

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--remove-cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-west4/instances/my-secondary-instance-1,instance=projects/my-project/locations/asia-southeast2/instances/my-secondary-instance-2] \
--cross-instance-replication-config-role=none

Nota: La riga di codice --cross-instance-replication-config-role=none è facoltativa. Se vuoi scollegare tutte le istanze secondarie dall'istanza principale, devi utilizzare questo codice. Di conseguenza, l'istanza principale diventa un'istanza indipendente.

Puoi anche scollegare le istanze secondarie dall'istanza principale mediante la specificazione di un elenco di istanze che non vuoi scollegare. Memorystore for Valkey scollega tutte le istanze che non includi in questo elenco.

Supponiamo che tu abbia le seguenti istanze secondarie:

• instance-1: questa istanza si trova nella regione us-east1.
• instance-2: questa istanza si trova nella regione asia-east1.

Vuoi scollegare entrambe le istanze secondarie da my-primary-instance. Questa istanza principale si trova nella regione us-central1 ed è contenuta nel progetto my-project.

Per scollegare le istanze secondarie, utilizza il seguente codice:

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-secondary-instances=[]
--cross-instance-replication-config-role=none

In questo esempio, poiché il valore null [] è assegnato al parametro --cross-instance-replication-config-secondary-instances, Memorystore for Valkey scollega tutte le istanze secondarie dall'istanza principale.

Aggiornare le impostazioni dell'istanza

Questa sezione fornisce link per aggiornare le impostazioni dell'istanza. La procedura per aggiornare le impostazioni dell'istanza è diversa a seconda che tu modifichi le impostazioni dell'istanza principale o dell'istanza secondaria. Per saperne di più su come aggiornare le impostazioni, consulta Impostazioni dell'istanza.

Aggiornare le impostazioni dell'istanza principale

Devi modificare le seguenti impostazioni dell'istanza principale. Dopodiché, Memorystore for Valkey sincronizza le modifiche con l'istanza secondaria.

• Scalare la capacità dell'istanza
• Configurare l'istanza
• Impedire l'eliminazione dell'istanza
• Gestire la persistenza per l'istanza

Aggiornare le impostazioni dell'istanza secondaria

Devi modificare le seguenti impostazioni dell'istanza secondaria:

• Configurare se l'istanza è a zona singola o a più zone
• Scalare il numero di repliche dell'istanza
• Impostare i periodi di manutenzione per l'istanza

Eliminare le istanze che utilizzano la replica tra regioni

Questa sezione spiega come eliminare le istanze principali e secondarie che utilizzano la replica tra regioni.

Eliminare un'istanza principale

Per eliminare un'istanza principale:

1. Scollega o elimina tutte le istanze secondarie.
2. Per eliminare l'istanza principale, segui le istruzioni riportate in Eliminare le istanze.

Per proteggerti da eliminazioni accidentali, non puoi eliminare contemporaneamente le istanze principali e secondarie.

Eliminare un'istanza secondaria

Per eliminare un'istanza secondaria, segui le istruzioni riportate in Eliminare le istanze. Per l'ID istanza, utilizza l'ID dell'istanza secondaria.