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

No puedes ver los parámetros de configuración cuando ejecutas 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

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

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 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. Si el modo que seleccionas es el modo de clúster inhabilitado, puedes especificar solo 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 tendrá el modo de clúster habilitado de forma predeterminada. Para obtener más información, consulta Habilita y habilita el modo de clúster.

  • 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:

Ejemplo de modo de clúster habilitado

  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 modo de clúster inhabilitado

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

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

Restablece 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 restablecer todos los parámetros de configuración a sus valores predeterminados, ejecuta el comando gcloud memorystore instances update con la marca --clear-engine-configs y reemplaza variables por los valores apropiados.

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