Deep Dive: Redis – object cache, file locking e por que uma senha atrás do firewall

O que o Redis faz pelo WordPress e pelo Nextcloud, por que uma instância roda sem senha e a outra com, o que as medições dizem sobre hit rates e memória – e três coisas que uma revisão encontrou que o setup ainda não fazia.

Ilustração da série Deep Dive

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Deep Dive da série em torno do Tour pelo Ansible. O tour explica as roles, os deep dives a tecnologia por baixo: como ela funciona, por que é usada desse jeito aqui e o que deu errado pelo caminho.

O Redis é o menor serviço deste setup – alguns megabytes de memória, uma fração de um núcleo de CPU – e as duas aplicações dependem dele. O blog o usa como object cache (parte 3), o Nextcloud para file locking e como cache compartilhado entre processos (parte 4). Este post explica o que o Redis faz ali, por que as duas instâncias são protegidas de forma diferente, o que os números dizem e o que uma revisão feita para este artigo revelou.

Índice

🧭 Como o Redis funciona

Uma thread, tudo na memória

O Redis mantém todos os dados na RAM e executa os comandos um após o outro em um único event loop. Isso parece um gargalo e é o oposto: não há locks entre threads, todo comando é atômico e uma leitura simples leva microssegundos. Rede e chamadas de sistema custam mais do que o próprio comando.

Chaves, tipos, expiração

Cada entrada é uma chave com um valor – uma string, um hash, uma lista, um set. Cada chave pode ter um tempo de vida; o Redis a apaga quando ela expira. As duas aplicações definem uma expiração em quase todas as chaves, então o conjunto de dados se limpa sozinho.

Quando a memória acaba

maxmemory define um limite; maxmemory-policy decide o que acontece no limite. allkeys-lru remove a chave usada há mais tempo – certo para um cache puro, em que toda entrada pode ser reconstruída. noeviction recusa novas gravações em vez disso – certo para dados que não podem sumir em silêncio, como um lock.

Persistência – ou nenhuma

O Redis pode gravar snapshots (RDB, controlados por save) e um log append-only de todas as gravações (AOF). Ambos servem para dados que precisam sobreviver a um restart. Um cache e locks de vida curta não precisam de nenhum dos dois: depois de um restart o cache se enche de novo e as aplicações pegam novos locks.

Autenticação e protected mode

requirepass (ou, desde o Redis 6, usuários ACL) faz todo cliente se autenticar primeiro. O protected mode só recusa conexões de fora se o Redis escuta em todas as interfaces sem senha – assim que um endereço de bind e nenhuma senha são configurados, ele não ajuda mais.

🛡️ Por que ele está aqui

  • Object cache do WordPress. O WordPress pergunta ao banco de dados pelas mesmas opções, menus e metadados de posts a cada requisição. Com o plugin Redis Object Cache, as respostas vêm do Redis.
  • File locking do Nextcloud. Quando dois clientes gravam o mesmo arquivo ao mesmo tempo, o Nextcloud precisa de um lock que todo processo PHP, em todo pod, veja na hora. Sem isso, clientes de sincronização sobrescrevem um ao outro. O Nextcloud recomenda explicitamente o Redis para isso.
  • Cache distribuído do Nextcloud. Dados compartilhados entre processos – configuração de apps, estado próximo da sessão – também ficam ali; o cache por processo é o APCu.

🔧 O que este repositório faz

BlogServidores Nextcloud
OndePod no K3s (redis:7.4-alpine)No host, pacote AlmaLinux (Redis 7.2, module stream redis:7; 6.2 até 26 out 2026)
Roleblog_k3s_deploynext_packages + next_redis
Usado paraObject cacheFile locking + cache distribuído
Limite de memória80 MB, allkeys-lrunenhum, noeviction
Persistêncianenhuma (--save "", AOF desligado)Snapshots RDB (padrão do pacote)
Senhanenhumarequirepass do vault
Acessado porClusterIP Service, NetworkPolicy: só pods do WordPressIP do nó e 127.0.0.1, nftables: só a rede de pods
SELinuxcontainer_t com categorias MCS própriasredis_t

O blog: um cache descartável em um pod trancado

Tudo neste Redis pode ser jogado fora, e ele está configurado assim: sem gravações em disco, um teto de memória com remoção LRU, sistema de arquivos raiz somente leitura, nenhuma capability. Ele não tem senha porque nada fora da rede de pods consegue alcançá-lo e, dentro dela, só os pods do WordPress podem – uma NetworkPolicy nega todos os outros pods, incluindo o banco de dados e o ingress controller.

Nextcloud: por que a senha

