Configurer une instance

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

Les modifications de configuration ne nécessitent pas de redémarrer l'instance et sont enregistrées en cas de redémarrage de l'instance. Vous pouvez mettre à jour les paramètres de configuration modifiables après avoir créé une instance.

Pour en savoir plus sur les paramètres de configuration modifiables, consultez la section 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 beta memorystore instances describe en remplaçant variables par les valeurs appropriées.

Lors de l'exécution de la commande gcloud beta 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 beta memorystore instances describe instance-id --location=region-id

Exemple :

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

gcloud beta memorystore instances create instance-id \
--location=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--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. Voici les valeurs acceptées:

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

    Pour en savoir plus sur les types de nœuds et les configurations d'instances, consultez la section Spécification des instances et des nœuds.

  • 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 de l'instance. Pour en savoir plus sur la spécification des instances, consultez la section Spécification des instances et des nœuds.

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

  • config-value correspond au paramètre que vous avez choisi pour le paramètre que vous configurez.

Exemple :

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

Modifier un paramètre de configuration

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

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

Exemple :

gcloud beta 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 beta memorystore instances update avec l'indicateur --remove-engine-configs en remplaçant variables par les valeurs appropriées.

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

Exemple :

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

Effacer les paramètres de configuration

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

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

Exemple :

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