Comment changer la configuration de Redis depuis la ligne de commande

Introduction

Redis est un système de stockage de données open-source de type clé-valeur en mémoire. Redis dispose de plusieurs commandes qui vous permettent d’apporter des modifications aux paramètres de configuration du serveur Redis en temps réel. Ce tutoriel abordera certaines de ces commandes et expliquera également comment rendre ces changements de configuration permanents.

Comment Utiliser Ce Guide

Ce guide est rédigé sous forme de mémo avec des exemples autonomes. Nous vous encourageons à vous rendre directement à la section qui est pertinente pour la tâche que vous essayez d’accomplir.

Les commandes présentées dans ce guide ont été testées sur un serveur Ubuntu 22.04 exécutant la version 6.0.16 de Redis. Pour mettre en place un environnement similaire, vous pouvez suivre l’Étape 1 de notre guide sur Comment Installer et Sécuriser Redis sur Ubuntu 22.04. Nous démontrerons le comportement de ces commandes en les exécutant avec redis-cli, l’interface en ligne de commande de Redis. Si vous utilisez une autre interface Redis — Redli, par exemple — la sortie exacte de certaines commandes peut différer.

Ou bien, vous pourriez provisionner une instance de base de données Redis gérée pour tester ces commandes, mais en fonction du niveau de contrôle autorisé par votre fournisseur de base de données, certaines commandes de ce guide pourraient ne pas fonctionner comme décrit. Pour provisionner une base de données gérée DigitalOcean, suivez notre documentation sur le produit Bases de données gérées. Ensuite, vous devez soit installer Redli ou configurer un tunnel TLS afin de vous connecter à la base de données gérée via TLS.

Sachez que les bases de données Redis gérées ne permettent généralement pas aux utilisateurs de modifier le fichier de configuration. Si vous travaillez avec une base de données gérée de DigitalOcean, les commandes décrites dans ce guide entraîneront des erreurs.

Modification de la configuration de Redis

Les commandes décrites dans cette section modifieront uniquement le comportement du serveur Redis pendant la durée de la session actuelle, ou jusqu’à ce que vous exécutiez config rewrite, ce qui les rendra permanentes. Vous pouvez également modifier directement le fichier de configuration de Redis en l’ouvrant et en l’éditant avec votre éditeur de texte préféré. Par exemple, vous pouvez utiliser nano à cette fin:

sudo nano /etc/redis/redis.conf

La commande config set vous permet de reconfigurer Redis en temps d’exécution sans avoir à redémarrer le service. Elle utilise la syntaxe suivante :

config set parameter value

Par exemple, si vous vouliez changer le nom du fichier de sauvegarde de la base de données que Redis produira après avoir exécuté une commande save, vous pourriez exécuter une commande comme celle-ci :

config set "dbfilename" "new_file.rdb"

Si le changement de configuration est valide, la commande renverra OK. Sinon, elle renverra une erreur.

Rendre les modifications de configuration permanentes

config set ne modifie pas définitivement le fichier de configuration de l’instance Redis ; il change uniquement le comportement de Redis pendant l’exécution. Pour modifier redis.conf après avoir exécuté une commande config-set et rendre permanente la configuration de la session actuelle, exécutez config rewrite :

config rewrite

Cette commande privilégie la préservation des commentaires et de la structure générale du fichier redis.conf original, avec seulement des changements minimes pour correspondre aux paramètres actuellement utilisés par le serveur.

Tout comme config set, si la réécriture est réussie, config rewrite renverra OK.

Vérification de la configuration de Redis

Pour lire les paramètres de configuration actuels d’un serveur Redis, exécutez la commande config get. config get prend un seul argument, qui peut être soit une correspondance exacte d’un paramètre utilisé dans redis.conf soit un modèle glob. Par exemple :

config get repl*

En fonction de la configuration de votre Redis, cette commande renverra quelque chose de similaire à ce qui suit :

Output
 1) "repl-ping-slave-period"
 2) "10"
 3) "repl-timeout"
 4) "60"
 5) "repl-backlog-size"
 6) "1048576"
 7) "repl-backlog-ttl"
 8) "3600"
 9) "repl-diskless-sync-delay"
10) "5"
11) "repl-disable-tcp-nodelay"
12) "no"
13) "repl-diskless-sync"
14) "no"

Vous pouvez également obtenir tous les paramètres de configuration pris en charge par config set en exécutant config get *.

Conclusion

Ce guide détaille les commandes redis-cli utilisées pour apporter des modifications au fichier de configuration d’un serveur Redis. S’il existe d’autres commandes, arguments ou procédures connexes que vous aimeriez apprendre dans ce guide, veuillez demander ou faire des suggestions dans les commentaires.

Pour plus d’informations sur les commandes Redis, consultez notre série de tutoriels sur Comment Gérer une Base de Données Redis.