Cómo configurar una instancia

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

Los cambios de configuración no requieren que reinicies la instancia y no interrumpen el servicio. Memorystore para Valkey guarda los cambios de inmediato. Si se reinicia la instancia, esta conserva los cambios de configuración. Después de crear una instancia, puedes actualizar los parámetros de configuración modificables. Para obtener más información, consulta Configuraciones de instancias compatibles.

Antes de comenzar

Asegúrate de instalar la versión más reciente de Google Cloud CLI. Para actualizar una instalación existente, usa el gcloud components update comando.

Visualiza los parámetros de configuración

Para ver los parámetros de configuración, usa el gcloud memorystore instances describe comando.

gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID

Realiza los siguientes reemplazos:

  • INSTANCE_ID: Es el ID de la instancia.
  • REGION_ID: Es la región en la que se encuentra la instancia.

Por ejemplo:

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

Si no cambias ningún parámetro de configuración de sus valores predeterminados, los parámetros no aparecerán en el resultado.

Establece un parámetro de configuración cuando creas una instancia

Para establecer un parámetro de configuración cuando creas una instancia, usa el
gcloud memorystore instances create comando con la --engine-configs marca.

gcloud memorystore instances create INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--node-type=NODE_TYPE \
--mode=MODE \
--shard-count=SHARD_COUNT \
--engine-configs=CONFIG_NAME=CONFIG_VALUE

Realiza los siguientes reemplazos:

  • INSTANCE_ID: Es el ID de la instancia que crearás.
  • REGION_ID: Es la región en la que deseas que se ubique la instancia.
  • PROJECT_ID: Es el ID del proyecto.

  • NODE_TYPE: Es el tipo de nodo para la instancia.

  • MODE: Indica si crearás una instancia con el modo de clúster habilitado o inhabilitado. Si omites este campo, de forma predeterminada, Memorystore for Valkey crea una instancia con el modo de clúster habilitado. Para obtener más información, consulta Habilita e inhabilita el modo de clúster.

  • SHARD_COUNT: Es la cantidad de fragmentos de tu instancia. La cantidad 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.

  • CONFIG_NAME: Es el nombre del parámetro de configuración que deseas establecer.

  • CONFIG_VALUE: Es el valor del parámetro que estás configurando.

Por ejemplo:

Ejemplo del modo de clúster habilitado

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

Ejemplo del modo de clúster inhabilitado

  gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --mode=cluster-disabled --shard-count=1 --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, usa el
gcloud memorystore instances update comando con la --update-engine-configs marca.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--update-engine-configs=CONFIG_NAME=CONFIG_VALUE

Realiza los siguientes reemplazos:

  • INSTANCE_ID: Es el ID de la instancia.
  • REGION_ID: Es la región en la que se encuentra la instancia.
  • PROJECT_ID: Es el ID del proyecto.
  • CONFIG_NAME: Es el nombre del parámetro de configuración que deseas actualizar.
  • CONFIG_VALUE: Es el valor nuevo del parámetro.

Por ejemplo:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --update-engine-configs=maxmemory-policy=allkeys-lru

Para obtener más información sobre los parámetros de configuración que puedes actualizar, consulta Parámetros de configuración modificables.

Restablece un parámetro de configuración

Para restablecer un parámetro de configuración a su valor predeterminado, usa el
gcloud memorystore instances update comando con la --remove-engine-configs marca.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--remove-engine-configs=CONFIG_NAME

Realiza los siguientes reemplazos:

  • INSTANCE_ID: Es el ID de la instancia.
  • REGION_ID: Es la región en la que se encuentra la instancia.
  • PROJECT_ID: Es el ID del proyecto.
  • CONFIG_NAME: Es el nombre del parámetro de configuración que deseas restablecer a su valor predeterminado.

Por ejemplo:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --remove-engine-configs=maxmemory-policy

Restablece todos los parámetros de configuración

Para restablecer todos los parámetros de configuración a sus valores predeterminados, usa el
gcloud memorystore instances update comando con la --clear-engine-configs marca.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--clear-engine-configs

Realiza los siguientes reemplazos:

  • INSTANCE_ID: Es el ID de la instancia.
  • REGION_ID: Es la región en la que se encuentra la instancia.
  • PROJECT_ID: Es el ID del proyecto.

Por ejemplo:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --clear-engine-configs