Trabajar con la replicación entre regiones

Consola

1. En la Google Cloud consola, ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en una instancia principal. La instancia principal es la instancia superior de la instancia secundaria que vas a crear.

3. En el panel lateral, haz clic en la pestaña Instancias secundarias.

4. Haz clic en Añadir instancia secundaria.

5. En la ventana Añadir instancias secundarias, haz los siguientes cambios:

   1. En el campo ID de instancia, introduce el ID de la instancia secundaria que vas a crear. El ID debe tener entre 1 y 63 caracteres y solo puede contener letras en minúscula, números o guiones. Debe empezar por una letra minúscula, terminar por una letra minúscula o un número, y ser único en su región.

   2. En el menú Región, selecciona la región en la que quieres que se encuentre la instancia secundaria.

   3. En la sección Disponibilidad por zonas, seleccione una de las siguientes opciones:

      • Si quieres que todos los fragmentos y réplicas de la instancia se distribuyan en tres zonas de la región en la que Memorystore para Valkey crea la instancia, selecciona la opción Multizona.

        Por ejemplo, si seleccionas la región us-central1 y la opción Multizona, Memorystore para Valkey distribuirá los fragmentos y las réplicas de la instancia en las zonas us-central1-a, us-central1-b y
        us-central1-c. En caso de que se produzca un fallo por zonas, los nodos de la instancia conmutan por error a las réplicas.

      • Si quieres que todos los fragmentos y réplicas de la instancia se ubiquen en una zona de la región en la que Memorystore para Valkey crea la instancia, selecciona la opción Una zona y, a continuación, elige la zona en el menú Zona.

        Si usas una sola zona, reduces los costes de red. Sin embargo, en caso de que se produzca un error en una zona, no se producirá una conmutación por error.

   4. En el menú Réplicas, selecciona el número de réplicas (por fragmento) de la instancia. Puedes tener cero, una o dos réplicas.

   5. En el menú Red, selecciona una red para la instancia. Para obtener más información sobre las redes de Memorystore para Valkey, consulta Redes.

6. Haz clic en Añadir instancia secundaria.

gcloud

Para crear una instancia secundaria, usa el 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

Haz las siguientes sustituciones:

• INSTANCE_ID: el ID de la instancia secundaria que vas a crear. El ID debe tener entre 1 y 63 caracteres y solo puede incluir letras minúsculas, números o guiones. Debe empezar por una letra minúscula, terminar por una letra minúscula o un número, y ser único en su región.
• PROJECT_ID: el ID del proyecto en el que quieres crear la instancia secundaria. Es el mismo proyecto en el que se encuentra tu instancia principal.
• REGION_ID: el ID de la región en la que quieres que se encuentre la instancia secundaria.
• NETWORK: la red usada para crear la instancia. Debe usar este formato: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. El ID de red debe coincidir con el que usa la política de conexión de servicio. De lo contrario, no podrás crear la instancia secundaria.
• PRIMARY_INSTANCE_PATH: la ruta de la instancia principal. Por ejemplo: projects/my-project/locations/us-central1/instances/my-primary-instance. Puedes elegir cualquier instancia de tu proyecto como instancia principal, siempre que no sea una instancia secundaria.

Por ejemplo:

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

Consola

1. En la Google Cloud consola, ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en la flecha de expansión situada junto a una instancia principal. Esta instancia es la instancia principal de la instancia secundaria sobre la que quieres ver información.

3. Haz clic en la instancia secundaria. Se muestra información resumida sobre la instancia.

gcloud

Para ver información sobre una instancia secundaria, incluido un campo de pertenencia que enumera las instancias principales y secundarias del grupo de replicación, usa el comando gcloud memorystore instances describe.

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

Haz las siguientes sustituciones:

• INSTANCE_ID: el ID de la instancia secundaria
• PROJECT_ID: el ID del proyecto que contiene la instancia secundaria
• REGION_ID: ID de la región en la que se encuentra la instancia secundaria.

Consola

1. En la Google Cloud consola, ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en la flecha de expansión situada junto a una instancia principal. Esta instancia es la principal de la instancia secundaria a la que quieres cambiar.

3. Haz clic en la instancia secundaria.

4. Haz clic en Promocionar a principal.

5. En el cuadro de diálogo ¿Promocionar instancia secundaria a primaria?, introduce el ID de la instancia secundaria y, a continuación, haz clic en Promocionar.

