Configurar una instancia

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

Los cambios de configuración no requieren que se reinicien los nodos y se guardan si se reinicia un nodo. Después de crear una instancia, puede 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 admitidas.

Antes de empezar

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

Ver parámetros de configuración

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

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

Definir un parámetro de configuración durante la creación de la instancia

Para definir un parámetro de configuración al crear una instancia, ejecuta el comando gcloud memorystore instances create con la marca --engine-configs y sustituye 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 \

Haz los cambios siguientes:

  • instance-id es el ID de la instancia de Memorystore for Valkey que estás creando.
  • region-id es la región en la que quieres colocar la instancia.
  • project-id es el ID del proyecto.

  • node-type es el tipo de nodo que has elegido. Los valores aceptados son:

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

  • shard-count determina el número de particiones de tu instancia. El número de particiones determina la capacidad total de memoria para almacenar datos de instancias. Si seleccionas el modo de clúster inhabilitado, solo puedes 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 Clúster. Si se omite este campo, la instancia se configurará de forma predeterminada con el modo de clúster habilitado. Para obtener más información, consulta el artículo Habilitar e inhabilitar el modo Clúster.

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

  • config-value es el ajuste que ha elegido para el parámetro que está 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

Actualizar un parámetro de configuración

Para actualizar un parámetro de configuración de una instancia, ejecuta el comando gcloud memorystore instances update con la marca --update-engine-configs y sustituye 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

Restablecer un parámetro de configuración

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

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

Borrar parámetros de configuración

Para borrar todos los parámetros de configuración y restaurar sus valores predeterminados, ejecuta el comando gcloud memorystore instances update con la marca --clear-engine-configs. Sustituye 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