Mudanças entre as edições de "Instruções para instalação do WSL no windows"

De IT's Instruções de Trabalho - FAHOR/CFJL
Ir para navegação Ir para pesquisar
Linha 8: Linha 8:
  
 
[[File:ClipCapIt-250416-132133.PNG|Recursos que devem ser ativados para uso do WSL]]
 
[[File:ClipCapIt-250416-132133.PNG|Recursos que devem ser ativados para uso do WSL]]
 +
 
Marque as seguintes opções:
 
Marque as seguintes opções:
  
Linha 22: Linha 23:
 
Ao término da instalação dos recursos, será solicitada a reinicialização do sistema.
 
Ao término da instalação dos recursos, será solicitada a reinicialização do sistema.
 
Reinicie o computador para que os recursos sejam ativados corretamente e o ambiente esteja pronto para a instalação do '''WSL.
 
Reinicie o computador para que os recursos sejam ativados corretamente e o ambiente esteja pronto para a instalação do '''WSL.
 +
== 2 - Instalando e configurando o WSL 2 e o Ubuntu ==
 +
 +
Após reiniciar o computador, siga os passos abaixo para instalar o WSL 2, a distribuição Ubuntu e aplicar algumas configurações de performance.
 +
 +
=== 2.1 - Atualizar o WSL ===
 +
 +
Abra o '''PowerShell''' como administrador e execute:
 +
 +
<syntaxhighlight lang="powershell">
 +
wsl --update
 +
</syntaxhighlight>
 +
 +
Esse comando garante que você está utilizando a versão mais recente do WSL disponível no sistema.
 +
 +
Em seguida, execute:
  
 
<syntaxhighlight lang="powershell">
 
<syntaxhighlight lang="powershell">
Linha 27: Linha 43:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Ou, se preferir, utilize:
+
ou
  
 
<syntaxhighlight lang="powershell">
 
<syntaxhighlight lang="powershell">
Linha 33: Linha 49:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Certifique-se de que a versão do WSL instalada é a '''versão 2.'''
+
Esses comandos exibem informações sobre a versão do WSL instalada. Verifique se a versão exibida corresponde ao '''WSL 2'''.
  
Caso o WSL ainda não esteja instalado, você pode instalá-lo com o comando abaixo:
+
=== 2.2 - Instalar a distribuição Ubuntu ===
 +
Para instalar a distribuição Ubuntu, execute:
  
 
<syntaxhighlight lang="powershell">
 
<syntaxhighlight lang="powershell">
Linha 41: Linha 58:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Esse comando iniciará o processo de download da distribuição Ubuntu através da Microsoft Store. Após o término do download e instalação, o terminal será iniciado automaticamente com o ambiente do Ubuntu.
+
Aguarde até a conclusão da instalação. A primeira inicialização pode demorar alguns minutos.
 
 
Na primeira inicialização, será necessário aguardar a configuração do ambiente. Em seguida, você será solicitado a criar um nome de usuário e uma senha para a nova conta dentro do Ubuntu (essa conta é separada do usuário do Windows).
 
  
Após a criação do usuário, o ambiente estará pronto para uso, permitindo o acesso ao terminal Linux diretamente pelo Windows via WSL.
+
=== 2.3 - Configurar recursos do WSL (ajustes de performance) ===
  
 +
Você pode limitar a quantidade de memória e núcleos que o WSL 2 utilizará, além de ativar funcionalidades experimentais.
  
== 4 - Configurar recursos do WSL 2 via PowerShell ==
+
Execute os comandos abaixo no PowerShell:
 
 
Com o WSL 2 instalado e a distribuição Ubuntu configurada, é possível ajustar os recursos de hardware alocados para o WSL através do arquivo de configuração `.wslconfig`.
 
 
 
Execute os comandos abaixo no '''PowerShell''' para criar ou adicionar as configurações no arquivo `.wslconfig`, localizado em `C:\Users\SEU_USUARIO\.wslconfig`:
 
  
 
<syntaxhighlight lang="powershell">
 
<syntaxhighlight lang="powershell">
Linha 62: Linha 74:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Essas linhas irão criar (ou complementar, caso o arquivo já exista) o seguinte conteúdo no arquivo `.wslconfig`:
+
Essas configurações serão salvas no arquivo:
  
