Como usar Docker para desenvolver localmente sem que tudo quebre?

MO Monica Torres MX 📗 Estudante 👁 83 ⚑ Denunciar Programação

Estou há um mês tentando colocar Docker no meu fluxo de trabalho mas toda vez que subo os contêineres me dá erros de permissões ou portas que já estão em uso. Trabalho no Windows com WSL2 e tenho um projeto Node com PostgreSQL. Tem alguma forma de fazer isso sem ser tão complicado?

5 respostas

★ Melhor resposta

Sinceramente as permissões não são tanta confusão quanto parece no começo, a maioria das pessoas aqui tá focada nas portas e tá certo, mas o que ninguém menciona é que no WSL2 você precisa dar permissões pro usuário do Docker sem ficar metendo `sudo` em tudo. Você roda `sudo usermod -aG docker $USER` uma única vez, fecha e reabre o terminal, e pronto - depois Docker funciona sem você ter que ficar brigando com permissões cada vez que levanta um contêiner. Depois disso, a configuração com docker-compose fica muito mais tranquila porque você não tá lidando com erros de permissões que te confundem com os de portas.

Sergio MX 🛠️ Especialista 💬 70 respostas ⚑

Os erros de portas que já estão em uso são o mais comum e chato. Primeiro verifica o que está ocupando as portas: no Windows/WSL2 executa `netstat -ano | findstr :5432` (ou a porta que uses) para ver qual processo a tem. Se é outro contêiner que ficou pendurado, mata o contêiner com `docker rm -f nome_contêiner`. O problema de permissões geralmente vem de WSL2 tentando montar volumes sem os permissões corretos no Windows, então no teu `docker-compose.yml` especifica explicitamente as portas e não uses bind mounts complicados no começo; melhor copia o código na imagem ou usa volumes nomeados que Docker gerencia melhor.

Para teu setup de Node + PostgreSQL, o mais limpo é um `docker-compose.yml` onde definas os serviços sem complicar. Mapeia portas diferentes se algo já está usando as padrão (ex: `5433:5432` para Postgres), garante que teu Node consiga resolver o hostname do contêiner de BD (usa o nome do serviço no docker-compose, tipo `postgres:5432`), e reinicia tudo limpo: `docker-compose down -v` mata os contêineres e volumes, depois `docker-compose up`. Cuidado com volumes nomeados vs bind mounts no WSL2; os bind mounts às vezes se comportam estranho com permissões, então para desenvolvimento local considera simplesmente não montar o código se não precisa, ou usa volumes nomeados que WSL2 gerencia melhor.

A parte que a maioria não faz: verifica os logs. `docker-compose logs -f` te mostra o que acontece dentro em tempo real; aí vês se a aplicação realmente se conecta, se a BD está pronta, tudo. E uma coisa que economiza muitas horas, especialmente no Windows: às vezes WSL2 e Docker têm conflitos estranhos, então se continuar sendo um caos, tenta com Docker Desktop direto (não WSL2) ou garante que tua versão de WSL2 esteja atualizada. A maioria de gente que abandona Docker no Windows é porque não atualiza WSL2 ou mistura configurações.

Antes de começar a matar processos, garante que seu `docker-compose.yml` tem nomes claros para os serviços e que as portas no arquivo não estão hardcodeadas. O que te salva aqui é usar variáveis de ambiente: em vez de colocar `5432:5432` direto, define um `.env` com `DB_PORT=5432` e no compose você usa `${DB_PORT}:5432`. Assim quando precisar mudar de porta (porque algo já está usando) você mexe só no arquivo de configuração em um lugar, não fica procurando no código. Também, no WSL2 às vezes os contêineres ficam pendurados; antes de reiniciar tudo, tenta `docker system prune -a` para limpar o que está velho e causando bagunça.

A forma mais rápida de evitar essas confusões é usar variáveis de ambiente no seu `docker-compose.yml` em vez de hardcodear as portas, assim você consegue mudá-las sem mexer no arquivo toda hora. No meu caso tinha o mesmo problema com PostgreSQL e Node rodando em WSL2, e o que me salvou foi simplesmente criar um arquivo `.env` com `DB_PORT=5432` e `NODE_PORT=3000`, depois referenciar eles no compose como `${DB_PORT}:5432` - se a porta estiver ocupada mudo uma única linha no `.env` e pronto, sem que tudo quebre. Também recomendo adicionar `restart: unless-stopped` nos seus serviços para que se reiniciem automaticamente se algo falhar, e sobre as permissões em WSL2, execute Docker direto de WSL em vez de do PowerShell, porque assim você evita os problemas estranhos de permissões entre Windows e Linux. Uma última coisa: se continuar com problemas de contêineres que não querem morrer, `docker-compose down -v` limpa absolutamente tudo incluindo volumes, assim você começa do zero sem fantasmas.

Docker não é complicado, o problema é que WSL2 no Windows tem suas próprias pegadinhas e ninguém menciona. O que te economiza horas é simplesmente parar de pensar em portas e permissões como problemas separados: a maioria dos problemas vem de os contêineres não conseguirem se comunicar entre si porque você usa localhost no lugar do nome do serviço dentro da rede do Docker.

No seu `docker-compose.yml`, na string de conexão do Node com PostgreSQL não coloque `localhost:5432`, use direto `postgres:5432` (ou o nome que der ao serviço). E em `.env` ou variáveis do contêiner, configure a conexão assim. Isso resolve 80% dos dramas de permissões que você vê: não é que você não tem acesso, é que está apontando errado. Se mesmo assim quiser expor as portas, exporte em `ports: ["7654:5432"]` mas dentro do contêiner sempre use o nome do serviço, nunca a porta do host.

Sua resposta

Entrarpara responder.