Instalando o WSL no Windows

No universo do desenvolvimento e da ciência de dados, é comum encontrarmos ferramentas, tutoriais e ambientes de produção (servidores em nuvem, por exemplo) otimizados ou primordialmente desenhados para Linux. Até mesmo o seu Google Colab, que você tanto utiliza, roda em Linux! (Teste você mesmo: digite cat /etc/os-release em uma célula do Colab e veja o Ubuntu 22.04 aparecer).

Se você é um usuário Windows, já sentiu que precisa de um “jeitinho” extra para instalar certas bibliotecas, compilar projetos ou seguir guias que parecem mais diretos em Linux? Ou que seu ambiente local não reflete fielmente onde suas aplicações vão rodar? O WSL surge como uma solução elegante para superar esses obstáculos, trazendo um ambiente Linux genuíno e de alto desempenho diretamente para o seu Windows.

Este guia prático detalha a instalação do Windows Subsystem for Linux (WSL), que possibilita a execução de um ambiente Linux completo e integrado diretamente no seu Windows. Essa integração é particularmente vantajosa para desenvolvedores e cientistas de dados, simplificando o acesso a diversas ferramentas e utilitários Linux.

AvisoPré-requisitos

Antes de iniciar a instalação do WSL, é crucial verificar se o seu sistema atende aos requisitos necessários:

  1. Verificar a Versão do Windows:

    • Pressione Windows + R.
    • Digite winver na janela que aparecer e pressione Enter.
    • Uma janela mostrará a versão e o número da build do seu Windows.

  2. Requisitos de Versão:

    Após verificar sua versão, confirme se ela atende aos requisitos:

    • Para o comando de instalação simplificada (Opção 1) do WSL:

      Windows 10 versão 2004 ou superior (Build 19041 e superior) ou qualquer versão do Windows 11.

    • Para instalações manuais (Opção 2) do WSL:

      Windows 10 versão 1903 ou superior (Build 18362.1049 ou superior) para sistemas x64.

      Windows 10 versão 2004+ (Build 19041+) para sistemas ARM64.

Opção 1: Instalação Simplificada

Se você está executando o Windows 10 versão 2004 (Build 19041) ou superior, ou o Windows 11, pode instalar tudo o que é necessário para o WSL com um único comando.

  1. Abra o PowerShell ou o Prompt de Comando como Administrador:

    • Clique no menu Iniciar, digite “PowerShell” ou “Prompt de Comando”.
    • Clique com o botão direito no resultado e selecione “Executar como administrador”.

  2. Execute o comando de instalação:

    Digite o seguinte comando e pressione Enter:

    wsl --install

    Este comando fará o seguinte:

    • Habilitará os recursos opcionais necessários do WSL e da Plataforma de Máquina Virtual.
    • Baixará e instalará a versão mais recente do kernel do Linux.
    • Definirá o WSL2 como padrão.

  3. Reinicie o Computador:

    Após a conclusão do comando, reinicie sua máquina para que as alterações entrem em vigor.

  4. Instalação da Distribuição Linux:

    Após a reinicialização, siga as instruções na seção Instalando uma Distribuição Linux para instalar o Ubuntu ou outra distribuição de sua preferência.

Opção 2: Instalação Manual

Se você estiver executando uma versão mais antiga do Windows 10 (mas ainda compatível com WSL2, como a versão 1903 ou 1909 com as builds corretas) ou se o comando wsl --install não funcionar, siga estas etapas manuais:

Passo 1: Habilitar os Recursos Necessários do Windows

Este passo envolve habilitar dois recursos essenciais: o “Subsistema do Windows para Linux” e a “Plataforma de Máquina Virtual”. Ambos podem ser habilitados de duas formas:

  • Via Painel de Controle (Recomendado):

    1. Na barra de pesquisa do Windows, digite “Ativar ou desativar recursos do Windows” e selecione a opção correspondente.
    2. Na janela “Recursos do Windows” que se abrir, localize e marque as seguintes caixas:
      • “Subsistema do Windows para Linux”
      • “Plataforma de Máquina Virtual”
    3. Clique em “OK”.

  • Via PowerShell: Abra o PowerShell como Administrador e execute os seguintes comandos:

    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Passo 2: Reiniciar o Computador

