Cómo configurar una instancia

Memorystore para Valkey admite un subconjunto de los parámetros de configuración de Valkey de OSS que puedes modificar para personalizar el comportamiento de tu instancia.

Los cambios en la configuración no requieren un reinicio de los nodos y se guardan si se reinicia un nodo. Después de crear una instancia, puedes actualizar los parámetros de configuración modificables.

Para obtener más información sobre los parámetros de configuración modificables, consulta Configuraciones de instancias compatibles.

Antes de comenzar

Ejecuta gcloud components update para asegurarte de haber instalado la versión más reciente de Google Cloud CLI.

Cómo ver los parámetros de configuración

Para ver los parámetros de configuración con Google Cloud CLI, ejecuta el comando gcloud memorystore instances describe y reemplaza variables por los valores adecuados.

No verás parámetros de configuración cuando ejecutes el comando gcloud memorystore instances describe, a menos que cambies un parámetro de configuración de su valor predeterminado.

gcloud memorystore instances describe instance-id --location=region-id

Ejemplo:

gcloud memorystore instances describe my-instance --location=us-central1

Cómo establecer un parámetro de configuración durante la creación de instancias

Para establecer un parámetro de configuración mientras creas una instancia, ejecuta el comando gcloud memorystore instances create con la marca --engine-configs y reemplaza variables por los valores adecuados.

gcloud memorystore instances create instance-id \
--location=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--mode=MODE
--engine-configs=config-name=config-value \

Reemplaza lo siguiente:

  • instance-id es el ID de la instancia de Memorystore para Valkey que creas.
  • region-id es la región en la que deseas colocar la instancia.
  • project-id es el ID del proyecto.

  • node-type es el tipo de nodo que elegiste. Los valores aceptados son los siguientes:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    Para obtener más detalles sobre los tipos de nodos y las configuraciones de instancias, consulta Especificación de instancias y nodos.

  • shard-count determina la cantidad de fragmentos de tu instancia. El recuento de fragmentos determina la capacidad total de memoria para almacenar datos de instancias. Si seleccionas el modo Cluster Mode Disabled, solo podrás especificar un fragmento para tu instancia. Para obtener más información, consulta Especificación de instancias y nodos.

  • mode determina si la instancia tiene habilitado o inhabilitado el modo de clúster. Si se omite este campo, la instancia se establece de forma predeterminada en el modo de clúster habilitado. Para obtener más información, consulta Cómo habilitar y cómo inhabilitar el modo de clúster.

  • config-name es el parámetro de configuración que se modificará.

  • config-value es el parámetro de configuración que elegiste y que corresponde al parámetro que estás configurando.

Por ejemplo:

Ejemplo de Cluster Mode Enabled

  gcloud memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=3 --engine-configs=maxmemory-policy=allkeys-lru

Ejemplo de Cluster Mode Disabled

  gcloud memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=1 --mode=cluster-disabled --engine-configs=maxmemory-policy=allkeys-lru

Actualiza un parámetro de configuración

Para actualizar un parámetro de configuración de una instancia existente, ejecuta el comando gcloud memorystore instances update con la marca --update-engine-configs y reemplaza variables por los valores adecuados.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--update-engine-configs=config-name=config-value

Ejemplo:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --update-engine-configs=maxmemory-policy=allkeys-lru

Cómo restablecer un parámetro de configuración

Para restablecer un parámetro de configuración a su valor predeterminado, ejecuta el comando gcloud memorystore instances update con la marca --remove-engine-configs y reemplaza variables por los valores apropiados.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--remove-engine-configs=config-name

Ejemplo:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --remove-engine-configs=maxmemory-policy

Borra los parámetros de configuración

Para borrar todos los parámetros de configuración y restablecer sus valores predeterminados, ejecuta el comando gcloud memorystore instances update con la marca --clear-engine-configs y reemplaza variables por los valores adecuados.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--clear-engine-configs

Ejemplo:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --clear-engine-configs