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
En la consola de Google Cloud , ve a la página Memorystore para Valkey.
Haz clic en una instancia principal. La instancia principal es la instancia superior de la instancia secundaria que estás creando.
En el panel lateral, haz clic en la pestaña Instancias secundarias.
Haz clic en Agregar instancia secundaria.
En la ventana Agregar instancias secundarias, realiza los siguientes cambios:
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.
En el menú Región, selecciona la región en la que deseas que se ubique la instancia secundaria.
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 zonasus-central1-a
,us-central1-b
y
deus-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.
En el menú Réplicas, selecciona la cantidad de réplicas (por fragmento) para la instancia. Puedes tener cero, una o dos réplicas.
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.
Haz clic en Agregar instancia secundaria.
gcloud
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
En la consola de Google Cloud , ve a la página Memorystore para Valkey.
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.
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.
Console
En la consola de Google Cloud , ve a la página Memorystore para Valkey.
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.
Haz clic en la instancia secundaria.
Haz clic en Promote to Primary.
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ónus-east1
.instance-2
: Esta instancia secundaria reside en la regiónasia-east1
.instance-3
: Esta instancia secundaria reside en la regiónsouthamerica-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
En la consola de Google Cloud , ve a la página Memorystore para Valkey.
Haz clic en una instancia principal. Es el elemento superior de la instancia secundaria que desconectarás de la instancia principal.
En el panel lateral, haz clic en la pestaña Instancias secundarias.
Selecciona la casilla de verificación junto al ID de la instancia secundaria que desconectarás de la instancia principal.
Haz clic en Desconectar del principal.
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
En la consola de Google Cloud , ve a la página Memorystore para Valkey.
Haz clic en una instancia principal. Es el elemento superior de las instancias secundarias que desconectarás de la instancia principal.
En el panel lateral, haz clic en la pestaña Instancias secundarias.
Selecciona las casillas de verificación junto a los IDs de las instancias secundarias que deseas separar de la instancia principal.
Haz clic en Desconectar del principal.
En el cuadro de diálogo ¿Quieres desconectar las instancias secundarias?, haz lo siguiente:
Ingresa los IDs de las instancias secundarias. Usa comas para separar los IDs.
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
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ónus-east1
.instance-2
: Esta instancia reside en la regiónasia-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:
- Desconecta o borra todas las instancias secundarias.
- 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.