Cómo trabajar con la replicación entre regiones

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 redes de servicios, consulta Herramientas de redes.

En esta página, se describe cómo usar la replicación entre regiones creando y administrando instancias secundarias.

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 consola deGoogle Cloud o la CLI de Google Cloud.

Console

1. En la consola de Google Cloud , 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 estás creando.

   Nota: No hagas clic en una instancia secundaria, ya que Memorystore para 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, 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 en minúscula, 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 Multizona.

        Por ejemplo, si la región que seleccionas es us-central1 y eliges la opción Varias zonas, Memorystore para Valkey distribuirá las particiones y las réplicas de la instancia en las zonas us-central1-a, us-central1-b y
        de us-central1-c. En caso de una falla zonal, los nodos de la instancia se 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 Herramientas de 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 for Valkey, necesitas al menos la versión 488.0.0 de gcloud CLI

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

Realiza los siguientes reemplazos:

• INSTANCE_ID: Es el ID de la instancia secundaria que crearás. El ID debe tener entre 1 y 63 caracteres, y solo debe usar letras en minúscula, 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 usó 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 acceso 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 y cuando 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

Cómo ver una instancia secundaria

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

Console

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

   Memorystore for Valkey

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

3. Haz clic en la instancia secundaria. Aparecerá un resumen de la información 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 comando gcloud memorystore instances describe.

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

Realiza los siguientes reemplazos:

• INSTANCE_ID: ID de la instancia secundaria
• PROJECT_ID: 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 invertir los roles de las instancias principal y secundaria promoviendo una instancia secundaria a una instancia principal para fines de recuperación ante desastres. Para obtener más información, consulta Acerca de la replicación entre regiones.

Puedes realizar una conmutación por error con la consola de Google Cloud o la CLI de Google Cloud.

Nota: Antes de realizar un cambio, sigue las instrucciones que se indican en Prácticas recomendadas para cambiar las instancias principal y secundaria. 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 consola de Google Cloud , ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en la flecha desplegable junto a una instancia principal. Esta instancia es la principal de la instancia secundaria a la que deseas conmutar.

3. Haz clic en la instancia secundaria.

4. Haz clic en Promote to Primary.

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

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 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]

Realiza los siguientes reemplazos:

• INSTANCE_ID: Es el ID de la instancia secundaria que deseas promover a instancia principal realizando el cambio.
• 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.

• SECONDARY_INSTANCE_PATH: Es la ruta de acceso 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 se encuentran 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.

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, 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 se desconectan 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 consola de Google Cloud o laCLI de Google Cloud.

Desconecta una instancia secundaria

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

Console

1. En la consola de Google Cloud , 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 desconectarás 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 desconectarás de la instancia principal.

5. Haz clic en Desconectar del principal.

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

gcloud

Para desconectar 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

Reemplaza lo siguiente:

• INSTANCE_ID: Es el ID de la instancia secundaria que deseas desconectar.
• PROJECT_ID: 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 separar varias instancias secundarias de su instancia principal. También puedes usar el procedimiento de esta sección para separar una instancia secundaria no disponible de su instancia principal.

Console

1. En la consola de Google Cloud , 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 desconectarás 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 deseas separar de la instancia principal.

5. Haz clic en Desconectar del principal.

6. En el cuadro de 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 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

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

Nota: La línea de código --cross-instance-replication-config-role=none es opcional. Si deseas separar 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 especificando una lista de instancias que no quieres desconectar. Memorystore para Valkey desconecta 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 reside en la región asia-east1.

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

Actualiza la configuración de la instancia

En esta sección, se proporcionan vínculos para actualizar la configuración de la instancia. El proceso para actualizar la configuración de la instancia es diferente según si cambias la configuración en la instancia principal o en la 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 los siguientes parámetros de configuración en la instancia principal. Después de hacerlo, Memorystore para Valkey sincroniza los cambios en la instancia secundaria.

• Cómo escalar la capacidad de la instancia
• Configura la instancia
• Evita borrar la instancia
• Administra la persistencia de la instancia

Actualiza la configuración en la instancia secundaria

Debes cambiar los siguientes parámetros de configuración en la instancia secundaria:

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

Borra instancias que usan la 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 Cómo borrar instancias. Para el ID de instancia, usa el ID de la instancia secundaria.