DEV Community

Cover image for Windows - Instalando o WSL e o Docker
Luis Cruz
Luis Cruz

Posted on

Windows - Instalando o WSL e o Docker

#linux #microsoft #docker

Pré-requisitos

  • Windows 11 ou Windows 10 com atualizações que suportem WSL 2.
  • Virtualização por hardware habilitada na BIOS/UEFI.
  • Conexão à internet para baixar distribuições, pacotes e imagens Docker.

Instalar o WSL (passo rápido)

No PowerShell em modo Administrador execute:

wsl --install
Enter fullscreen mode Exit fullscreen mode

Esse comando habilitará os recursos necessários para executar o WSL e instalar a distribuição do Ubuntu do Linux. (Essa distribuição padrão pode ser alterada).

Verificar versão e distros

wsl --version
Enter fullscreen mode Exit fullscreen mode 
wsl -l -v
Enter fullscreen mode Exit fullscreen mode

Novas instalações feitas com wsl --install são, por padrão, configuradas para WSL 2.

Para instruções oficiais e detalhes, consulte a documentação do WSL.

Opção com interface gráfica: Docker Desktop com integração WSL 2

  1. Baixe e instale o Docker Desktop para Windows.
  2. Em Settings > General ative Use the WSL 2 based engine.
  3. Em Resources > WSL Integration habilite a distro que você usa.
  4. Abra o terminal dentro do WSL: os comandos docker e docker compose estarão disponíveis.

Essa abordagem reduz conflitos e facilita para quem não tem familiaridade com CLI (interface de linha de comando). Para mais detalhes, acesse a documentação.

Alternativa: instalar Docker Engine dentro do Ubuntu (WSL 2)

Se não desejar usar Docker Desktop, siga dentro do Ubuntu:

sudo apt-get update
Enter fullscreen mode Exit fullscreen mode 
sudo apt-get install -y ca-certificates curl gnupg lsb-release
Enter fullscreen mode Exit fullscreen mode 
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Enter fullscreen mode Exit fullscreen mode 
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \
  https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Enter fullscreen mode Exit fullscreen mode 
sudo apt-get update
Enter fullscreen mode Exit fullscreen mode 
sudo apt-get install -y docker-ce docker-ce-cli containerd.io
Enter fullscreen mode Exit fullscreen mode 
sudo usermod -aG docker $USER
Enter fullscreen mode Exit fullscreen mode

Depois faça no PowerShell e reabra a distro:

wsl --shutdown
Enter fullscreen mode Exit fullscreen mode

Teste com:

docker run --rm hello-world
Enter fullscreen mode Exit fullscreen mode

Consulte o guia oficial de instalação do Docker Engine para Ubuntu.

Docker Compose

O Docker Compose é distribuído como plugin (v2+). Em Linux instale docker-compose-plugin pelo repositório Docker ou siga a página oficial de instalação do Compose. Se usar Docker Desktop, o Compose já vem integrado.

docker compose version
Enter fullscreen mode Exit fullscreen mode

Exemplos práticos

Rodar um Nginx simples:

docker run --name exemplo-nginx -p 8080:80 -d nginx:stable
Enter fullscreen mode Exit fullscreen mode

Acesse no host: http://localhost:8080

docker-compose.yml mínimo:

services:
  web:
    image: nginx:stable
    ports:
      - "8080:80"
Enter fullscreen mode Exit fullscreen mode

Subir:

docker compose up -d
Enter fullscreen mode Exit fullscreen mode 
docker compose ps
Enter fullscreen mode Exit fullscreen mode 
docker compose logs -f
Enter fullscreen mode Exit fullscreen mode

Referências e links úteis

Microsoft - Como instalar o WSL (pt-BR)

Microsoft - WSL config (wsl.conf) / systemd

Docker - Docker Desktop: WSL 2 backend / integração

Docker - Instalar Docker Engine no Ubuntu

Docker - Instalar o plugin Docker Compose

Docker - Documentação geral do Compose

Top comments (0)