Laboratório: Redash com PostgreSQL e Docker Compose em rede local

Duração estimada

120 min

Passos

11

Validações

5

Versões da documentação consultada

Redash a versão estável atual · Docker a versão estável atual · Docker Compose a versão estável atual · PostgreSQL a versão estável atual

Topologia

O usuário acessa o Redash via navegador em http://192.168.56.10:5000. O Redash, rodando em container, conecta-se a um container PostgreSQL na mesma VM. O PostgreSQL serve como fonte de dados e armazena as informações do Redash.

Usuário (browser)
      |
      v
[Redash (Docker, 192.168.56.10:5000)]
      |
      v
[PostgreSQL (Docker, 192.168.56.10:5432)]

Equipamentos e software

Roteiro

1. Preparar a VM e instalar dependências

   Atualize o sistema e instale Docker e Docker Compose. O Redash depende desses componentes para orquestração e isolamento.

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y docker.io docker-composeCopiar

   O que você deve ver: Docker e Docker Compose instalados e ativos.

2. Criar diretório de trabalho

   Organize os arquivos do laboratório em um diretório dedicado.

   mkdir ~/redash-lab && cd ~/redash-labCopiar

   O que você deve ver: Diretório ~/redash-lab criado e acessado.

3. Criar arquivo docker-compose.yml

   Defina os serviços do Redash e PostgreSQL. O Compose facilita o gerenciamento dos containers.

   cat > docker-compose.yml <<EOF
   version: '3.8'
   services:
     postgres:
       image: postgres:13-alpine
       environment:
         POSTGRES_PASSWORD: redashpass
         POSTGRES_USER: redash
         POSTGRES_DB: redash
       ports:
         - "5432:5432"
       volumes:
         - pgdata:/var/lib/postgresql/data
     redash:
       image: redash/redash:latest
       depends_on:
         - postgres
       environment:
         REDASH_DATABASE_URL: "postgresql://redash:redashpass@postgres/redash"
         REDASH_REDIS_URL: "redis://redis:6379/0"
       ports:
         - "5000:5000"
       command: server
     redis:
       image: redis:6-alpine
   volumes:
     pgdata:
   EOFCopiar

   O que você deve ver: Arquivo docker-compose.yml criado com serviços redash, postgres e redis.

4. Subir os containers

   Inicie todos os serviços definidos no Compose. Isso garante o ambiente isolado e replicável.

   sudo docker-compose up -dCopiar

   O que você deve ver: Containers redash, postgres e redis em execução.

5. Inicializar o banco de dados do Redash

   O Redash precisa preparar o banco antes do primeiro uso. Execute o comando de migração.

   sudo docker-compose run --rm redash create_dbCopiar

   O que você deve ver: Mensagens de migração concluída sem erros.

6. Acessar a interface web do Redash

   Abra o navegador e acesse http://<IP_da_VM>:5000. O Redash estará disponível para configuração inicial.

   O que você deve ver: Tela de cadastro do primeiro usuário (admin).

7. Criar usuário administrador

   Preencha o formulário inicial para criar o usuário admin. Isso habilita o controle de acesso.

   O que você deve ver: Dashboard inicial do Redash visível após login.

8. Adicionar uma fonte de dados PostgreSQL

   No Redash, configure uma fonte de dados PostgreSQL apontando para o próprio container postgres. Isso permite criar queries reais.

   O que você deve ver: Fonte de dados PostgreSQL adicionada e testada com sucesso.

9. Criar uma query de teste

   No Redash, crie uma query simples, por exemplo, 'SELECT 1;'. Isso valida a conexão e o funcionamento do backend.

   O que você deve ver: Resultado da query exibido ('1').

10. Criar um dashboard e adicionar o resultado da query

    Monte um dashboard e insira o widget da query criada. Isso demonstra a visualização colaborativa.

    O que você deve ver: Dashboard criado com widget exibindo o resultado da query.

11. Compartilhar o dashboard via link

    Habilite o compartilhamento público do dashboard. Isso simula colaboração em equipe.

    O que você deve ver: Link público gerado e acessível.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Altere as senhas padrão do PostgreSQL e do admin após o laboratório
• Restrinja o acesso às portas 5000 e 5432 à sua rede local
• Não exponha o link público do dashboard em ambientes de produção sem autenticação
• Remova volumes e containers após o uso para evitar vazamento de dados

Checklist final

• Docker e Docker Compose instalados
• Containers redash, postgres e redis em execução
• Redash acessível via navegador
• Usuário admin criado
• Fonte de dados PostgreSQL conectada
• Query de teste executada
• Dashboard criado e compartilhado