Trabaja con la replicación entre regiones

La replicación entre regiones te permite crear instancias secundarias a partir de una instancia principal para que la instancia esté disponible en diferentes regiones. Si la región de la instancia principal deja de estar disponible, puedes desconectarte o cambiar a una instancia secundaria en otra región para atender las solicitudes de lectura y escritura. Las instancias secundarias atienden las solicitudes de lectura sin desconectarse ni cambiar a la instancia principal. La distribución geográfica de los datos los acerca a ti y disminuye la latencia de lectura. Si se producen conexiones lentas o sobrecargadas en una región, puedes enrutar el tráfico a otra región.

Nota: Para crear una instancia secundaria, debes tener una política de red de servicio en la región en la que deseas que se ubique la instancia. Para obtener más información sobre las políticas de red de servicio, consulta Herramientas de redes.

Además, para obtener una descripción general conceptual de la replicación entre regiones, consulta Acerca de la replicación entre regiones.

Crea una instancia secundaria

Cuando creas una instancia secundaria, Memorystore para Valkey copia y aplica algunos parámetros de configuración de la instancia principal como parámetros de configuración de la instancia secundaria. Para obtener más información, consulta Configuración de instancias.

Puedes crear una instancia secundaria en Memorystore para Valkey con la Google Cloud consola o Google Cloud CLI.

Console

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

   Memorystore para Valkey

2. Haz clic en una instancia principal. La instancia principal es la superior de la instancia secundaria que estás creando.

   Nota: No hagas clic en una instancia secundaria porque Memorystore for Valkey no admite réplicas en cascada. Además, no hagas clic en una instancia principal si ya tiene dos instancias secundarias, ya que una instancia principal no puede tener más de dos instancias secundarias.

   Si no aparece ninguna instancia principal, entonces crea una instancia. Después de crearla, puedes hacer clic en ella.

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

4. Haz clic en Agregar instancia secundaria.

5. En la ventana Agregar instancias secundarias, realiza los siguientes cambios:

   1. En el campo ID de instancia, ingresa el ID de la instancia secundaria que estás creando. El ID debe tener entre 1 y 63 caracteres y usar solo letras minúsculas, números o guiones. Debe comenzar con una letra minúscula, terminar con 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 deseas que se ubique la instancia secundaria.

   3. En la sección Disponibilidad zonal, selecciona una de las siguientes opciones:

      • Si deseas que todos los fragmentos y las 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 Varias zonas.

        Por ejemplo, si la región que seleccionas es us-central1, y seleccionas la opción Varias zonas, Memorystore para Valkey distribuye 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 una falla zonal, los nodos de la instancia conmutan por error a las réplicas.

      • Si deseas que todos los fragmentos y las 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 Zona única y, luego, selecciona la zona en el menú Zona.

        Si usas una sola zona, reduces los costos de red. Sin embargo, en caso de una falla zonal, no se produce la conmutación por error.

   4. En el menú Réplicas, selecciona la cantidad de réplicas (por fragmento) para 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 Agregar instancia secundaria.

gcloud

Nota: Si instalaste gcloud CLI, asegúrate de tener la versión más reciente ejecutando gcloud components update. Para administrar la replicación entre regiones de Memorystore para Valkey, necesitas al menos la versión 488.0.0 de gcloud CLI.

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

Realiza los siguientes reemplazos:

• INSTANCE_ID: Es el ID de la instancia secundaria que estás creando. El ID debe tener entre 1 y 63 caracteres y usar solo letras minúsculas, números o guiones. Debe comenzar con una letra minúscula, terminar con una letra minúscula o un número, y ser único en su región.
• PROJECT_ID: Es el ID del proyecto en el que deseas crear la instancia secundaria. Este es el mismo proyecto en el que se encuentra tu instancia principal.
• REGION_ID: Es el ID de la región en la que deseas que se ubique la instancia secundaria.
• NETWORK: Es la red que se usa para crear la instancia. Debe usar este formato: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. El ID de red debe coincidir con el ID de red que usa la política de conexión de servicio. De lo contrario, no podrás crear la instancia secundaria.
• PRIMARY_INSTANCE_PATH: Es 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

Visualiza una instancia secundaria

Puedes ver información de resumen sobre una instancia secundaria con la Google Cloud consola o Google Cloud CLI.

Console

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

   Memorystore para Valkey

2. Haz clic en la flecha del expansor junto a una instancia principal. Esta instancia es la superior de la instancia secundaria sobre la que deseas ver información.

3. Haz clic en la instancia secundaria. Aparecerá información de resumen sobre la instancia.

gcloud

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

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

Realiza los siguientes reemplazos:

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

Realiza un cambio

Un cambio te permite revertir las funciones de las instancias principal y secundaria mediante el ascenso de una instancia secundaria a una instancia principal para la recuperación ante desastres. Para obtener más información, consulta Acerca de la replicación entre regiones.

Puedes realizar un cambio con la Google Cloud consola o el Google Cloud CLI.

Nota: Antes de realizar un cambio, sigue las instrucciones que se indican en Prácticas recomendadas para cambiar instancias principales y secundarias. Con estas instrucciones, tu aplicación puede hacer un seguimiento de las escrituras que realiza y enviarlas a la instancia correspondiente.

Console

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

   Memorystore para Valkey

2. Haz clic en la flecha del expansor junto a una instancia principal. Esta instancia es la superior de la instancia secundaria a la que deseas cambiar.

3. Haz clic en la instancia secundaria.

