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
Nella console Google Cloud , vai alla pagina Memorystore for Valkey.
Fai clic su un'istanza principale. L'istanza principale è l'istanza secondaria che stai creando.
Nel riquadro laterale, fai clic sulla scheda Istanze secondarie.
Fai clic su Aggiungi istanza secondaria.
Nella finestra Aggiungi istanze secondarie, apporta le seguenti modifiche:
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.
Dal menu Regione, seleziona la regione in cui vuoi che si trovi l'istanza secondaria.
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 zoneus-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.
Nel menu Repliche, seleziona il numero di repliche (per shard) per l'istanza. Puoi avere zero, una o due repliche.
Dal menu Rete, seleziona una rete per l'istanza. Per ulteriori informazioni sul networking per Memorystore for Valkey, vedi Networking.
Fai clic su Aggiungi istanza secondaria.
gcloud
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
Nella console Google Cloud , vai alla pagina Memorystore for Valkey.
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.
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.
Console
Nella console Google Cloud , vai alla pagina Memorystore for Valkey.
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.
Fai clic sull'istanza secondaria.
Fai clic su Promuovi a principale.
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 regioneus-east1
.instance-2
: questa istanza secondaria si trova nella regioneasia-east1
.instance-3
: questa istanza secondaria si trova nella regionesouthamerica-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
Nella console Google Cloud , vai alla pagina Memorystore for Valkey.
Fai clic su un'istanza principale. Questo è il progetto padre dell'istanza secondaria che stai scollegando dall'istanza principale.
Nel riquadro laterale, fai clic sulla scheda Istanze secondarie.
Seleziona la casella di controllo accanto all'ID dell'istanza secondaria che stai scollegando dall'istanza principale.
Fai clic su Scollega da principale.
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
Nella console Google Cloud , vai alla pagina Memorystore for Valkey.
Fai clic su un'istanza principale. Questo è il parent delle istanze secondarie che stai scollegando dall'istanza principale.
Nel riquadro laterale, fai clic sulla scheda Istanze secondarie.
Seleziona le caselle di controllo accanto agli ID delle istanze secondarie che stai scollegando dall'istanza primaria.
Fai clic su Scollega da principale.
Nella finestra di dialogo Scollegare le istanze secondarie?, procedi nel seguente modo:
Inserisci gli ID delle istanze secondarie. Utilizza le virgole per separare gli ID.
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
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 regioneus-east1
.instance-2
: questa istanza si trova nella regioneasia-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:
- Scollega o elimina tutte le istanze secondarie.
- 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.