Como Alterar a Configuração do Redis a partir da Linha de Comando

Introdução

Redis é um armazenamento de dados chave-valor em memória, de código aberto. O Redis possui vários comandos que permitem fazer alterações nas configurações do servidor Redis em tempo real. Este tutorial discutirá alguns desses comandos e também explicará como tornar essas alterações de configuração permanentes.

Como Usar Este Guia

Este guia é elaborado como uma folha de dicas com exemplos autossuficientes. Encorajamos você a pular para qualquer seção que seja relevante para a tarefa que está tentando completar.

Os comandos mostrados neste guia foram testados em um servidor Ubuntu 22.04 executando a versão do Redis 6.0.16. Para configurar um ambiente semelhante, você pode seguir o Passo 1 do nosso guia sobre Como Instalar e Proteger o Redis no Ubuntu 22.04. Demonstraremos como esses comandos se comportam executando-os com redis-cli, a interface de linha de comando do Redis. Se você estiver usando uma interface Redis diferente — como Redli, por exemplo — a saída exata de certos comandos pode diferir.

Alternativamente, você poderia provisionar uma instância de banco de dados Redis gerenciada para testar esses comandos, mas dependendo do nível de controle permitido pelo seu provedor de banco de dados, alguns comandos neste guia podem não funcionar conforme descrito. Para provisionar um Banco de Dados Gerenciado da DigitalOcean, siga nossa documentação do produto de Bancos de Dados Gerenciados. Em seguida, você deve instalar o Redli ou configurar um túnel TLS para se conectar ao Banco de Dados Gerenciado por TLS.

Esteja ciente de que os bancos de dados Redis gerenciados geralmente não permitem que os usuários alterem o arquivo de configuração. Se estiver trabalhando com um Banco de Dados Gerenciado da DigitalOcean, os comandos descritos neste guia resultarão em erros.

Alterando a Configuração do Redis

Os comandos descritos nesta seção apenas alterarão o comportamento do servidor Redis durante a sessão atual ou até que você execute config rewrite, o que os tornará permanentes. Você pode alterar o arquivo de configuração do Redis diretamente, abrindo-o e editando-o com o seu editor de texto preferido. Por exemplo, você pode usar o nano para fazer isso:

sudo nano /etc/redis/redis.conf

config set permite reconfigurar o Redis em tempo de execução sem precisar reiniciar o serviço. Ele utiliza a seguinte sintaxe:

config set parameter value

Por exemplo, se você quiser alterar o nome do arquivo de despejo do banco de dados que o Redis produzirá após executar um comando save, você pode executar um comando como o seguinte:

config set "dbfilename" "new_file.rdb"

Se a alteração na configuração for válida, o comando retornará OK. Caso contrário, retornará um erro.

Tornando Mudanças na Configuração Permanentes

O comando config set não altera permanentemente o arquivo de configuração da instância do Redis; ele apenas muda o comportamento do Redis em tempo de execução. Para editar o redis.conf após executar um comando config-set e tornar a configuração da sessão atual permanente, execute config rewrite:

config rewrite

Este comando prioriza a preservação dos comentários e da estrutura geral do arquivo redis.conf original, com apenas alterações mínimas para corresponder às configurações atualmente usadas pelo servidor.

Assim como config set, se a reescrita for bem-sucedida, config rewrite retornará OK.

Verificando a Configuração do Redis

Para ler os parâmetros de configuração atuais de um servidor Redis, execute o comando config get. config get recebe um único argumento, que pode ser ou uma correspondência exata de um parâmetro usado em redis.conf ou um padrão glob. Por exemplo:

config get repl*

Dependendo da configuração do seu Redis, este comando retornará algo semelhante ao seguinte:

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"

Você também pode retornar todos os parâmetros de configuração suportados por config set executando config get *.

Conclusão

Este guia detalha os comandos redis-cli usados para fazer alterações no arquivo de configuração de um servidor Redis. Se houver outros comandos, argumentos ou procedimentos relacionados que você gostaria de aprender neste guia, por favor, pergunte ou faça sugestões nos comentários.

Para obter mais informações sobre os comandos do Redis, confira nossa série de tutoriais sobre Como Gerenciar um Banco de Dados Redis.