Exibir código-fonte para Guia rápido do WSL2 + Docker


'''WSL 2 – Windows Subsystem for Linux 2'''


A principal proposta de valor do WSL é que você pode ter Linux E Windows. Como desenvolvedor, isso é bastante atraente, pois você pode desenvolver <br> para ambas as plataformas em ambas as plataformas, mas com apenas uma máquina e sem ter que mudar constantemente de SO.

    • Linux funcionando dentro do Windows como subsistema;
    • Funciona em cima do Virtual Machine Platform;
    • Permite o controle do sistema através de um terminal;
    • Execução do kernel completo do Linux;
    • Compartilhamento completa de chamada do sistema;
    • Melhor desempenho para acesso aos arquivos dentro do Linux.

Requerimentos Mínimos:

    • Windows 10 Home ou Professional;
    • Atualização 20.04.;
    • 4GB de RAM;
    • Virtual Machine Platform;
    • Docker Desktop >= 2.3;
    • Windows Terminal.

Podemos dizer que o WSL 2 tem acesso quase que total ao recursos de sua máquina. Ele tem acesso por padrão:
    • A todo disco rígido.
    • A usar completamente os recursos de processamento.
    • A usar 80% da memória RAM disponível.
    • A usar 25% da memória disponível para SWAP.


----


'''Instalação do WSL 2'''

Pode ser que seu Windows 10 já seja igual ou superior a 20.04, verifique isto acessando o menu de notificações perto do relógio > Todas as configurações > Sistema > Sobre.

'''Etapas de instalação manual'''

'''Etapa 1 – Habilitar o Subsistema do Windows para Linux'''

Execute os seguintes comandos no PowerShell em modo administrador:

''$ dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart<br>
$ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart<br>
''

Abra o PowerShell e digite o comando ''$ wsl'', se não funcionar reinicie sua máquina.

'''Etapa 2 – Baixar o pacote de atualização do kernel do Linux'''

https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

'''Etapa 3 – Definir o WSL 2 como a sua versão padrão'''

A versão 1 do WSL é a padrão no momento, atribua a versão default para a versão 2, assim todas as distribuições Linux instaladas serão já por default da versão 2. Execute o comando com o PowerShell:

''$ wsl --set-default-version 2''

'''Etapa 4 – Instalar a distribuição do Linux de sua escolha'''

Escolha sua distribuição Linux preferida no aplicativo Windows Store, sugerimos o Ubuntu por ser uma distribuição popular e que já vem com várias ferramentas instaladas por padrão.

[[Arquivo:arq1wsl2.png|700px|thumb|nenhum]]


Na página da distribuição, selecione "Obter".

[[Arquivo:arq12wsl2.png|700px|thumb|nenhum]]



'''Etapa 5 – Criando usuário root da instância WSL'''

Ao iniciar o Linux instalado, você deverá criar um nome de usuário que poderá ser o mesmo da sua máquina e uma senha, este será o usuário root da sua instância WSL.<br>
Parabéns, seu WSL2 já está funcionando:

[[Arquivo:arq123wsl2.png|700px|thumb|nenhum]]



'''Etapa 6 – Configurações Opcionais'''

'''Desinstale o Hyper-V'''

Agora que temos o WSL 2 não precisamos mais do Hyper-V, desabilite-o em Painel de Controle > Programas e Recursos (se você tiver instalado o Hyper-V).

'''Alterar a versão do WSL 1 de uma distribuição para a versão 2'''

Se você já tiver o WSL 1 na máquina e acabou de instalar a versão 2, pode-se converter sua distribuição Linux WSL 1 para WSL 2, execute o comando com o PowerShell:

''$ wsl --set-version <distribution name> 2''


'''Etapa 6 – Instalar o Terminal do Windows'''

O Windows Terminal construído pela própria Microsoft que permite rodar terminais em abas, alterar cores e temas, configurar atalhos e muito mais.
Instale-o pelo Windows Store e use estas configurações padrões para habilitar WSL 2, Git Bash e o tema drácula e alguns atalhos.

'''https://github.com/codeedu/wsl2-docker-quickstart/blob/master/windows-terminal-settings.json'''

Para sobrescrever as configurações clique a seta para baixo do lado das abas e em configurações, abrirá as configurações do Windows Terminal, <br>apenas cole o conteúdo do arquivo JSON e salve.

[[Arquivo:arq1234wsl2.png|700px|thumb|nenhum]]


'''Etapa 7 – Definindo Recursos da Máquina''' 

Crie um arquivo chamado '''.wslconfig''' na raiz da sua pasta de usuário (C:\Users\<seu_usuario>) e defina estas configurações:

''[wsl2]<br>
options=metadata,umask=22,fmask=11<br>
memory=8GB<br>
processors=4<br>
swap=2GB''<br>

Para aplicar estas configurações é necessário reiniciar as distribuições Linux, então sugerimos executar no PowerShell o comando: 

''$ wsl –shutdown'' 

Este comando vai desligar todas as instâncias WSL 2 ativas e basta abrir o terminal novamente para usa-la já com as novas configurações.


----


'''Integrar Docker com WSL 2''' <br>

'''Instale o Docker Desktop''' <br>

Baixe neste link: ''https://hub.docker.com/editions/community/docker-ce-desktop-windows'' e instale o Docker Desktop. <br>

[[Arquivo:docker_funcionando_dentro_do_wsl2.png|700px|thumb|nenhum]]

Habilite o Docker dentro do WSL 2 <br>
Clique no ícone do Docker perto do relógio -> Settings -> Settings no topo -> Resources -> WSL Integration. <br>
Habilite Enable integration with my default WSL distro e habilite sua versão Linux. <br>

[[Arquivo:docker1.png|700px|thumb|nenhum]]


[[Arquivo:docker2.png|700px|thumb|nenhum]]


'''Use BuildKit and multi-stage builds''' <br>

Acrescente '''export DOCKER_BUILDKIT=1''' no final do arquivo '''.profile''' do seu usuário do Linux para ganhar mais performance ao realizar builds com Docker.<br> 
Execute o comando '''$ source ~/.profile''' para carregar esta variável de ambiente no ambiente do seu WSL 2.


----


'''Dicas e truques básicos com WSL 2'''

    • A performance do WSL 2 está em se executar tudo dentro do Linux, por isso evite executar seus projetos com ou sem Docker do <br>caminho '''/mnt/c''', pois você perderá performance.

    • Para abrir o terminal do WSL basta digitar o nome da distribuição no menu Iniciar ou executar '''C:\Windows\System32\wsl.exe'''.

    • O sistema de arquivos do Windows 10 é acessível em '''/mnt'''.

    • É possível acessar o sistema de arquivos do Linux pela rede do Windows, digite '''\\wsl$''' no Windows Explorer.

    • É possível acessar uma pasta no Windows Explorer digitando o comando explorer.exe ..

    • É possível abrir uma pasta ou arquivo com o Visual Studio Code digitando o comando '''code .''' ou '''code meu_arquivo.ext'''.

    • Incrivelmente é possível acessar executáveis do Windows no terminal do Linux executando-os com .exe no final (não significa que funcionarão corretamente).

    • Execute o comando wsl -l -v com o PowerShell para ver as versões de Linux instaladas e seu status atual(parado ou rodando).

    • Execute o comando wsl --shutdown com o PowerShell para desligar todas as distribuições Linux que estão rodando no momento<br> (ao executar o comando, as distribuições do Docker também serão 
        desligadas e o Docker Desktop mostrará uma notificação ao lado do relógio perguntando se você quer iniciar as distribuições dele novamente,<br> 
        se você não aceitar terá que iniciar o Docker novamente com o ícone perto do relógio do Windows).

    • Se verificar que o WSL 2 está consumindo muitos recursos da máquina, execute os seguintes comandos dentro do terminal WSL 2 para liberar memória RAM: 
        <br> ''echo 1 | $ sudo tee /proc/sys/vm/drop_caches'' <br> ''echo 3 | $ sudo tee /proc/sys/vm/drop_caches''
      
    • Execute com o PowerShell o comando ''$ wsl --t <distribution name>'' para desligar somente uma distribuição Linux específica.