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 los parámetros de configuración modificables después de crear una instancia.

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 beta memorystore instances describe y reemplaza variables por los valores adecuados.

No puedes ver los parámetros de configuración cuando ejecutas el comando gcloud beta memorystore instances describe, a menos que hayas cambiado un parámetro de 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 la instancia de Memorystore para Valkey que creas.
  • region-id es la región en la que deseas que se coloque 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 de tu instancia. El recuento de fragmentos determina la capacidad total de memoria para almacenar datos de instancias. Para obtener 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 debe 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 comando gcloud beta memorystore instances update con la marca --remove-engine-configs y reemplaza variables por los valores apropiados.

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