Como preparar seu ambiente de desenvolvimento no Windows 11

Uma das maiores novidades dos últimos tempos para o sistema Windows foi com toda certeza o Subsistema Windows para Linux, também conhecido como WSL (Windows Subsystem for Linux). Neste artigo vamos aprender a configurar o ambiente de desenvolvimento web utilizando este poderoso recurso.

Usaremos o bash do Ubuntu no Windows 11, pois através do WSL é possível executar o Linux na sua máquina Windows. A maioria das dependências do desenvolvimento web funcionam melhor no Linux, pois foram inicialmente desenvolvidas para o mundo Unix. Portanto, ao usar esse recurso, é possível que você obtenha o melhor dos dois mundos. Uma máquina Windows para o seu dia-a-dia de trabalho, e um subsistema Linux para desenvolvimento Ruby on Rails.

Antes de prosseguir, certifique-se que seu Windows 11 está atualizado e o recurso de Vitualização via Hardware está habilitado

Habilitar o WSL2

Abra o Powershell como administrador e digite os seguintes comandos:

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

Ao finalizar a execução, será necessário baixar o Ubuntu através da Microsoft Store.

Agora abra o Ubuntu no menu Iniciar. Você precisará configurar um novo usuário para o Ubuntu. Lembre-se dessa senha, pois ela será necessária posteriormente sempre que for necessário executar o comando sudo.

Pronto! Agora você tem um terminal Ubuntu no Windows. Você usará isso para executar o suas aplicações e outros processos de desenvolvimento.

Se pretende desenvolver em Ruby on Rails, basta seguir o tutorial a seguir:

Instalando as dependências

sudo apt-get update
sudo apt-get install git-core zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

A seguir instalaremos Ruby usando um gerenciador de versões chamado ASDF.

A razão pela qual usamos ASDF em vez de rbenv, rvm ou outros é que o ASDF também pode gerenciar outras linguagens como Node.js.

Para garantir que tenhamos tudo necessário para o suporte a Compilação de Asssets (Javascript e CSS) no Rails, vamos precisar instalar o Node.js e o Yarn, então precisaremos instala-lo.

Instalar o asdf é um processo simples de duas etapas. Primeiro você instala o asdf e depois o adiciona ao seu shell:

cd
git clone https://github.com/excid3/asdf.git ~/.asdf
echo '. "$HOME/.asdf/asdf.sh"' >> ~/.bashrc
echo '. "$HOME/.asdf/completions/asdf.bash"' >> ~/.bashrc
echo 'legacy_version_file = yes' >> ~/.asdfrc
echo 'export EDITOR="code --wait"' >> ~/.bashrc
exec $SHELL

Então podemos instalar plugins asdf para cada linguagem que vamos usar. Para Rails, podemos instalar Ruby e Node.js para nosso frontend.

asdf plugin add ruby
asdf plugin add nodejs

Para instalar Ruby e definir a versão padrão, executaremos os seguintes comandos:

asdf install ruby 3.3.1
asdf global ruby 3.3.1

# Atualiza Rubygems para a versão mais recente
gem update --system

Confirme se a versão padrão do Ruby corresponde à versão que você acabou de instalar.

which ruby
#=> /home/usuario/.asdf/shims/ruby
ruby -v
#=> 3.3.1

Agora, podemos instalar o Node.js mais recente para trabalhar com Javascript e CSS em nossos projetos Rails:

asdf install nodejs 20.12.2
asdf global nodejs 20.12.2

which node
#=> /home/usuario/.asdf/shims/node
node -v
#=> 20.12.2

# Instale o yarn para usar o jsbundling/cssbundling ou webpack no Rails
npm install -g yarn

Configurando o Git

Usaremos o Git como sistema de versionamento, então vamos configurá-lo para vincular o computador à nossa conta do Github. Se você ainda não tem uma conta no Github, certifique-se de se registrar. Será útil para o futuro.

Substitua com seu nome e e-mail utilizado em sua conta do GitHub, nas etapas a seguir:

git config --global color.ui true
git config --global user.name "SEU NOME"
git config --global user.email "[email protected]"
ssh-keygen -t ed25519 -C "[email protected]"

A próxima etapa é copiar a chave pública SSH recém-gerada e adicioná-la à sua conta do Github. Você deseja copiar e colar a saída do comando a seguir e colá-la aqui.

Instalando o Rails

gem install rails -v 7.1.3.2

Agora que instalou o Rails, você pode executar o comando rails -v para garantir que tudo esteja instalado corretamente:

rails -v
# Rails 7.1.3.2

Configurando o PostgreSQL

sudo apt install postgresql libpq-dev
sudo service postgresql start

Você precisará iniciar o postgresql sempre que inciar seu ambiente WSL.

A instalação do postgres não configura um usuário para você, então você precisará seguir estas etapas para criar um usuário com permissão para criar bancos de dados. Sinta-se à vontade para substituir pelo seu nome de usuário.

sudo -u postgres createuser usuario -s
sudo -u postgres psql
postgres=# \password usuario
postgres=# \q

Etapas Finais

Vamos criar sua primeira aplicação Rails no Windows!

rails new minha_aplicacao -d postgresql

# Em seguida, vá para o diretório do aplicativo
cd minha_aplicacao

# Modifique o arquivo config/database.yml para conter o nome de usuário/senha que você especificou.

# Crie o banco de dados
rails db:create

rails server

Agora você pode visitar http://localhost:3000 para visualizar seu novo projeto!

Configurando o VS Code

Instale o VS Code no Windows e instale a extensão WSL. Isso permitirá que você edite o código no Windows, mas execute comandos e extensões no WSL. Leia mais sobre Desenvolvimento com WSL.

Até a próxima!