Laboratório: Metabase em produção com PostgreSQL via Docker Compose

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

12

Validações

4

Versões da documentação consultada

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

Topologia

Uma VM Linux (exemplo: 192.168.56.10) roda dois containers: um com PostgreSQL, outro com Metabase. O Metabase conecta-se ao PostgreSQL pela rede interna do Docker. O acesso ao Metabase é feito via navegador em outro dispositivo na mesma rede, usando a porta 3000.

┌────────────┐        ┌─────────────┐
│  Usuário   │ <───> │   Metabase  │
│(192.168.56.1)│      │(192.168.56.10:3000)│
└────────────┘        │   │
                      │   │
                ┌─────▼─────┐
                │ PostgreSQL │
                │(Docker net)│
                └────────────┘

Equipamentos e software

Roteiro

1. Preparar a VM Linux

   Atualize os pacotes da VM para garantir segurança e compatibilidade.

   sudo apt update && sudo apt upgrade -yCopiar

   O que você deve ver: Sistema atualizado sem erros.

2. Instalar Docker e Docker Compose

   O Metabase e o PostgreSQL serão executados em containers. Instale Docker e Docker Compose para facilitar o gerenciamento.

   sudo apt install docker.io docker-compose -yCopiar

   O que você deve ver: Comando 'docker --version' e 'docker-compose --version' retornam versões instaladas.

3. Criar diretórios de persistência

   Crie pastas para persistir dados do PostgreSQL e do Metabase. Isso evita perda de dados ao reiniciar containers.

   mkdir -p ~/metabase_lab/postgres_data
   mkdir -p ~/metabase_lab/metabase_dataCopiar

   O que você deve ver: Diretórios criados em ~/metabase_lab.

4. Criar arquivo docker-compose.yml

   Monte um arquivo docker-compose.yml para orquestrar os serviços Metabase e PostgreSQL, com volumes persistentes e variáveis de ambiente seguras.

   cat > ~/metabase_lab/docker-compose.yml <<EOF
   version: '3.8'
   services:
     db:
       image: postgres:15
       container_name: metabase-postgres
       restart: unless-stopped
       environment:
         POSTGRES_DB: metabase
         POSTGRES_USER: metabase
         POSTGRES_PASSWORD: m3t4b453_pwd
       volumes:
         - ./postgres_data:/var/lib/postgresql/data
       networks:
         - metanet
     metabase:
       image: metabase/metabase:latest
       container_name: metabase-app
       restart: unless-stopped
       environment:
         MB_DB_TYPE: postgres
         MB_DB_DBNAME: metabase
         MB_DB_PORT: 5432
         MB_DB_USER: metabase
         MB_DB_PASS: m3t4b453_pwd
         MB_DB_HOST: db
       ports:
         - 3000:3000
       volumes:
         - ./metabase_data:/metabase-data
       networks:
         - metanet
   networks:
     metanet:
       driver: bridge
   EOFCopiar

   O que você deve ver: Arquivo docker-compose.yml criado em ~/metabase_lab.

5. Iniciar os containers

   Suba os containers em modo destacado. O Metabase irá inicializar e conectar ao PostgreSQL automaticamente.

   cd ~/metabase_lab
   docker-compose up -dCopiar

   O que você deve ver: Containers 'metabase-postgres' e 'metabase-app' em execução.

6. Verificar logs de inicialização

   Acompanhe os logs do Metabase para garantir que subiu sem erros e conectou ao banco.

   docker logs -f metabase-appCopiar

   O que você deve ver: Mensagens de inicialização do Metabase e confirmação de conexão ao PostgreSQL.

7. Acessar a interface web do Metabase

   Abra o navegador e acesse http://<IP-da-VM>:3000 para iniciar o setup.

   O que você deve ver: Tela de configuração inicial do Metabase.

8. Configurar usuário administrador

   Crie o usuário admin do Metabase. Isso define quem gerencia o ambiente.

   O que você deve ver: Usuário criado e acesso ao painel principal do Metabase.

9. Conectar uma base de dados de exemplo

   Adicione uma fonte de dados (pode ser o próprio PostgreSQL criado). Isso permite criar perguntas e dashboards.

   O que você deve ver: Base de dados conectada e disponível no Metabase.

10. Criar uma pergunta simples

    No Metabase, crie uma pergunta (query) simples para validar a conexão e visualizar dados.

    O que você deve ver: Resultado da consulta exibido na interface.

11. Criar um dashboard

    Monte um dashboard básico adicionando a pergunta criada. Isso valida a funcionalidade de BI.

    O que você deve ver: Dashboard criado e visualizável.

12. Testar persistência dos dados

    Reinicie os containers e verifique se as configurações e dashboards permanecem.

    docker-compose down
    docker-compose up -dCopiar

    O que você deve ver: Ambiente volta ao ar com dados preservados.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Altere as senhas padrão do PostgreSQL e do Metabase.
• Não exponha a porta 3000 para a internet sem proxy reverso e autenticação forte.
• Restrinja o acesso aos volumes de dados.
• Mantenha Docker e containers sempre atualizados.
• Consulte a documentação do Metabase para variáveis de ambiente sensíveis.

Checklist final

• VM Linux atualizada
• Docker e Docker Compose instalados
• docker-compose.yml criado e revisado
• Containers em execução
• Acesso ao Metabase via navegador
• Usuário admin criado
• Base de dados conectada
• Pergunta e dashboard criados
• Persistência testada após reinício