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