4. Haz clic en Ascender a principal.

5. En el diálogo ¿Quieres ascender la instancia secundaria a principal? , ingresa el ID de la instancia secundaria y, luego, haz clic en Ascender.

Una vez que se complete el cambio, deberás volver a conectar tus aplicaciones a la nueva instancia principal.

gcloud

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

Realiza los siguientes reemplazos:

• INSTANCE_ID: Es el ID de la instancia secundaria que deseas ascender a una instancia principal mediante la realización del cambio.
• PROJECT_ID: Es el ID del proyecto que contiene la instancia secundaria instance.
• REGION_ID: Es el ID de la región en la que se encuentra la instancia secundaria.

• SECONDARY_INSTANCE_PATH: Es 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 que están contenidas en el proyecto my-project:

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

Deseas revertir las funciones de instance-1 y instance-2 para que instance-2 sea la nueva instancia principal y instance-1 sea una instancia secundaria.

Para ello, usa 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 que se complete el cambio, deberás volver a conectar tus aplicaciones a la nueva instancia principal.

Desconecta instancias secundarias

Si desconectas una o más instancias secundarias de su instancia principal, se convierten en instancias independientes completamente funcionales que permiten operaciones de lectura y escritura. Para obtener más información, consulta Cómo administrar la replicación entre regiones.

Puedes desconectar instancias secundarias con la Google Cloud consola o el Google Cloud CLI.

Desconecta una instancia secundaria

En esta sección, se explica cómo desconectar una instancia secundaria de su instancia principal.

Console

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

   Memorystore para Valkey

2. Haz clic en una instancia principal. Esta es la superior de la instancia secundaria que estás desconectando de la instancia principal.

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

4. Selecciona la casilla de verificación junto al ID de la instancia secundaria que estás desconectando de la instancia principal.

5. Haz clic en Desconectar de la principal.

6. En el diálogo ¿Quieres desconectar la instancia secundaria? , ingresa el ID de la instancia secundaria y, luego, haz clic en Desconectar.

gcloud

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

Reemplaza lo siguiente:

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

Desconecta varias instancias secundarias

En esta sección, se explica cómo desconectar varias instancias secundarias de su instancia principal. También puedes usar el procedimiento de esta sección para desconectar una instancia secundaria no disponible de su instancia principal.

Console

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

   Memorystore para Valkey

2. Haz clic en una instancia principal. Esta es la superior de las instancias secundarias que estás desconectando de la instancia principal.

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

4. Selecciona las casillas de verificación junto a los IDs de las instancias secundarias que estás desconectando de la instancia principal.

5. Haz clic en Desconectar de la principal.

6. En el diálogo ¿Quieres desconectar las instancias secundarias?, haz lo siguiente:

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

   2. Haz clic en Desconectar.

gcloud

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

Realiza los siguientes reemplazos:

• PRIMARY_INSTANCE_ID: Es el ID de la instancia principal.
• PROJECT_ID: Es el ID del proyecto que contiene las instancias secundarias.
• PRIMARY_INSTANCE_REGION_ID: Es el ID de la región en la que se encuentra la instancia principal.
• SECONDARY_INSTANCES: Son las instancias secundarias que deseas desconectar. Usa comas para separar los IDs de las instancias. 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

Nota: La línea de código --cross-instance-replication-config-role=none es opcional. Si deseas desconectar todas las instancias secundarias de la instancia principal, debes usar este código. Como resultado, la instancia principal se convierte en una instancia independiente.

También puedes desconectar instancias secundarias de la instancia principal si especificas una lista de instancias que no deseas desconectar. Memorystore para Valkey desconecta cualquier instancia 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 reside en la región asia-east1.

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

Para desconectar 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, debido a que el valor nulo [] se asigna al parámetro --cross-instance-replication-config-secondary-instances, Memorystore for Valkey desconecta todas las instancias secundarias de la instancia principal.

Actualiza la configuración de instancias

En esta sección, se proporcionan vínculos para actualizar la configuración de instancias. El proceso para actualizar la configuración de instancias es diferente, según si cambias la configuración en la instancia principal o secundaria. Para obtener más información sobre cómo actualizar la configuración, consulta Configuración de instancias.

Actualiza la configuración en la instancia principal

Debes cambiar la siguiente configuración en la instancia principal. Después de hacerlo, Memorystore para Valkey sincroniza los cambios con la instancia secundaria.

• Escala la capacidad de la instancia
• Configura la instancia
• Impide la eliminación de la instancia
• Administra la persistencia de la instancia

Actualiza la configuración en la instancia secundaria

Debes cambiar la siguiente configuración en la instancia secundaria:

• Configura si la instancia es de una sola zona o de varias zonas
• Escala la cantidad de réplicas de la instancia
• Configura períodos de mantenimiento para la instancia

Borra instancias que usan replicación entre regiones

En esta sección, se explica cómo borrar instancias principales y secundarias que usan la replicación entre regiones.

Borra una instancia principal

Para borrar una instancia principal, haz lo siguiente:

1. Desconecta o borra todas las instancias secundarias.
2. Para borrar la instancia principal, sigue las instrucciones que se indican en Borra instancias.

Para protegerte contra la eliminación accidental, no puedes borrar instancias principales y secundarias de forma simultánea.

Borra una instancia secundaria

Para borrar una instancia secundaria, sigue las instrucciones que se indican en Borra instancias. Para el ID de la instancia, usa el ID de la instancia secundaria.