Memorystore pour Valkey prend en charge un sous-ensemble des paramètres de configuration OSS Valkey que vous pouvez modifier afin de 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
gcloud memorystore instances describe commande, en remplaçant variables par
les valeurs appropriées.
Vous ne pouvez pas afficher les paramètres de configuration lorsque vous exécutez la commande gcloud memorystore instances describe, sauf si vous modifiez 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
gcloud memorystore instances create commande avec l'--engine-configs indicateur, 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 est le type de nœud pour l' instance.
shard-count détermine le 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 "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, le mode cluster est activé par défaut pour l'instance. Pour en savoir plus, consultez la section Activer et désactiver le mode cluster.
config-name est le paramètre de configuration à modifier.
config-value est le paramètre que vous avez choisi et qui correspond au paramètre que vous configurez.
Exemple :
Exemple avec le 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 avec le 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 d'une instance existante, exécutez la
gcloud memorystore instances update commande avec l'--update-engine-configs indicateur,
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
gcloud memorystore instances update commande avec l'--remove-engine-configs indicateur,
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établir les valeurs par défaut de tous les paramètres de configuration, exécutez la
gcloud memorystore instances update commande avec l'--clear-engine-configs indicateur,
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