É crucial reiniciar o seu computador neste momento para concluir a instalação desses componentes e aplicar as alterações.

Passo 3: Baixar e Instalar o Pacote de Atualização do Kernel do Linux

  1. Baixe o pacote de atualização do kernel do Linux mais recente para sistemas x64 através deste link da Microsoft. (Para ARM64, use o link apropriado na documentação da Microsoft).
  2. Execute o instalador baixado (arquivo .msi). Siga as instruções na tela (geralmente, apenas “Next” e “Finish”).

Passo 4: Definir o WSL2 como sua Versão Padrão

Abra o PowerShell (não precisa ser como administrador para este comando) e execute:

wsl --set-default-version 2

Isso garantirá que quaisquer novas distribuições Linux que você instalar usem o WSL2 por padrão.

Instalando uma Distribuição Linux

Com o WSL2 configurado, você precisa instalar uma distribuição Linux.

Recomendamos a instalação do Ubuntu, que pode ser feita através do terminal.

Abra o PowerShell ou o Prompt de Comando e execute o seguinte comando para listar as distribuições disponíveis:

wsl --list --online

Após identificar o nome da distribuição desejada, instale-a com o comando:

wsl --install -d <NomeDaDistribuicao>

Substitua <NomeDaDistribuicao> pelo nome da distribuição. Por exemplo, para instalação do Ubuntu:

wsl --install -d Ubuntu

Configurando sua Distribuição Linux:

  • Após a instalação, inicie sua nova distribuição Linux digitando wsl no PowerShell ou Prompt de Comando.
  • Na primeira execução, você será solicitado a criar um nome de usuário e uma senha para essa distribuição. Lembre-se dessas credenciais.

Verificando a Instalação e Versão do WSL

Para verificar as distribuições Linux instaladas e a versão do WSL que cada uma está usando, abra o PowerShell ou Prompt de Comando e digite:

wsl -l -v

Isso listará suas distribuições. A coluna “VERSION” deve mostrar 2 para as distribuições configuradas com WSL2. Se alguma estiver como versão 1 e você desejar convertê-la para WSL2 (após ter instalado o kernel e habilitado a Plataforma de Máquina Virtual), use o comando:

wsl --set-version <NomeDaDistribuicao> 2

Dicas

DicaConfigurando o Terminal do Windows

O Windows Terminal é um aplicativo moderno e personalizável que permite gerenciar múltiplos terminais em uma única janela. A partir de agora, será através dele que interagiremos com o WSL. Aqui está como configurá-lo:

  1. Instale o Windows Terminal pela Microsoft Store

  2. Para adicionar à barra de tarefas (opcional):

    • Clique com o botão direito no ícone do Windows Terminal
    • Selecione “Fixar na barra de tarefas”

  3. Para configurar o Ubuntu WSL como terminal padrão:

    • Abra o Windows Terminal
    • Clique na seta para baixo ao lado da aba
    • Selecione “Configurações”
    • Na seção “Iniciar”, altere o “Perfil padrão” para “Ubuntu”

  4. Para aplicar o tema Campbell (recomendado):

    • Nas configurações, vá para “Aparência”
    • Em “Tema”, selecione “Campbell”
    • Você também pode personalizar cores, fontes e outros aspectos visuais

Para instalar temas adicionais, você pode usar o Oh My Posh ou o Windows Terminal Themes.

Conclusão

Parabéns! Se você seguiu os passos deste guia, o WSL2 deve estar instalado e funcionando no seu Windows. Ter o WSL2 configurado abre um leque de possibilidades, especialmente para desenvolvimento de software e ciência de dados, permitindo que você utilize ferramentas e workflows baseados em Linux de forma integrada ao seu ambiente Windows.

Recursos Adicionais