Instalação do Redis

Redis suporta múltiplos sistemas operacionais. Esta lição aborda etapas detalhadas de instalação no Linux, Windows e Mac.

Instalando Redis no Linux

Linux é a melhor plataforma para executar Redis. Para ambientes de produção, Linux é recomendado.

Instalação no Ubuntu/Debian

Método 1: Usando apt (Recomendado para Iniciantes)

BASH

# Atualizar lista de pacotes
sudo apt update

# Instalar servidor Redis
sudo apt install redis-server -y

# Iniciar serviço Redis
sudo systemctl start redis-server

# Habilitar inicialização automática
sudo systemctl enable redis-server

Método 2: Compilar a partir do Código Fonte (Recomendado para Produção)

BASH

# Instalar dependências de compilação
sudo apt update
sudo apt install build-essential tcl -y

# Baixar código fonte do Redis (usando 7.0 como exemplo)
cd /tmp
wget https://download.redis.io/redis-7.0.11.tar.gz

# Extrair
tar xzf redis-7.0.11.tar.gz
cd redis-7.0.11

# Compilar
make

# Testar compilação (opcional, leva alguns minutos)
make test

# Instalar nos diretórios do sistema
sudo make install

💡 Benefícios da instalação por código fonte: Você pode especificar o caminho de instalação, habilitar módulos específicos e otimizar parâmetros de compilação.

Instalação no CentOS/RHEL

Método 1: Usando yum

BASH

# Instalar repositório EPEL
sudo yum install epel-release -y

# Instalar Redis
sudo yum install redis -y

# Iniciar Redis
sudo systemctl start redis

# Habilitar inicialização automática
sudo systemctl enable redis

Método 2: Compilar a partir do Código Fonte

BASH

# Instalar dependências de compilação
sudo yum groupinstall "Development Tools" -y
sudo yum install tcl -y

# Baixar, compilar, instalar (mesmo que no Ubuntu)
cd /tmp
wget https://download.redis.io/redis-7.0.11.tar.gz
tar xzf redis-7.0.11.tar.gz
cd redis-7.0.11
make
sudo make install

Iniciando Redis Manualmente (Após Instalação por Código Fonte)

BASH

# Iniciar servidor Redis (primeiro plano)
redis-server

# Executar em segundo plano (recomendado)
redis-server --daemonize yes

# Iniciar com arquivo de configuração
redis-server /etc/redis/redis.conf

⚠️ Cuidado: Após a instalação por código fonte, você precisa criar manualmente um arquivo de serviço systemd ou usar supervisor para gerenciar o Redis.

Instalando Redis no Windows

Redis não é oficialmente suportado no Windows, mas a Microsoft mantém uma porta para Windows.

Método 1: Usando Instalador (Recomendado)

Passo 1: Baixar Redis

Visite o GitHub para baixar a versão mais recente:

TEXT

https://github.com/microsoftarchive/redis/releases

Baixe Redis-x64-3.2.100.msi (ou uma versão mais recente)

Passo 2: Instalar

Clique duas vezes no arquivo msi
Escolha um caminho de instalação (ex.: C:\Program Files\Redis)
Marque "Adicionar Redis ao PATH"
Marque "Instalar como Serviço do Windows"
Clique em Instalar para concluir

Passo 3: Verificar

Abra o Prompt de Comando:

CMD

redis-cli ping

Se retornar PONG, a instalação foi bem-sucedida.

Método 2: Usando WSL (Recomendado para Desenvolvedores)

WSL (Subsistema Windows para Linux) pode executar a versão nativa do Redis para Linux.

POWERSHELL

# Instalar WSL (PowerShell como Administrador)
wsl --install

# Após reinicializar, instalar Redis no WSL
sudo apt update
sudo apt install redis-server -y

# Iniciar Redis
sudo service redis-server start

💡 Benefícios do WSL: Executa a versão nativa do Redis para Linux para melhor desempenho e suporte completo a recursos.

Método 3: Usando Docker

POWERSHELL

# Baixar imagem Redis
docker pull redis

# Executar container Redis
docker run -d -p 6379:6379 --name redis redis

# Conectar ao Redis
docker exec -it redis redis-cli

Instalando Redis no Mac

Método 1: Usando Homebrew (Recomendado)

BASH

# Instalar Homebrew (se ainda não estiver instalado)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instalar Redis
brew install redis

# Iniciar serviço Redis
brew services start redis

# Ou iniciar em primeiro plano
redis-server

Método 2: Compilar a partir do Código Fonte

BASH

# Instalar ferramentas de compilação (se ainda não estiverem instaladas)
xcode-select --install

# Baixar, compilar, instalar
cd /tmp
wget https://download.redis.io/redis-7.0.11.tar.gz
tar xzf redis-7.0.11.tar.gz
cd redis-7.0.11
make
sudo make install

Instalando Redis com Docker (Multi-plataforma)

Docker é a maneira mais fácil de instalar Redis, adequado para desenvolvimento e teste.

Baixando a Imagem

BASH

# Baixar a versão mais recente
docker pull redis

# Baixar uma versão específica
docker pull redis:7.0
docker pull redis:6.2

Executando o Container

BASH

# Execução básica
docker run -d -p 6379:6379 --name redis redis

# Executar com senha
docker run -d -p 6379:6379 --name redis redis --requirepass sua_senha

# Armazenamento persistente
docker run -d -p 6379:6379 -v /data/redis:/data --name redis redis --appendonly yes

# Usar arquivo de configuração
docker run -d -p 6379:6379 -v /caminho/para/redis.conf:/etc/redis/redis.conf --name redis redis /etc/redis/redis.conf

