Configurer un cluster

Memorystore pour Redis Cluster est compatible avec un sous-ensemble de paramètres de configuration Redis que vous pouvez modifier pour personnaliser le comportement de votre cluster.

Les modifications de configuration ne nécessitent pas de redémarrer le cluster et n'interrompent pas le service. Memorystore pour Redis Cluster enregistre immédiatement vos modifications. Si le cluster redémarre, il conserve vos modifications de configuration. Après avoir créé un cluster, vous pouvez mettre à jour les paramètres de configuration modifiables. Pour en savoir plus, consultez Configurations de cluster compatibles.

Avant de commencer

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

Afficher les paramètres de configuration

Pour afficher les paramètres de configuration, exécutez la commande gcloud redis clusters describe.

gcloud redis clusters describe CLUSTER_ID --region=REGION_ID

Effectuez les remplacements suivants :

  • CLUSTER_ID : ID du cluster
  • REGION_ID : région où se trouve le cluster

Exemple :

gcloud redis clusters describe my-cluster --region=us-central1

Si vous ne modifiez pas les valeurs par défaut des paramètres de configuration, ceux-ci n'apparaissent pas dans le résultat.

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

Pour définir un paramètre de configuration lorsque vous créez un cluster, utilisez la commande
gcloud redis clusters create avec l'option --redis-config.

gcloud redis clusters create CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--network=NETWORK \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--redis-config=CONFIG_NAME=CONFIG_VALUE

Effectuez les remplacements suivants :

  • CLUSTER_ID : ID du cluster que vous créez.
  • REGION_ID : région dans laquelle vous souhaitez placer le cluster.
  • PROJECT_ID : ID de votre projet.
  • NETWORK : nom ou chemin d'accès complet du réseau cloud privé virtuel (VPC) auquel le cluster se connecte.
  • NODE_TYPE : type de nœud du cluster.

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

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

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

Exemple :

gcloud redis clusters create my-cluster --region=us-east1 --project=my-project --network=projects/my-project/global/networks/default --node-type=redis-highmem-medium --shard-count=3 --redis-config=maxmemory-policy=allkeys-lru

Mettre à jour un paramètre de configuration

Pour mettre à jour un paramètre de configuration d'un cluster existant, utilisez la commande
gcloud redis clusters update avec l'option --update-redis-config.

gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--update-redis-config=CONFIG_NAME=CONFIG_VALUE

Effectuez les remplacements suivants :

  • CLUSTER_ID : ID du cluster
  • REGION_ID : région où se trouve le cluster
  • PROJECT_ID : ID du projet.
  • CONFIG_NAME : nom du paramètre de configuration que vous souhaitez mettre à jour.
  • CONFIG_VALUE : nouvelle valeur du paramètre.

Exemple :

gcloud redis clusters update my-cluster --region=us-east1 --project=my-project --update-redis-config=maxmemory-policy=allkeys-lru

Pour en savoir plus sur les paramètres de configuration que vous pouvez modifier, 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, exécutez la commande
gcloud redis clusters update avec l'option --remove-redis-config.

gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--remove-redis-config=CONFIG_NAME

Effectuez les remplacements suivants :

  • CLUSTER_ID : ID du cluster
  • REGION_ID : région où se trouve le cluster
  • PROJECT_ID : ID du projet.
  • CONFIG_NAME : nom du paramètre de configuration que vous souhaitez réinitialiser à sa valeur par défaut.

Exemple :

gcloud redis clusters update my-cluster --region=us-east1 --project=my-project --remove-redis-config=maxmemory-policy