Fazer deploy ↗
docs

Redis

Redis gerenciado para cache, sessões, filas e pub/sub. Tiers otimizados para memória.

Redis gerenciado para cache, sessões, filas (BullMQ, Sidekiq), pub/sub e qualquer dado que precisa de leitura/escrita sub-milissegundo. Tiers otimizados para RAM, não CPU.

Versão padrão Versões disponíveis Porta padrão
7 7, 6 6379

Tamanhos

Tamanho CPU Memória
basico 0.15 vCPU 128 MB
essencial 0.25 vCPU 256 MB
turbo 0.25 vCPU 512 MB
turbo-plus 0.5 vCPU 1 GB
nitro 0.5 vCPU 2 GB
nitro-plus 1 vCPU 4 GB

O tamanho padrão é essencial. Use tiers maiores quando o working set não cabe em memória, evictions começam a acontecer ou você usa pub/sub com payloads grandes.

Criar via CLI

# Mais simples
veloz db create --name cache --engine redis
 
# Com tier maior
veloz db create --name cache --engine redis --size turbo

Criar via veloz.json

{
  "databases": {
    "cache": {
      "engine": "redis",
      "size": "basico"
    }
  }
}

Nota: Redis não usa o campo pooler (só PostgreSQL). O storage é alocado para snapshots/AOF, não para dados ativos, que ficam em RAM.

Variáveis injetadas

Quando o banco está LIVE:

  • CACHE_DATABASE_URL, formato redis://user:pass@host:6379 (substitua CACHE pelo nome do seu banco)
  • CACHE_HOST, CACHE_PORT, CACHE_USERNAME, CACHE_PASSWORD
  • REDIS_URL, alias automático se este for o único Redis do projeto

Acesso local

Túnel para GUI (RedisInsight, TablePlus) ou redis-cli

# Abre na porta 6379 local
veloz db tunnel cache
 
# Porta customizada
veloz db tunnel cache --port 6380

Em outra aba:

redis-cli -h 127.0.0.1 -p 6380 -a senha

As credenciais aparecem em veloz db credentials cache.

Query rápida

# Interativo
veloz db query cache
 
# Comandos inline
veloz db query cache -q "GET session:abc123"
veloz db query cache -q "KEYS user:*"
veloz db query cache -q "HGETALL user:42"

Cuidado: KEYS * em produção bloqueia o servidor. Para listar keys de forma segura, use SCAN no client da sua aplicação.

Dashboard

A seção de Insights traz métricas em tempo real (memória usada vs disponível, conexões, ops/s, hit rate) e o Redis Explorer para listar keys com filtro por padrão (ex: user:*), inspecionar tipo/TTL/tamanho e editar valores direto no navegador.

Padrões comuns

# Cache simples
SET user:42:profile "{json}" EX 3600
 
# Sessões (Express + connect-redis, Rails session_store)
# A biblioteca cuida; só aponta para REDIS_URL
 
# Filas (BullMQ, Sidekiq)
# Mesma coisa, BullMQ/Sidekiq leem REDIS_URL
 
# Pub/Sub
PUBLISH notifications "user:42:logged_in"
SUBSCRIBE notifications

Comandos úteis

veloz db list                    # Listar bancos
veloz db credentials cache       # Ver host, porta, senha
veloz db update cache --size turbo   # Trocar tier
veloz db restart cache           # Reiniciar engine (limpa dados em RAM)
veloz db delete cache            # Excluir (irreversível)

Próximos passos