Configurer une instance

Memorystore pour Valkey est compatible avec un sous-ensemble des paramètres de configuration Valkey que vous pouvez modifier pour personnaliser le comportement de votre instance.

Les modifications de configuration ne nécessitent pas le redémarrage de l'instance et n'interrompent pas le service. Memorystore pour Valkey enregistre immédiatement vos modifications. Si l'instance redémarre, elle conserve vos modifications de configuration. Une fois que vous avez créé une instance, vous pouvez mettre à jour les paramètres de configuration modifiables. Pour en savoir plus, consultez Configurations d'instance compatibles.

Avant de commencer

Assurez-vous d'installer la dernière version de Google Cloud CLI. Pour mettre à jour une installation existante, utilisez la gcloud components update commande.

Afficher les paramètres de configuration

Pour afficher les paramètres de configuration, utilisez la gcloud memorystore instances describe commande.

gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance
  • REGION_ID : région où se trouve l'instance

Exemple :

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

Si vous ne modifiez pas les valeurs par défaut des paramètres de configuration, ces paramètres n'apparaissent pas dans la sortie.

Définir un paramètre de configuration lors de la création d'une instance

Pour définir un paramètre de configuration lors de la création d'une instance, utilisez la
gcloud memorystore instances create commande avec l'option --engine-configs

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

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance que vous créez.
  • REGION_ID : région dans laquelle vous souhaitez placer l'instance.
  • PROJECT_ID : ID du projet.

  • NODE_TYPE : le type de nœud de l'instance.

  • MODE : indique si vous créez une instance en mode Cluster activé ou en mode Cluster désactivé. Si vous omettez ce champ, Memorystore pour Valkey crée par défaut une instance en mode Cluster activé. Pour en savoir plus, consultez Activer et désactiver le mode Cluster.

  • SHARD_COUNT : nombre de segments dans votre instance. Le nombre de segments détermine la capacité mémoire totale pour stocker les données de l'instance.

    Si le mode que vous sélectionnez est le mode Cluster désactivé, vous ne pouvez spécifier qu'un seul segment pour votre instance. Pour en savoir plus, consultez Spécifications des instances et des nœuds.

  • CONFIG_NAME : nom du paramètre de configuration que vous souhaitez définir.

  • CONFIG_VALUE : valeur du paramètre que vous définissez.

Exemple :

Exemple en mode Cluster activé

  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

Exemple en mode Cluster désactivé

  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

Mettre à jour un paramètre de configuration

Pour mettre à jour un paramètre de configuration d'une instance existante, utilisez la
gcloud memorystore instances update commande avec l'--update-engine-configs option.

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

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance
  • REGION_ID : région où se trouve l'instance
  • PROJECT_ID : ID de votre projet
  • CONFIG_NAME : nom du paramètre de configuration que vous souhaitez mettre à jour
  • CONFIG_VALUE : nouvelle valeur du paramètre

Exemple :

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

Pour en savoir plus sur les paramètres de configuration que vous pouvez mettre à jour, consultez Paramètres de configuration modifiables.

Réinitialiser un paramètre de configuration

Pour rétablir la valeur par défaut d'un paramètre de configuration, utilisez la
gcloud memorystore instances update commande avec l'option --remove-engine-configs.

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

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance
  • REGION_ID : région où se trouve l'instance
  • PROJECT_ID : ID de votre projet
  • CONFIG_NAME : nom du paramètre de configuration dont vous souhaitez rétablir la valeur par défaut

Exemple :

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

Réinitialiser tous les paramètres de configuration

Pour rétablir les valeurs par défaut de tous les paramètres de configuration, utilisez la
gcloud memorystore instances update commande avec l'--clear-engine-configs option.

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

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance
  • REGION_ID : région où se trouve l'instance
  • PROJECT_ID : ID de votre projet

Exemple :

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