Ambiente de Desenvolvimento Local .NET no Windows 11 com WSL, Ubuntu 24.04, Docker e VSCode

Este guia apresenta as orientações para montagem de um ambiente de desenvolvimento local no Windows 11 com WSL, Ubuntu 24.04, Docker e VSCode. Estas configurações podem ser utilizadas em ambientes que não estejam controlados com proxy web ou excessivas regras de segurança. Não recomendado para Embrapa Sede e/ou equipamentos com poucos recursos computacionais.

Todos os boilerplates e demais soluções desta plataforma podem ser executadas também diretamente no Windows 11 sem o WSL bastando apenas ter as soluções dotnet e BD Postgres instaladas e/ou o Docker Desktop para Windows.

Pré-Requisitos

1. Windows 11

2. WSL v2
   • Para instalar apenas o WSL no Windows (sem Linux):
     1. Abra o PowerShell:
        • Clique no botão Iniciar
        • Digite PowerShell
        • Clique com o botão direito em “PowerShell” e selecione “Executar como administrador”
     2. Instale o WSL (sem distribuição) executando:

         wsl --install --no-distribution
        

     3. Reinicie o computador se solicitado.
     4. Verifique se o WSL foi instalado:

         wsl --list --verbose
        

     5. Se aparecer “Nenhuma distribuição instalada”, está tudo certo!
3. PowerShell 7.5 ou superior
   • Para instalar o PowerShell 7.5 ou superior:
     1. Pelo site oficial:
        • Acesse: https://github.com/PowerShell/PowerShell
        • Baixe o instalador para Windows (arquivo .msi) correspondente à sua arquitetura (x64 ou ARM).
        • Execute o instalador e siga as instruções na tela.
          1. Ou via linha de comando usando o winget (recomendado para Windows 11):

               winget install --id Microsoft.Powershell --source winget
             

          2. Após a instalação, verifique a versão instalada abrindo o PowerShell e digitando:

               $PSVersionTable.PSVersion
             

     2. Certifique-se de que a versão exibida seja 7.5 ou superior.

Configurações Manuais

1. Instalar o WSL com Ubuntu 24.04 via PowerShell

A. Abrir PowerShell como administrador

Menu Iniciar → clique direito em PowerShell → “Executar como administrador”

B. Listar distribuições disponíveis

wsl --list --online

C. Instalar Ubuntu 24.04

wsl --install -d Ubuntu-24.04

D. Verificar versão do WSL

wsl -l -v

E. Definir WSL 2 como padrão (opcional)

wsl --set-default-version 2

F. Abrir Ubuntu 24.04 e criar seu usuário Linux

---

2. Instalar Docker CE e Docker Compose no Ubuntu 24.04

A. Atualizar pacotes e instalar dependências

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

B. Adicionar repositório do Docker

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo \"${UBUNTU_CODENAME:-$VERSION_CODENAME}\") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

C. Instalar Docker CE e Docker Compose

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

D. Verificar instalações

sudo docker run hello-world

E. Configurar Docker para uso sem sudo (opcional)

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

F. Verificar versão do Docker e Docker Compose

docker --version
docker compose version

---

3. Instalar Git no Ubuntu 24.04 (WSL)

A. Atualizar pacotes e instalar Git

sudo apt-get update
sudo apt-get install git

B. Verificar instalação

git --version

C. Configurar Git (obrigatório para commits)

git config --global user.name "Seu Nome"
git config --global user.email "seu.email@exemplo.com"

D. Verificar configuração

git config --list

---

4. Instalar Visual Studio Code no Windows

A. Baixar e instalar

Site oficial: https://code.visualstudio.com

Durante a instalação, marque a opção “Adicionar ao PATH”

B. Instalar extensões no VS Code

Abrir VS Code → Menu lateral “Extensões” (Ctrl+Shift+X) → Buscar e instalar:

• Remote - WSL
• Dev Containers (Microsoft)
• C# Dev Kit (Microsoft)
• GitHub Copilot

---

5. Testar o Ambiente de Desenvolvimento

A. Abrir o Ubuntu via WSL

B. Instalar o SDK do .NET

Os boilerplates atuais do embrapa4dev (blazorpost e dotnetapi) usam o .NET 10. Seguir as instruções oficiais em: https://learn.microsoft.com/pt-br/dotnet/core/install/linux

dotnet --list-sdks

C. Criar projeto e executar

dotnet new console -o MeuProjeto
cd MeuProjeto
dotnet run

D. Abrir projeto no VS Code

code .

---

Ambiente Pronto!

Parabéns! Agora você possui um ambiente robusto para desenvolvimento .NET, com Docker, VS Code, WSL e Git.

O próximo passo é criar a sua aplicação a partir de um boilerplate: siga o Passo a Passo.