Utilizzare la replica tra regioni

Nota: per creare un'istanza secondaria, devi disporre di un criterio di rete del servizio nella regione in cui vuoi che si trovi l'istanza. Per ulteriori informazioni sulle norme relative alle reti di servizi, consulta la sezione Networking.

Questa pagina descrive come utilizzare la replica tra regioni creando e gestendo istanze secondarie.

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

Crea 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 ulteriori informazioni, vedi Impostazioni dell'istanza.

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

Console

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

   Memorystore for Valkey

2. Fai clic su un'istanza principale. L'istanza principale è l'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 non può avere più di due istanze secondarie.

   Se non vengono visualizzate istanze principali, creane una. Dopo averlo creato, 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 rispettiva regione.

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

   3. Nella sezione Disponibilità per zona, seleziona una delle seguenti opzioni:

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

        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 nell'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 e poi seleziona la zona dal menu Zona.

        Utilizzando una singola zona, riduci i costi di rete. Tuttavia, in caso di errore a livello di zona, il failover non viene eseguito.

   4. Nel 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 ulteriori informazioni sul networking per Memorystore for Valkey, vedi 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 disporre almeno della versione 488.0.0 di gcloud CLI.

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

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

Effettua le seguenti sostituzioni:

• 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 rispettiva 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 di rete deve corrispondere all'ID di rete utilizzato dalle norme di connessione al servizio. In caso contrario, non potrai 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, a condizione che 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 consoleGoogle Cloud o Google Cloud CLI.

Console

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

   Memorystore for Valkey

2. Fai clic sulla freccia di espansione accanto a un'istanza principale. Questa istanza è l'istanza principale 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 primaria e secondaria nel gruppo di replica, utilizza il comando gcloud memorystore instances describe.

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

Effettua le seguenti sostituzioni:

• 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 principale e secondaria promuovendo un'istanza secondaria a principale per ilripristino di emergenzay. Per saperne di più, consulta Informazioni sulla replica tra regioni.

Puoi eseguire un failover utilizzando la console Google Cloud o 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 effettuate e inviarle all'istanza appropriata.

Console

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

   Memorystore for Valkey

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

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 e poi fai clic su Promuovi.

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

gcloud

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

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]

Effettua le seguenti sostituzioni:

• 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 di avere 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 primaria 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 dall'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 console Google Cloud o Google Cloud CLI.

Scollegare un'istanza secondaria

Questa sezione spiega come scollegare un'istanza secondaria dall'istanza principale.

Console

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

   Memorystore for Valkey

2. Fai clic su un'istanza principale. Questo è il progetto padre 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 e poi fai clic su Scollega.

gcloud

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

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 primaria. Puoi anche utilizzare la procedura descritta in questa sezione per scollegare un'istanza secondaria non disponibile dalla relativa istanza principale.

Console

1. Nella console Google Cloud , 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 primaria.

5. Fai clic su Scollega da principale.

6. Nella finestra di dialogo Scollegare le istanze secondarie?, procedi nel seguente modo:

   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 comando gcloud memorystore instances update.

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

Effettua le seguenti sostituzioni:

• PRIMARY_INSTANCE_ID: l'ID dell'istanza primaria.
• 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 primaria.
• 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 primaria, devi utilizzare questo codice. Di conseguenza, l'istanza principale diventa un'istanza indipendente.

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

Supponiamo di avere 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 primaria 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

Per 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.

Aggiorna 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 primaria o secondaria. Per ulteriori informazioni su come aggiornare le impostazioni, vedi Impostazioni dell'istanza.

Aggiorna le impostazioni dell'istanza principale

Devi modificare le seguenti impostazioni nell'istanza principale. Dopodiché, Memorystore for Valkey sincronizza le modifiche all'istanza secondaria.

• Scalare la capacità dell'istanza
• Configura l'istanza
• Impedisci l'eliminazione dell'istanza
• Gestisci la persistenza per l'istanza

Aggiorna le impostazioni dell'istanza secondaria

Devi modificare le seguenti impostazioni nell'istanza secondaria:

• Configura se l'istanza è a zona singola o multizona
• Scalare il numero di repliche dell'istanza
• Impostare i periodi di manutenzione per l'istanza

Elimina le istanze che utilizzano la replica tra regioni

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

Elimina un'istanza principale

Per eliminare un'istanza primaria:

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.

Elimina 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.