<syntaxhighlight lang="ini">
+
<code>C:\Users\SEU_USUÁRIO\.wslconfig</code>
[wsl2]
 
memory=8GB
 
processors=3
 
  
[experimental]
+
Você pode editar esse arquivo manualmente no futuro, se quiser ajustar os recursos.
autoMemoryReclaim=dropcache
 
</syntaxhighlight>
 
  
Essa configuração define que:
+
=== 2.4 - Definir usuário padrão como root ===
  
- O WSL 2 poderá usar até **8 GB de RAM**.
+
Para que o usuário root seja o padrão ao iniciar o Ubuntu no WSL, execute:
- Terá acesso a **3 núcleos de CPU**.
 
- O recurso experimental **autoMemoryReclaim** será ativado para melhorar o gerenciamento de memória liberando cache automaticamente.
 
 
 
Após salvar essas configurações, **reinicie o WSL** para que as mudanças entrem em vigor. Você pode fazer isso com o seguinte comando no PowerShell:
 
  
 
<syntaxhighlight lang="powershell">
 
<syntaxhighlight lang="powershell">
wsl --shutdown
+
ubuntu config --default-user root
 
</syntaxhighlight>
 
</syntaxhighlight>
 
Depois disso, ao abrir novamente a distribuição Ubuntu, as novas configurações já estarão aplicadas.
 
 
 
== 5 - Configurar o WSL para usar o usuário root como padrão e ajustar o disco virtual ==
 
 
Agora que o Ubuntu foi instalado e as configurações de hardware foram ajustadas, você pode realizar outras personalizações, como configurar o **usuário root** como padrão ao iniciar o WSL e tornar o **tamanho do disco virtual** dinâmico.
 

Edição das 15h57min de 16 de abril de 2025

Este procedimento tem como objetivo orientar a instalação e configuração do WSL 2 (Windows Subsystem for Linux) em sistemas Windows. Para utilizar o WSL, é necessário seguir alguns passos iniciais.

1 - Habilitando os recursos necessários do Windows

Primeiro, pesquise no Windows por Ativar ou desativar recursos do Windows.

Isso abrirá uma janela com diversas opções que podem ser habilitadas ou desabilitadas.

Recursos que devem ser ativados para uso do WSL

Marque as seguintes opções:

  • Hyper-V
  • Plataforma de Máquina Virtual
  • Plataforma do Hipervisor do Windows
  • Subsistema do Windows para Linux

Após marcar as opções, clique em OK e aguarde enquanto o sistema aplica as alterações.

Ao término da instalação dos recursos, será solicitada a reinicialização do sistema. Reinicie o computador para que os recursos sejam ativados corretamente e o ambiente esteja pronto para a instalação do WSL.

2 - Instalando e configurando o WSL 2 e o Ubuntu

Após reiniciar o computador, siga os passos abaixo para instalar o WSL 2, a distribuição Ubuntu e aplicar algumas configurações de performance.

2.1 - Atualizar o WSL

Abra o PowerShell como administrador e execute:

wsl --update

Esse comando garante que você está utilizando a versão mais recente do WSL disponível no sistema.

Em seguida, execute:

wsl --status

ou

wsl --version

Esses comandos exibem informações sobre a versão do WSL instalada. Verifique se a versão exibida corresponde ao WSL 2.

2.2 - Instalar a distribuição Ubuntu

Para instalar a distribuição Ubuntu, execute:

wsl --install -d Ubuntu

Aguarde até a conclusão da instalação. A primeira inicialização pode demorar alguns minutos.

2.3 - Configurar recursos do WSL (ajustes de performance)

Você pode limitar a quantidade de memória e núcleos que o WSL 2 utilizará, além de ativar funcionalidades experimentais.

Execute os comandos abaixo no PowerShell:

Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "[wsl2]"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "memory=8GB"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "processors=3"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "[experimental]"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "autoMemoryReclaim=dropcache"

Essas configurações serão salvas no arquivo:

C:\Users\SEU_USUÁRIO\.wslconfig

Você pode editar esse arquivo manualmente no futuro, se quiser ajustar os recursos.

2.4 - Definir usuário padrão como root

Para que o usuário root seja o padrão ao iniciar o Ubuntu no WSL, execute:

ubuntu config --default-user root