Conectando ao Redis

BASH

# Entrar no CLI do Redis
docker exec -it redis redis-cli

# Conectar com senha
docker exec -it redis redis-cli -a sua_senha

💡 Benefícios do Docker: Ambiente isolado, implantação rápida, fácil testar diferentes versões.

Verificando a Instalação

Não importa qual método de instalação você usou, verifique se o Redis está instalado corretamente.

1. Verificar Status do Serviço Redis

Linux (systemd):

BASH

sudo systemctl status redis
# ou
sudo systemctl status redis-server

Mac (Homebrew):

BASH

brew services list

Windows:

POWERSHELL

# Verificar status do serviço
Get-Service Redis

2. Conectar com redis-cli

BASH

# Conectar ao Redis local
redis-cli

# Testar após conectar
 ping
PONG

 set test "Olá Redis"
OK

 get test
"Olá Redis"

 exit

3. Verificar Versão do Redis

BASH

redis-server --version
# Saída: Redis server v=7.0.11 sha=00000000:0 malloc=jemalloc-5.2.1 bits=64

redis-cli --version
# Saída: redis-cli 7.0.11

4. Verificar Informações do Redis

BASH

redis-cli info server

Informações principais:

TEXT

redis_version:7.0.11
redis_mode:standalone
os:Linux 5.15.0 x86_64
tcp_port:6379
uptime_in_seconds:3600

Estrutura de Diretórios do Redis

Estrutura de diretórios após instalação por código fonte:

TEXT

/usr/local/bin/
├── redis-server      # Servidor Redis
├── redis-cli         # Cliente de linha de comando Redis
├── redis-benchmark   # Ferramenta de teste de desempenho Redis
├── redis-check-rdb   # Verificador de arquivos RDB
└── redis-check-aof   # Verificador de arquivos AOF

Locais dos arquivos de configuração:

Instalação apt/yum: /etc/redis/redis.conf
Instalação por código fonte: Deve copiar do diretório fonte ou criar manualmente
Instalação Homebrew: /usr/local/etc/redis.conf

Problemas Comuns de Instalação

Problema 1: Porta já em Uso

Mensagem de erro:

TEXT

Creating Server TCP listening socket *:6379: bind: Address already in use

Solução:

BASH

# Verificar uso da porta
sudo lsof -i :6379
# ou
sudo netstat -nltp | grep 6379

# Parar o processo usando a porta
sudo kill -9 <PID>

# Ou iniciar com uma porta diferente
redis-server --port 6380

Problema 2: Permissões Insuficientes

Mensagem de erro:

TEXT

Can't open the log file: Permission denied

Solução:

BASH

# Criar usuário Redis
sudo useradd -r -s /bin/false redis

# Alterar permissões do diretório de dados
sudo chown -R redis:redis /var/lib/redis
sudo chown -R redis:redis /var/log/redis

Problema 3: Memória Insuficiente

Mensagem de erro:

TEXT

OOM command not allowed when used memory > 'maxmemory'.

Solução:

BASH

# Modificar arquivo de configuração para definir memória máxima
maxmemory 256mb

# Ou especificar na inicialização
redis-server --maxmemory 256mb

Problema 4: Firewall do Windows

Solução:

POWERSHELL

# Adicionar regra de firewall (PowerShell como Administrador)
New-NetFirewallRule -DisplayName "Redis" -Direction Inbound -LocalPort 6379 -Protocol TCP -Action Allow

Parâmetros de Inicialização

BASH

redis-server [arquivo de configuração] [opções]

Opções comuns:
--port 6379              # Especificar porta
--bind 0.0.0.0          # Vincular endereço IP
--daemonize yes         # Executar em segundo plano
--logfile /var/log/redis.log  # Arquivo de log
--dir /var/lib/redis    # Diretório de dados
--maxmemory 256mb       # Memória máxima
--requirepass senha     # Definir senha
--appendonly yes        # Habilitar persistência AOF

❓ Perguntas Frequentes

P Qual método de instalação devo usar para produção?

R Compilar a partir do código fonte no Linux é recomendado para que você possa personalizar parâmetros de compilação e otimizar o desempenho. Versões de gerenciadores de pacotes podem estar desatualizadas.

P O Windows pode ser usado para produção?

R Não recomendado. Redis não é oficialmente suportado no Windows, e a versão mantida pela Microsoft tem recursos limitados. Use Linux ou Docker.

P Como instalo múltiplas instâncias do Redis?

R Use portas e arquivos de configuração diferentes: redis-server --port 6380 --config-file /etc/redis/redis-6380.conf

Q: Como desinstalo o Redis? A:

apt: sudo apt remove redis-server

yum: sudo yum remove redis

Código fonte: sudo make uninstall (no diretório fonte)

Homebrew: brew uninstall redis

📖 Resumo

Linux é a melhor plataforma para Redis; compilar a partir do código fonte é recomendado
Windows: use o instalador, WSL ou Docker
Mac: Homebrew é recomendado
Docker é ótimo para desenvolvimento e teste, funciona em múltiplas plataformas
Após a instalação, verifique com redis-cli ping
Para produção, configure senhas, firewalls e limites de memória

📝 Atividades

Prática de instalação: Instale Redis no seu sistema e verifique se funciona
Verificação de versão: Verifique sua versão do Redis e aprenda seus recursos principais
Prática de múltiplas instâncias: Tente iniciar duas instâncias Redis nas portas 6379 e 6380

Próxima Lição

Na próxima lição, nós aprenderemos sobre Início Rápido com Redis — iniciando o Redis e executando seus primeiros comandos.