Valkey: Guia Completo do Fork Open Source do Redis

TL;DR — Resumo Rápido

Valkey é o fork open source do Redis pela Linux Foundation. Instale, migre do Redis sem perda de dados e configure clusters e Sentinel com este guia completo.

Valkey é o fork open source do Redis sob a Linux Foundation, criado após a mudança de licença da Redis Ltd em março de 2024. Se você executa Redis em produção e quer permanecer em um armazenamento de chave-valor verdadeiramente open source com governança comunitária, este guia cobre instalação, migração do Redis sem perda de dados, e operação de clusters e Sentinel.

Por Que o Valkey Existe

O Redis foi licenciado sob BSD de 2009 até início de 2024. Em 20 de março de 2024, a Redis Ltd relicenciou o Redis sob um modelo dual SSPL/RSAL — nenhuma das licenças é aprovada pela OSI, o que significa que o Redis não é mais open source pela definição padrão. Provedores de nuvem e colaboradores fizeram fork da última versão BSD (7.2.4) em poucos dias.

A Linux Foundation aceitou o fork como Valkey em abril de 2024, com suporte da Amazon Web Services, Google Cloud, Oracle, Ericsson, Snap e muitos colaboradores individuais.

Pré-requisitos

• Servidor Linux com Ubuntu 22.04+, Debian 12+, RHEL 9+, ou qualquer distro moderna.
• Instalação existente do Redis 6.x ou 7.x (se estiver migrando).
• Acesso sudo ou root.
• Docker (opcional, para a rota de contêiner).

---

Instalando o Valkey

apt (Debian/Ubuntu)

curl -fsSL https://packages.valkey.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/valkey.gpg
echo "deb [signed-by=/usr/share/keyrings/valkey.gpg] https://packages.valkey.io/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/valkey.list
sudo apt update && sudo apt install -y valkey

dnf (RHEL/Fedora/Rocky Linux)

sudo dnf install -y https://packages.valkey.io/rpm/valkey-release-latest.rpm
sudo dnf install -y valkey

Docker

docker run -d \
  --name valkey \
  -p 6379:6379 \
  -v valkey-data:/data \
  valkey/valkey:latest valkey-server --save 60 1 --loglevel warning

---

Migrando do Redis para o Valkey

O Valkey lê diretamente os arquivos RDB e AOF do Redis — nenhuma conversão é necessária.

Passo 1: Salvar e Fazer Backup dos Dados do Redis

redis-cli SAVE
sudo cp -r /var/lib/redis /var/lib/redis-backup

Passo 2: Parar o Redis

sudo systemctl stop redis-server
sudo systemctl disable redis-server

Passo 3: Configurar o Valkey

sudo cp /etc/redis/redis.conf /etc/valkey/valkey.conf
sudo sed -i 's|^dir .*|dir /var/lib/redis|' /etc/valkey/valkey.conf

valkey.conf usa sintaxe idêntica ao redis.conf. Cada diretiva — bind, requirepass, maxmemory, políticas de despejo, TLS, RDB, AOF — funciona sem alterações.

Passo 4: Iniciar o Valkey e Verificar

sudo systemctl enable valkey-server
sudo systemctl start valkey-server
valkey-cli PING          # → PONG
valkey-cli DBSIZE        # verificar contagem de chaves

Passo 5: Atualizar Strings de Conexão

Mude host: redis para host: valkey (ou o novo IP/hostname). Nenhuma outra alteração de código é necessária.

---

Referência de Configuração

Diretiva	Exemplo	Propósito
bind	bind 127.0.0.1 ::1	Endereços de escuta
requirepass	requirepass s3cr3t	Autenticação por senha
maxmemory	maxmemory 2gb	Limite de memória
maxmemory-policy	allkeys-lru	Política de despejo
save	save 900 1	Agenda de snapshots RDB
appendonly	appendonly yes	Ativar AOF

---

Novos Recursos do Valkey

O Valkey inclui melhorias não presentes no Redis OSS:

• Transporte RDMA — Remote Direct Memory Access para clusters de latência ultra baixa (Valkey 8.0+).
• Dict por slot no modo cluster — Cada um dos 16.384 hash slots tem seu próprio dicionário, reduzindo a contenção de bloqueios.
• Replicação de canal duplo — Canal dedicado para transferência de dados em massa e outro para streaming de comandos ao vivo.
• Maior eficiência de memória — Menor overhead por chave vs Redis 7.2.

---

Cluster Valkey

O Cluster Valkey usa o mesmo modelo de 16.384 hash slots do Redis Cluster. As ferramentas existentes funcionam sem alterações.

# Criar cluster de 6 nós (3 primários + 3 réplicas)
valkey-cli --cluster create \
  192.168.1.1:7000 192.168.1.2:7001 192.168.1.3:7002 \
  192.168.1.4:7003 192.168.1.5:7004 192.168.1.6:7005 \
  --cluster-replicas 1

# Verificar status do cluster
valkey-cli --cluster check 192.168.1.1:7000

---

Sentinel para Alta Disponibilidade

# /etc/valkey/sentinel.conf
sentinel monitor mymaster 192.168.1.1 6379 2
sentinel auth-pass mymaster s3cr3t
sentinel down-after-milliseconds mymaster 5000
sentinel failover-timeout mymaster 60000

valkey-sentinel /etc/valkey/sentinel.conf

---

Docker Compose com Sentinel

services:
  valkey-primary:
    image: valkey/valkey:latest
    command: valkey-server --requirepass ${VALKEY_PASSWORD} --appendonly yes
    volumes:
      - valkey-primary-data:/data
    networks: [valkey-net]

  valkey-replica:
    image: valkey/valkey:latest
    command: >
      valkey-server
      --replicaof valkey-primary 6379
      --requirepass ${VALKEY_PASSWORD}
      --masterauth ${VALKEY_PASSWORD}
    volumes:
      - valkey-replica-data:/data
    networks: [valkey-net]
    depends_on: [valkey-primary]

  valkey-sentinel:
    image: valkey/valkey:latest
    command: valkey-sentinel /etc/valkey/sentinel.conf
    configs:
      - source: sentinel-conf
        target: /etc/valkey/sentinel.conf
    networks: [valkey-net]

volumes:
  valkey-primary-data:
  valkey-replica-data:

networks:
  valkey-net:

configs:
  sentinel-conf:
    content: |
      sentinel monitor mymaster valkey-primary 6379 1
      sentinel auth-pass mymaster ${VALKEY_PASSWORD}
      sentinel down-after-milliseconds mymaster 5000

---

Valkey vs Redis e Alternativas

Recurso	Valkey	Redis OSS	Redis Enterprise	KeyDB	Dragonfly
Licença	BSD 3-Clause	SSPL/RSAL	Proprietária	BSD	BSL 1.1
Governança	Linux Foundation	Redis Ltd	Redis Ltd	Snap Inc	Dragonfly DB
Compat. Redis	Total (7.2)	Nativa	Total	Total	Alta
Cluster	Sim	Sim	Sim	Sim	Sim
RDMA	Sim (v8+)	Não	Parcial	Não	Não
Custo	Grátis	Grátis	Pago	Grátis	Grátis (núcleo)

---

Resumo

• Valkey é o fork com licença BSD e governança da Linux Foundation do Redis 7.2 — substituto direto compatível.
• A migração é direta: pare o Redis, aponte o Valkey para o diretório de dados existente, inicie o Valkey.
• Todos os clientes Redis conectam-se ao Valkey sem alterações de código — apenas o hostname muda.
• Cluster e Sentinel usam configuração e ferramentas idênticas ao Redis.
• Novos recursos no Valkey 8+ melhoram o desempenho além do Redis 7.2.

Artigos Relacionados

• Docker Compose para Aplicações Multi-Contêiner
• Adicionar e Remover Links Simbólicos no Ubuntu
• DIUN Notificador de Atualizações de Imagens Docker