Configurer une instance

Memorystore pour Valkey prend en charge un sous-ensemble des paramètres de configuration OSS de Valkey que vous pouvez modifier pour personnaliser le comportement de votre instance.

Les modifications de configuration ne nécessitent pas de redémarrer les nœuds et sont enregistrées en cas de redémarrage d'un nœud. Une fois l'instance créée, vous pouvez mettre à jour les paramètres de configuration modifiables.

Pour en savoir plus sur les paramètres de configuration modifiables, consultez Configurations d'instance compatibles.

Avant de commencer

Assurez-vous d'avoir installé la dernière version de Google Cloud CLI en exécutant gcloud components update.

Afficher les paramètres de configuration

Pour afficher les paramètres de configuration à l'aide de Google Cloud CLI, exécutez la commande gcloud memorystore instances describe en remplaçant variables par les valeurs appropriées.

Lors de l'exécution de la commande gcloud memorystore instances describe, les paramètres de configuration ne s'affichent que si vous avez modifié la valeur par défaut d'un paramètre de configuration.

gcloud memorystore instances describe instance-id --location=region-id

Exemple :

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

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, exécutez la commande gcloud memorystore instances create avec l'indicateur --engine-configs, en remplaçant variables par les valeurs appropriées.

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 \

Remplacez les éléments suivants :

  • instance-id est l'ID de l'instance Memorystore pour Valkey que vous créez.
  • region-id est la région dans laquelle vous souhaitez placer l'instance.
  • project-id est l'ID de votre projet.

  • node-type correspond au type de nœud choisi. Les valeurs acceptées sont les suivantes :

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

  • shard-count détermine le nombre de segments dans votre instance. Le nombre de segments détermine la capacité de mémoire totale pour stocker les données d'instance. Si vous sélectionnez le mode "Mode cluster désactivé", vous ne pouvez spécifier qu'un seul segment pour votre instance. Pour en savoir plus, consultez la section Spécifications des instances et des nœuds.

  • mode détermine si le mode cluster est activé ou désactivé pour l'instance. Si ce champ est omis, l'instance est définie par défaut sur "Mode cluster activé". Pour en savoir plus, consultez Activer et désactiver le mode cluster.

  • config-name est le paramètre de configuration à modifier.

  • config-value correspond au paramètre que vous configurez.

Exemple :

Exemple de mode Cluster activé

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

Exemple de mode cluster désactivé

  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

Mettre à jour un paramètre de configuration

Pour mettre à jour un paramètre de configuration pour une instance existante, exécutez la commande gcloud memorystore instances update avec l'indicateur --update-engine-configs, en remplaçant variables par les valeurs appropriées.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--update-engine-configs=config-name=config-value

Exemple :

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --update-engine-configs=maxmemory-policy=allkeys-lru

Réinitialiser un paramètre de configuration

Pour rétablir la valeur par défaut d'un paramètre de configuration, exécutez la commande gcloud memorystore instances update avec l'indicateur --remove-engine-configs, en remplaçant variables par les valeurs appropriées.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--remove-engine-configs=config-name

Exemple :

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --remove-engine-configs=maxmemory-policy

Effacer les paramètres de configuration

Pour réinitialiser tous les paramètres de configuration sur leurs valeurs par défaut, exécutez la commande gcloud memorystore instances update avec l'indicateur --clear-engine-configs, en remplaçant variables par les valeurs appropriées.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--clear-engine-configs

Exemple :

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --clear-engine-configs