Nos servidores Nextcloud o Redis roda no host, e os pods o alcançam por um Service do Kubernetes que aponta para o IP do nó. Isso significa que o Redis escuta no endereço público do servidor. Entre a internet e o Redis havia, no começo, exatamente uma regra do nftables. A role next_redis adiciona requirepass como segunda camada, porque uma regra falhando em silêncio não é hipotético aqui: o fail2ban uma vez ficou morto no blog por dois dias sem ninguém perceber. A senha chega ao Nextcloud por um Secret do Kubernetes montado como redis.config.php – não pelo ConfigMap que guarda o resto da configuração, porque ConfigMaps não são feitos para segredos.

O flush_handlers não é enfeite: as roles depois dele rodam comandos occ no pod, que se conectam ao Redis pelo IP do nó. Sem o restart imediato, o Redis ainda estaria escutando só em 127.0.0.1 naquele momento.

A lição: um serviço que os pods alcançam pelo IP do nó escuta em um endereço que mais do que os pods conseguem alcançar. Ele precisa de uma senha, mesmo atrás de um firewall.

noeviction de propósito

O Redis do host não tem limite de memória e usa a política padrão noeviction. Para locks isso está correto: um lock removido seria um lock que parou de proteger um arquivo em silêncio. O conjunto de dados é minúsculo de qualquer forma (veja abaixo), e o servidor tem memória de sobra.

A lição: para locks, eviction é um bug; para um cache, é a escolha certa. A política decorre do que está armazenado.

Desde 26 de outubro de 2026 o Redis do host vem do module stream do AppStream redis:7 (7.2) em vez do padrão 6.2 do EL9. A Red Hat teria continuado fornecendo correções de segurança para a 6.2; a troca coloca os servidores Nextcloud na mesma versão major do blog. Como o Redis não grava nada em disco aqui, o restart custou só um momento de cache e locks. Domínio SELinux (redis_t) e configuração continuaram os mesmos.

📊 Medido

BlogNextcloud ANextcloud B
Versão7.4.116.2.24 → 7.2.166.2.24 → 7.2.16
Memória usada14,8 MB1,7 MB1,3 MB
Chaves19.0795683
Hit rate desde o restart87,6 %85,9 %64,4 %
Chaves removidas000
Entradas no slow log130

As duas cargas de trabalho não se parecem em nada. O cache do blog guarda dezenas de milhares de objetos pequenos; o Nextcloud guarda algumas dezenas de locks e entradas de cache que são criados e expiram o tempo todo – mais de 11.000 chaves expiraram no servidor maior em um dia. O hit rate menor no servidor Nextcloud menor é da natureza do locking, não um problema: “este arquivo está travado?” é um miss sempre que a resposta é “não”. A taxa de fragmentação que o Redis informa para as instâncias do host (7 a 9) parece alarmante e não significa nada nesse tamanho – alguns megabytes de overhead do processo divididos por um ou dois megabytes de dados.

O blog usa o Predis, um cliente escrito em PHP, porque a imagem oficial do WordPress não traz a extensão phpredis. A extensão em C seria mais rápida; com um hit rate de 88 % e page cache na frente, a diferença não aparece nos tempos de resposta.

🔍 O que a revisão para este artigo encontrou

Juntar os fatos para este post revelou quatro coisas que o setup não fazia – nenhuma perigosa, todas dignas de saber. As quatro foram corrigidas em 20 de outubro de 2026.

  • Nenhum sandbox do systemd para o Redis do host. O MariaDB nos mesmos servidores ganhou um drop-in de hardening (sem capabilities, sistema de arquivos somente leitura, filtro de system calls); o Redis roda só com a unit do pacote. O SELinux ainda o confina em redis_t, então ele não está desprotegido – mas falta a segunda camada que o MariaDB tem. O rascunho deste mesmo artigo afirmava que ela existia. Corrigido: o mesmo tipo de drop-in do MariaDB – com uma armadilha no caminho: as opções de sandbox implicam NoNewPrivileges, e com isso o SELinux recusou a transição para redis_t; o Redis não subiu por dois minutos. Um pequeno módulo local (init_nnp_daemon_domain(redis_t)) permite exatamente essa transição.
  • Snapshots de que ninguém precisa. O Redis do host mantém o padrão do pacote save 3600 1 300 100 60 10000 e grava dump.rdb regularmente – para locks com tempo de vida e um cache que se reconstrói sozinho. Restaurados após um reboot, locks velhos teriam até que expirar primeiro. Corrigido: save "", como no blog, e o dump.rdb antigo removido.
  • Uma senha trocada não teria chegado ao Nextcloud. As configurações de conexão vêm de um Secret, montado com subPath – e uma montagem subPath nunca é atualizada em um pod em execução. O pod é reiniciado quando sua configuração muda, via uma annotation de checksum, mas o Secret não fazia parte desse checksum. Trocar a senha teria reiniciado o Redis com a nova enquanto o Nextcloud mantinha a antiga até o próximo restart acidental: sem locks, páginas de erro. Corrigido: o Secret agora faz parte do checksum. A última peça manual – o daemon de push notify_push lê a senha do config.php, onde o instalador a gravou uma vez – também foi automatizada: o playbook copia a senha do Secret para o config.php sempre que elas diferem.
  • O Monit não o vigia. O Monit reinicia e reporta K3s, sshd e os serviços de monitoramento, mas não o Redis nem o MariaDB do host dos servidores Nextcloud. Se o Redis parasse, o Nextcloud falharia primeiro e o Grafana perceberia depois. Corrigido: os dois estão na lista do Monit agora.

