Configurer une instance

Memorystore pour Valkey est compatible avec un sous-ensemble de la configuration d'OSS Valkey que vous pouvez modifier pour personnaliser le comportement de votre instance.

Les modifications de configuration ne nécessitent pas et sont enregistrés 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 la CLI Google Cloud 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 est le type de nœud que vous avez choisi. Les valeurs acceptées sont les suivantes :

    • 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é totale de la mémoire pour le stockage des données d'instance. Pour en savoir plus sur la spécification des instances, consultez Spécification des instances et des nœuds.

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

  • config-value est le paramètre choisi en fonction du 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 pour 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établir les valeurs par défaut de tous les paramètres de configuration, exécutez la Commande gcloud beta memorystore instances update avec l'option --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