Cómo cambiar la configuración de Redis desde la línea de comandos

Introducción

Redis es un almacén de datos de clave-valor en memoria de código abierto. Redis cuenta con varios comandos que te permiten realizar cambios en la configuración del servidor Redis sobre la marcha. Este tutorial abordará algunos de estos comandos y también explicará cómo hacer permanentes estos cambios de configuración.

Cómo Utilizar Esta Guía

Esta guía está escrita como una hoja de trucos con ejemplos independientes. Te animamos a ir a cualquier sección que sea relevante para la tarea que estás intentando completar.

Los comandos mostrados en esta guía fueron probados en un servidor Ubuntu 22.04 ejecutando Redis versión 6.0.16. Para configurar un entorno similar, puedes seguir Paso 1 de nuestra guía sobre Cómo Instalar y Asegurar Redis en Ubuntu 22.04. Demostraremos cómo se comportan estos comandos ejecutándolos con redis-cli, la interfaz de línea de comandos de Redis. Si estás utilizando una interfaz Redis diferente, como Redli, por ejemplo, la salida exacta de ciertos comandos puede variar.

Alternativamente, podrías aprovisionar una instancia de base de datos Redis gestionada para probar estos comandos, pero dependiendo del nivel de control permitido por tu proveedor de base de datos, algunos comandos en esta guía pueden no funcionar como se describe. Para aprovisionar una base de datos gestionada de DigitalOcean, sigue nuestra documentación del producto Managed Databases. Luego, debes instalar Redli o configurar un túnel TLS para poder conectarte a la base de datos gestionada a través de TLS.

Ten en cuenta que las bases de datos Redis gestionadas típicamente no permiten a los usuarios modificar el archivo de configuración. Si estás trabajando con una base de datos gestionada de DigitalOcean, los comandos descritos en esta guía resultarán en errores.

Cambiar la configuración de Redis

Los comandos descritos en esta sección solo modificarán el comportamiento del servidor Redis durante la duración de la sesión actual, o hasta que ejecutes config rewrite, lo que los hará permanentes. Puedes modificar el archivo de configuración de Redis directamente abriéndolo y editándolo con tu editor de texto preferido. Por ejemplo, puedes usar nano para hacerlo:

sudo nano /etc/redis/redis.conf

config set le permite reconfigurar Redis en tiempo de ejecución sin tener que reiniciar el servicio. Utiliza la siguiente sintaxis:

config set parameter value

Por ejemplo, si desea cambiar el nombre del archivo de volcado de la base de datos que Redis producirá después de ejecutar un comando save, podría ejecutar un comando como el siguiente:

config set "dbfilename" "new_file.rdb"

Si el cambio de configuración es válido, el comando devolverá OK. De lo contrario, devolverá un error.

Hacer Cambios de Configuración Permanentes

config set no altera permanentemente el archivo de configuración de la instancia de Redis; solo cambia el comportamiento de Redis en tiempo de ejecución. Para editar redis.conf después de ejecutar un comando config-set y hacer permanente la configuración de la sesión actual, ejecuta config rewrite:

config rewrite

Este comando prioriza la preservación de los comentarios y la estructura general del archivo original redis.conf, con cambios mínimos solo para que coincidan con la configuración actualmente utilizada por el servidor.

Al igual que config set, si la reescritura es exitosa, config rewrite devolverá OK.

Verificación de la Configuración de Redis

Para leer los parámetros de configuración actuales de un servidor Redis, ejecuta el comando config get. config get toma un único argumento, que puede ser una coincidencia exacta de un parámetro utilizado en redis.conf o un patrón glob. Por ejemplo:

config get repl*

Dependiendo de la configuración de tu Redis, este comando devolverá algo similar a lo siguiente:

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"

También puedes obtener todos los parámetros de configuración admitidos por config set ejecutando config get *.

Conclusión

Esta guía detalla los comandos redis-cli utilizados para realizar cambios en el archivo de configuración de un servidor Redis. Si hay otros comandos relacionados, argumentos o procedimientos que le gustaría aprender en esta guía, por favor pregunte o haga sugerencias en los comentarios.

Para obtener más información sobre los comandos de Redis, consulte nuestra serie de tutoriales sobre Cómo Gestionar una Base de Datos Redis.