Mudanças entre as edições de "Instruções para instalação do WSL no windows"
| (13 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 1: | Linha 1: | ||
| − | Este procedimento tem como objetivo orientar a instalação e configuração do '''WSL | + | Este procedimento tem como objetivo orientar a instalação e configuração do '''WSL (Windows Subsystem for Linux)''' em sistemas Windows. |
Para utilizar o '''WSL''', é necessário seguir alguns passos iniciais. | Para utilizar o '''WSL''', é necessário seguir alguns passos iniciais. | ||
== Habilitando os recursos necessários do Windows == | == Habilitando os recursos necessários do Windows == | ||
| − | Primeiro, pesquise | + | Primeiro, pesquise por '''Ativar ou desativar recursos do Windows''' no menu iniciar do Windows. |
Isso abrirá uma janela com diversas opções que podem ser habilitadas ou desabilitadas. | Isso abrirá uma janela com diversas opções que podem ser habilitadas ou desabilitadas. | ||
| Linha 23: | 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. | ||
| − | == Instalando e configurando o WSL | + | == Instalando e configurando o WSL e o Ubuntu == |
| − | Após reiniciar o computador, siga os passos abaixo para instalar o WSL | + | Após reiniciar o computador, siga os passos abaixo para instalar o WSL, a distribuição Ubuntu e aplicar algumas configurações de performance. |
| − | === | + | === Atualizar o WSL === |
| − | Abra o '''PowerShell''' | + | Abra o '''PowerShell''' e execute: |
<syntaxhighlight lang="powershell"> | <syntaxhighlight lang="powershell"> | ||
| Linha 51: | Linha 51: | ||
Esses comandos exibem informações sobre a versão do WSL instalada. Verifique se a versão exibida corresponde ao '''WSL 2'''. | Esses comandos exibem informações sobre a versão do WSL instalada. Verifique se a versão exibida corresponde ao '''WSL 2'''. | ||
| − | === | + | === Instalar a distribuição Ubuntu === |
Para instalar a distribuição Ubuntu, execute: | Para instalar a distribuição Ubuntu, execute: | ||
| Linha 60: | Linha 60: | ||
Aguarde até a conclusão da instalação. A primeira inicialização pode demorar alguns minutos. | Aguarde até a conclusão da instalação. A primeira inicialização pode demorar alguns minutos. | ||
| − | === | + | === Configurar recursos do WSL (ajustes de performance) === |
| − | Você pode limitar a quantidade de memória e núcleos que o WSL | + | Você pode limitar a quantidade de memória e núcleos que o WSL utilizará, além de ativar funcionalidades experimentais. |
| − | + | Ainda no PowerShell execute os comandos abaixo : | |
<syntaxhighlight lang="powershell"> | <syntaxhighlight lang="powershell"> | ||
| Linha 80: | Linha 80: | ||
Você pode editar esse arquivo manualmente no futuro, se quiser ajustar os recursos. | Você pode editar esse arquivo manualmente no futuro, se quiser ajustar os recursos. | ||
| − | === | + | === Definir usuário padrão como root === |
| − | + | Agora que o Ubuntu foi baixado corretamente, execute o comando abaixo para que o usuário root seja o padrão ao iniciar o Ubuntu no WSL. | |
<syntaxhighlight lang="powershell"> | <syntaxhighlight lang="powershell"> | ||
| Linha 90: | Linha 90: | ||
Isso evita a criação de usuário e senha na primeira inicialização, e é útil para ambientes de teste e desenvolvimento. | Isso evita a criação de usuário e senha na primeira inicialização, e é útil para ambientes de teste e desenvolvimento. | ||
| − | === | + | === Reiniciar o WSL === |
Após todas as configurações, reinicie o WSL com o comando: | Após todas as configurações, reinicie o WSL com o comando: | ||
| Linha 100: | Linha 100: | ||
Isso aplica as alterações realizadas no arquivo `.wslconfig`. | Isso aplica as alterações realizadas no arquivo `.wslconfig`. | ||
| − | == | + | === Tornar o disco virtual do WSL dinâmico (sparse) === |
| − | + | Por padrão, o WSL mantém o tamanho do disco virtual fixo. Com a opção '''sparse''', o espaço em disco é liberado automaticamente quando arquivos são removidos. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | Por padrão, o WSL mantém o tamanho do disco virtual fixo. Com a opção | ||
Execute o seguinte comando no PowerShell: | Execute o seguinte comando no PowerShell: | ||
| Linha 119: | Linha 112: | ||
Esse comando permite que o disco virtual da distribuição Ubuntu use alocação dinâmica de espaço. | Esse comando permite que o disco virtual da distribuição Ubuntu use alocação dinâmica de espaço. | ||
| − | === | + | == Acessando o WSL == |
| + | Para abrir o WSL, basta pesquisar por WSL no menu Iniciar do Windows e abrir o aplicativo mostrado abaixo. | ||
| + | |||
| + | [[File:ClipCapIt-250416-161543.PNG|center|Abrindo o WSL através da pesquisa do Windows]] | ||
| + | |||
| + | Isso abrirá um terminal do Ubuntu. | ||
| + | |||
| + | === Definindo o Usuário e a Senha === | ||
| + | |||
| + | Na primeira vez que você acessar o WSL, pode ser solicitado para criar um '''usuário UNIX''' e definir uma '''senha'''. O nome do usuário será sugerido automaticamente com base no nome de usuário do Windows, mas você pode alterá-lo, caso deseje. | ||
| + | |||
| + | Depois de inserir e confirmar a senha, o Ubuntu será inicializado e você poderá começar a usar o terminal para executar comandos Linux. | ||
| − | + | === Utilizando o Terminal do WSL === | |
| + | |||
| + | Para garantir que o WSL funcione corretamente com o Docker e ofereça suporte a permissões de arquivos do Windows, é necessário criar o arquivo de configuração '''/etc/wsl.conf''' com as opções abaixo: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
{ | { | ||
| + | echo "[automount]"; | ||
| + | echo "options = \"metadata\""; | ||
| + | echo "[boot]"; | ||
| + | echo "command=\"service docker start\""; | ||
| + | } > /etc/wsl.conf | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | Esse comando permite editar arquivos do sistema, como o /etc/wsl.conf. | ||
| + | |||
| + | Observação: caso o usuário não esteja com permissões de superusuário (root) e ao executar o comando ocorra a mensagem permission denied, será necessário obter privilégios de root. Para isso, utilize o comando: | ||
| + | |||
| + | <syntaxhighlight lang="bash"> sudo su </syntaxhighlight> | ||
| + | |||
| + | |||
| + | Após essa configuração, atualize a lista de pacotes do sistema com o seguinte comando: | ||
| + | |||
| + | <syntaxhighlight lang="bash"> apt-get update -y </syntaxhighlight> | ||
| + | Esse comando atualiza os índices de pacotes disponíveis para instalação, garantindo que você tenha acesso às versões mais recentes dos softwares disponíveis nos repositórios do Ubuntu. | ||
Edição atual tal como às 09h46min de 17 de abril de 2025
Este procedimento tem como objetivo orientar a instalação e configuração do WSL (Windows Subsystem for Linux) em sistemas Windows. Para utilizar o WSL, é necessário seguir alguns passos iniciais.
Habilitando os recursos necessários do Windows
Primeiro, pesquise por Ativar ou desativar recursos do Windows no menu iniciar do Windows.
Isso abrirá uma janela com diversas opções que podem ser habilitadas ou desabilitadas.
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.
Instalando e configurando o WSL e o Ubuntu
Após reiniciar o computador, siga os passos abaixo para instalar o WSL, a distribuição Ubuntu e aplicar algumas configurações de performance.
Atualizar o WSL
Abra o PowerShell 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.
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.
Configurar recursos do WSL (ajustes de performance)
Você pode limitar a quantidade de memória e núcleos que o WSL utilizará, além de ativar funcionalidades experimentais.
Ainda no PowerShell execute os comandos abaixo :
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.
Definir usuário padrão como root
Agora que o Ubuntu foi baixado corretamente, execute o comando abaixo para que o usuário root seja o padrão ao iniciar o Ubuntu no WSL.
ubuntu config --default-user root
Isso evita a criação de usuário e senha na primeira inicialização, e é útil para ambientes de teste e desenvolvimento.
Reiniciar o WSL
Após todas as configurações, reinicie o WSL com o comando:
wsl --shutdown
Isso aplica as alterações realizadas no arquivo `.wslconfig`.
Tornar o disco virtual do WSL dinâmico (sparse)
Por padrão, o WSL mantém o tamanho do disco virtual fixo. Com a opção sparse, o espaço em disco é liberado automaticamente quando arquivos são removidos.
Execute o seguinte comando no PowerShell:
wsl --manage Ubuntu --set-sparse true
Esse comando permite que o disco virtual da distribuição Ubuntu use alocação dinâmica de espaço.
Acessando o WSL
Para abrir o WSL, basta pesquisar por WSL no menu Iniciar do Windows e abrir o aplicativo mostrado abaixo.
Isso abrirá um terminal do Ubuntu.
Definindo o Usuário e a Senha
Na primeira vez que você acessar o WSL, pode ser solicitado para criar um usuário UNIX e definir uma senha. O nome do usuário será sugerido automaticamente com base no nome de usuário do Windows, mas você pode alterá-lo, caso deseje.
Depois de inserir e confirmar a senha, o Ubuntu será inicializado e você poderá começar a usar o terminal para executar comandos Linux.
Utilizando o Terminal do WSL
Para garantir que o WSL funcione corretamente com o Docker e ofereça suporte a permissões de arquivos do Windows, é necessário criar o arquivo de configuração /etc/wsl.conf com as opções abaixo:
{
echo "[automount]";
echo "options = \"metadata\"";
echo "[boot]";
echo "command=\"service docker start\"";
} > /etc/wsl.conf
Esse comando permite editar arquivos do sistema, como o /etc/wsl.conf.
Observação: caso o usuário não esteja com permissões de superusuário (root) e ao executar o comando ocorra a mensagem permission denied, será necessário obter privilégios de root. Para isso, utilize o comando:
sudo su
Após essa configuração, atualize a lista de pacotes do sistema com o seguinte comando:
apt-get update -y
Esse comando atualiza os índices de pacotes disponíveis para instalação, garantindo que você tenha acesso às versões mais recentes dos softwares disponíveis nos repositórios do Ubuntu.