A lição: “funciona” e “está configurado como o resto” são duas afirmações diferentes. Você verifica a segunda colocando o serviço pequeno ao lado dos grandes: sandbox, monitoramento, troca de senha.

🧰 Administração no dia a dia

  • MONITOR imprime cada comando ao vivo – útil por alguns segundos, caro e cheio de dados em uma instância movimentada.
  • Limpar. No blog, wp cache flush esvazia o object cache com segurança. No Nextcloud, um FLUSHALL derruba também todos os locks; faça isso só com a instância em modo de manutenção.
  • Trocar a senha. Mude no vault, rode o playbook: next_redis a grava no redis.conf e reinicia o Redis, next_k3s_deploy atualiza o Secret e – desde a correção acima – reinicia o pod do Nextcloud na mesma execução. O notify_push a recebe na mesma execução.
  • Atualizações. O pacote do host recebe correções de segurança pelo dnf-automatic, que reinicia o Redis em seguida; a imagem do blog segue o pin em versions.yml.

🆘 Cola: sintoma → comando

A versão curta deste artigo para o momento em que algo está errado. Rode no host como root; <…> são placeholders. occ e wp são as funções de shell dos deep dives de Nextcloud e WordPress.

SintomaComando
Está rodando, e confinado?systemctl status redis
ps -eZ | grep redis # redis_t
Falar com ele sem a senha na linha de comandoexport REDISCLI_AUTH="$(awk '/^requirepass/{print $2}' /etc/redis/redis.conf)"
redis-cli PING
O cache está fazendo seu trabalho?redis-cli INFO stats | grep -E 'keyspace_(hits|misses)|evicted'
Memória cheia?redis-cli INFO memory | grep -E "used_memory_human|maxmemory_human"
Comandos lentos, latência altaredis-cli SLOWLOG GET 5
redis-cli --latency # Ctrl-C to stop
Sem notificações push no Nextcloudk3s kubectl -n nextcloud logs deploy/notify-push --tail=20
occ notify_push:self-test
O cache do blogk3s kubectl -n wordpress exec deploy/redis -- redis-cli INFO keyspace
wp redis status
wp cache flush # empties it, safe

🎯 As lições

  • Cache ou lock: isso decide eviction e persistência.
  • O que escuta em um endereço alcançável precisa de uma senha.
  • Uma senha trocada precisa chegar a todos os clientes na mesma execução.
  • Serviços pequenos recebem o mesmo hardening e monitoramento que os grandes.
  • A versão da distribuição é um padrão, não uma decisão – ela pode e deve ser verificada.

⚖️ Alternativas – e por que Redis

OpçãoPonto fortePor que não aqui
MemcachedCache simples e rápidoNenhuma semântica de locking que o Nextcloud possa usar; deixaria o locking no banco de dados.
Só APCuNo processo, sem redeNão é compartilhado entre processos PHP nem pods – inútil para locking. O Nextcloud o usa adicionalmente como cache local.
Locking no banco de dadosNenhum serviço extraO fallback do Nextcloud; adiciona carga no componente mais ocupado e é mais lento.
Valkey / KeyDBForks com outra governança ou threadingO Valkey é o provável próximo passo; o KeyDB é menos ativo.
RedisO que as duas aplicações esperam e contra o qual testam, consumo mínimoEscolhido.

O Redis é o tipo de componente fácil de esquecer porque nunca reclama. A revisão para este artigo foi um lembrete de que “funciona” e “está configurado do jeito que o resto está” são duas afirmações diferentes – e de que vale a pena verificar a segunda também nos serviços pequenos.

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes