PauloRB.dev

Como Resolver Problemas de Permissões ao Usar Docker no WSL2

Por Paulo RB em 31/08/2024

O Docker é uma ferramenta poderosa para gerenciar contêineres, e sua integração com o WSL2 no Windows oferece um ambiente de desenvolvimento robusto e flexível. No entanto, ao configurar o Docker no WSL2, é comum encontrar alguns problemas de permissão que impedem a execução suave dos comandos Docker sem a necessidade de usar sudo. Neste post, vamos abordar as etapas para configurar corretamente o Docker no WSL2 e resolver esses problemas de permissão.

Problema Inicial: “Couldn’t connect to Docker daemon”

Ao tentar executar o comando docker-compose up -d no WSL2, você pode se deparar com o seguinte erro:

ERROR: Couldn't connect to Docker daemon at http+docker://localhost - is it running?

If it's at a non-standard location, specify the URL with the DOCKER_HOST environment variable.

Esse erro geralmente ocorre quando o Docker daemon não está em execução ou quando não está configurado corretamente no WSL2. Para resolver isso, siga os passos abaixo.

Solução: Verificando a Configuração do Docker no WSL2

1. Verifique se o Docker Desktop está em execução:
   • Abra o Docker Desktop no Windows e verifique se ele está rodando. Caso não esteja, inicie o Docker Desktop.
2. Configure o WSL2 para utilizar o Docker:
   • No Docker Desktop, vá em Settings > General e certifique-se de que a opção Use the WSL 2 based engine está marcada.
3. Verifique a integração com a distribuição WSL2:
   • Ainda nas configurações do Docker Desktop, vá para Settings > Resources > WSL Integration e certifique-se de que a sua distribuição WSL2 está marcada para integração.
4. Reinicie o Docker e o WSL2:
   • Reinicie o Docker Desktop e execute o comando wsl --shutdown no PowerShell ou no prompt de comando do Windows para reiniciar as instâncias do WSL2.
5. Verifique a variável de ambiente DOCKER_HOST:
   • Se estiver usando uma configuração personalizada do Docker daemon, configure a variável de ambiente DOCKER_HOST com:

export DOCKER_HOST=unix:///var/run/docker.sock

1. • Adicione essa linha ao arquivo ~/.bashrc ou ~/.zshrc para que seja carregada automaticamente em todas as sessões.

Problema Persistente: Necessidade de Usar sudo para Comandos Docker

Mesmo após resolver a conexão com o Docker daemon, você pode perceber que é necessário usar sudo para executar comandos Docker, o que pode ser inconveniente. Para configurar o Docker de forma a não exigir sudo, siga estas etapas:

1. Adicione seu usuário ao grupo docker:

   Crie o grupo docker (caso não exista):

   Copy Code Copied Use a different Browser

   
   sudo groupadd docker
   
   
2. Adicione seu usuário ao grupo docker:

sudo usermod -aG docker $USER

• • Reinicie o terminal WSL2 para aplicar as mudanças.
• Verifique se a adição ao grupo docker funcionou:
  • Execute o comando groups para verificar se o grupo docker aparece na lista de grupos.
• Corrija as permissões do Docker socket:
  • Se o problema persistir, aplique as permissões corretas ao socket do Docker:

sudo chmod 666 /var/run/docker.sock

Reinicie o Docker e o WSL2:

• Reinicie o serviço Docker e o WSL2 para garantir que as alterações sejam aplicadas:

sudo service docker restart
wsl --shutdown

Reinicie o sistema (se necessário):

• • Se ainda assim o problema continuar, uma reinicialização completa do sistema pode ser necessária.

Conclusão

Configurar o Docker no WSL2 pode apresentar alguns desafios, especialmente relacionados a permissões. No entanto, seguindo as etapas acima, você deve ser capaz de executar comandos Docker sem precisar do sudo, tornando seu fluxo de trabalho mais eficiente. Se ainda enfrentar problemas, pode ser útil revisar logs do sistema ou buscar ajuda em fóruns especializados.

Com essas configurações, você estará pronto para aproveitar ao máximo o Docker no WSL2, sem dores de cabeça!