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.

🌐 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
| Blog | Servidores Nextcloud | |
|---|---|---|
| Onde | Pod no K3s (redis:7.4-alpine) | No host, pacote AlmaLinux (Redis 7.2, module stream redis:7; 6.2 até 26 out 2026) |
| Role | blog_k3s_deploy | next_packages + next_redis |
| Usado para | Object cache | File locking + cache distribuído |
| Limite de memória | 80 MB, allkeys-lru | nenhum, noeviction |
| Persistência | nenhuma (--save "", AOF desligado) | Snapshots RDB (padrão do pacote) |
| Senha | nenhuma | requirepass do vault |
| Acessado por | ClusterIP Service, NetworkPolicy: só pods do WordPress | IP do nó e 127.0.0.1, nftables: só a rede de pods |
| SELinux | container_t com categorias MCS próprias | redis_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
| Blog | Nextcloud A | Nextcloud B | |
|---|---|---|---|
| Versão | 7.4.11 | 6.2.24 → 7.2.16 | 6.2.24 → 7.2.16 |
| Memória usada | 14,8 MB | 1,7 MB | 1,3 MB |
| Chaves | 19.079 | 56 | 83 |
| Hit rate desde o restart | 87,6 % | 85,9 % | 64,4 % |
| Chaves removidas | 0 | 0 | 0 |
| Entradas no slow log | 1 | 3 | 0 |
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 implicamNoNewPrivileges, e com isso o SELinux recusou a transição pararedis_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 10000e gravadump.rdbregularmente – 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 odump.rdbantigo 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 doconfig.php, onde o instalador a gravou uma vez – também foi automatizada: o playbook copia a senha do Secret para oconfig.phpsempre 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
MONITORimprime cada comando ao vivo – útil por alguns segundos, caro e cheio de dados em uma instância movimentada.- Limpar. No blog,
wp cache flushesvazia o object cache com segurança. No Nextcloud, umFLUSHALLderruba 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_redisa grava noredis.confe reinicia o Redis,next_k3s_deployatualiza 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.
| Sintoma | Comando |
|---|---|
| Está rodando, e confinado? | systemctl status redisps -eZ | grep redis # redis_t |
| Falar com ele sem a senha na linha de comando | export 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 alta | redis-cli SLOWLOG GET 5redis-cli --latency # Ctrl-C to stop |
| Sem notificações push no Nextcloud | k3s kubectl -n nextcloud logs deploy/notify-push --tail=20occ notify_push:self-test |
| O cache do blog | k3s kubectl -n wordpress exec deploy/redis -- redis-cli INFO keyspacewp redis statuswp 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ção | Ponto forte | Por que não aqui |
|---|---|---|
| Memcached | Cache simples e rápido | Nenhuma semântica de locking que o Nextcloud possa usar; deixaria o locking no banco de dados. |
| Só APCu | No processo, sem rede | Não é compartilhado entre processos PHP nem pods – inútil para locking. O Nextcloud o usa adicionalmente como cache local. |
| Locking no banco de dados | Nenhum serviço extra | O fallback do Nextcloud; adiciona carga no componente mais ocupado e é mais lento. |
| Valkey / KeyDB | Forks com outra governança ou threading | O Valkey é o provável próximo passo; o KeyDB é menos ativo. |
| Redis | O que as duas aplicações esperam e contra o qual testam, consumo mínimo | Escolhido. |
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.
