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 la instancia y se guardan si la instancia se reinicia. Puedes actualizar el campo parámetros de configuración después de crear una instancia.

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

Antes de comenzar

Asegúrate de haber instalado la versión más reciente de Google Cloud CLI ejecutando gcloud components update.

Ver parámetros de configuración

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

No puede ver los parámetros de configuración cuando ejecuta Comando gcloud beta memorystore instances describe, a menos que hayas cambiado una configuración de su valor predeterminado.

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

Ejemplo:

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

Establece 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 beta memorystore instances create con la marca --engine-configs y reemplaza variables por los valores adecuados.

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

Reemplaza lo siguiente:

  • instance-id es el ID de Memorystore para la instancia de Valkey que creas.
  • region-id es la región en la que quieres que se ubique 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 la configuración de instancias, consulta Especificación de instancias y nodos.

  • shard-count determina la cantidad de fragmentos en tu instancia. El recuento de fragmentos determina la capacidad total de memoria para almacenar datos de la instancia. Para ver más detalles sobre la especificación de instancias, consulta Especificación de instancias y nodos.

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

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

Por ejemplo:

gcloud beta memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=3 --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 beta memorystore instances update con la marca --update-engine-configs y reemplaza variables por los valores apropiados.

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

Ejemplo:

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

Restablece un parámetro de configuración

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

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

Ejemplo:

gcloud beta 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 a sus valores predeterminados, ejecuta el comando gcloud beta memorystore instances update con la marca --clear-engine-configs y reemplaza variables por los valores adecuados.

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

Ejemplo:

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