Una vez completado el cambio, debes volver a conectar tus aplicaciones a la nueva instancia principal.

gcloud

Para hacer un cambio, usa el 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]

Haz las siguientes sustituciones:

• INSTANCE_ID: el ID de la instancia secundaria que quieres convertir en principal realizando el cambio.
• PROJECT_ID: el ID del proyecto que contiene la instancia secundaria.
• REGION_ID: el ID de la región en la que se encuentra la instancia secundaria.

• SECONDARY_INSTANCE_PATH: la ruta de la instancia secundaria. Por ejemplo: projects/my-project/locations/us-central1/instances/my-secondary-instance.

  Si tienes varias instancias secundarias, sepáralas con comas. Por ejemplo: [instance=projects/my-project/locations/us-central1/instances/my-first-secondary-instance,instance=projects/my-project/locations/europe-west1/instances/my-second-secondary-instance].

Supongamos que tienes las siguientes instancias en el proyecto my-project:

• instance-1: esta instancia principal se encuentra en la región us-east1.
• instance-2: esta instancia secundaria se encuentra en la región asia-east1.
• instance-3: esta instancia secundaria se encuentra en la región southamerica-east1.

Quieres invertir los roles de instance-1 y instance-2 para que instance-2 sea la nueva instancia principal y instance-1 sea una instancia secundaria.

Para ello, utiliza el siguiente código:

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 vez completado el cambio, debes volver a conectar tus aplicaciones a la nueva instancia principal.

Consola

1. En la Google Cloud consola, ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en una instancia principal. Es el elemento superior de la instancia secundaria que vas a separar de la instancia principal.

3. En el panel lateral, haz clic en la pestaña Instancias secundarias.

4. Seleccione la casilla situada junto al ID de la instancia secundaria que quiera separar de la principal.

5. Haz clic en Desasociar de la principal.

6. En el cuadro de diálogo ¿Desasociar instancia secundaria?, introduce el ID de la instancia secundaria y, a continuación, haz clic en Desasociar.

gcloud

Para separar una instancia secundaria, usa el 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

Haz los cambios siguientes:

• INSTANCE_ID: el ID de la instancia secundaria que quieres separar.
• PROJECT_ID: el ID del proyecto que contiene la instancia secundaria
• REGION_ID: la región en la que se encuentra la instancia secundaria

Consola

1. En la Google Cloud consola, ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en una instancia principal. Es el elemento superior de las instancias secundarias que vas a separar de la instancia principal.

3. En el panel lateral, haz clic en la pestaña Instancias secundarias.

4. Seleccione las casillas situadas junto a los IDs de las instancias secundarias que quiera separar de la instancia principal.

5. Haz clic en Desasociar de la principal.

6. En el cuadro de diálogo ¿Desasociar instancias secundarias?, haz lo siguiente:

   1. Introduce los IDs de las instancias secundarias. Usa comas para separar los IDs.

   2. Haz clic en Desacoplar.

gcloud

Para separar varias instancias secundarias, usa el 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

Haz las siguientes sustituciones:

• PRIMARY_INSTANCE_ID: el ID de la instancia principal.
• PROJECT_ID: el ID del proyecto que contiene las instancias secundarias.
• PRIMARY_INSTANCE_REGION_ID: el ID de la región en la que se encuentra la instancia principal.
• SECONDARY_INSTANCES: las instancias secundarias que quieras desasociar. Usa comas para separar los IDs de instancia. Cada instancia secundaria debe tener este formato: projects/PROJECT_ID/locations/SECONDARY_INSTANCE_REGION_ID/instances/INSTANCE_ID.

Por ejemplo:

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

También puedes separar instancias secundarias de la principal especificando una lista de instancias que no quieras separar. Memorystore for Valkey separa las instancias que no incluyas en esta lista.

Supongamos que tienes las siguientes instancias secundarias:

• instance-1: esta instancia se encuentra en la región us-east1.
• instance-2: esta instancia se encuentra en la región asia-east1.

Quieres separar ambas instancias secundarias de my-primary-instance. Esta instancia principal se encuentra en la región us-central1 y está incluida en el proyecto my-project.

Para separar las instancias secundarias, usa el siguiente código:

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

En este ejemplo, como el valor nulo [] se asigna al parámetro --cross-instance-replication-config-secondary-instances, Memorystore for Valkey separa todas las instancias secundarias de la instancia principal.