Guia de instalação do Ruby On Rails [ubuntu, mac e windows]

Neste Guia você vai aprender de forma simples como instalar as dependências para roda o Ruby On Rails + NodeJs + Yarn na sua máquina.

Esse guia de instalação foi adaptado (traduzido e ajustado) do guia de instalação do GO RAILS, então caso você deseje ver a versão oficial em inglês (que possui também instruções para versões mais antigas do ubuntu e mac) acesse: https://gorails.com/setup/windows/10

Vamos lá?

 

Instalando no Ubuntu 21.04

Instalando o Ruby

Primeiro vamos começar instalando algumas dependências do Ruby On Rails.

1 – Para garantir que temos o necessário para dar suporte ao Webpacker (que é dependência do Ruby On Rails) nós vamos instalar o Yarn e o NodeJs, rode no seu terminal:

2 – Agora vamos instalar o RVM (gerenciador de versões do Ruby), rode:

3 – Agora instale o bundle rodando:

 

Configurando o GIT

Vamos usar o Git para nosso sistema de controle de versão, então vamos configurá-lo de acordo com nossa conta Github. Se você ainda não tem uma conta no Github, certifique-se de se registrar.

1 – Rode no console substituindo o “YOUR NAME” pelo seu nome e o “YOUR@EMAIL.com” pelo seu e-mail do GitHub.

2 – A próxima etapa é pegar a chave SSH recém-gerada e adicioná-la à sua conta do Github. Você deve copiar e colar a saída do comando a seguir neste link.

3 – Depois de fazer isso verifique seu deu certo rodando:

4 – Você deve receber uma mensagem semelhante a essa (possivelmente em português)

 

Instalando o Ruby On Rails

1 – Para instala o Ruby On Rails rode:

2 – Para verificar que tudo deu certo rode:

Se você tiver uma saída diferente dessa pode significar que seu ambiente não foi configurado corretamente.

 

Instalando no Windows 10

Agora vamos configurar o ambiente de desenvolvimento Ruby on Rails no Windows 10.

O motivo pelo qual usaremos o “Bash on Ubuntu” no Windows é que ele permite que você execute o Linux em sua máquina Windows. A maioria dos tutoriais e dependências do Ruby on Rails funcionam melhor no Linux, então isso permite 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 o desenvolvimento Ruby on Rails.

Isso só funciona em instalações de 64 bits do Windows. Isso também está em beta, então não será tão robusto quanto rodar uma máquina virtual Linux, mas definitivamente pode fazer o básico bem o suficiente.

 

Instalando o Windows Subsystem para Linux

O Windows 10 permite que você execute vários sistemas operacionais Linux dentro do Windows semelhantes a uma máquina virtual, mas implementados nativamente. Usaremos isso para instalar Ruby e executar nossos aplicativos Rails.

1 – Abra o Powershell como Administrator e rode:

2 – Agora Instale o Ubuntu pela Microsoft Store como na imagem a baixo.

3 – Agora abra o Ubuntu no menu Iniciar ou executando ws no PowerShell ou no prompt de comando. Você deverá configurar um novo usuário para o Ubuntu. Lembre-se dessa senha, pois é a que você usará mais tarde ao instalar pacotes com sudo.

Parabéns! Agora você tem um terminal Ubuntu no Windows. Você usará isso para executar seu servidor Rails e outros processos de desenvolvimento.

 

Instalando o Ruby

Primeiro vamos começar instalando algumas dependências do Ruby On Rails.

1 – Para garantir que temos o necessário para dar suporte ao Webpacker (que é dependência do Ruby On Rails) nós vamos instalar o Yarn e o NodeJs, rode no seu terminal (do ubuntu que você instalou):

2 – Agora vamos instalar o RVM (gerenciador de versões do Ruby), rode:

3 – Agora instale o bundle rodando:

 

 

Configurando o GIT

Vamos usar o Git para nosso sistema de controle de versão, então vamos configurá-lo de acordo com nossa conta Github. Se você ainda não tem uma conta no Github, certifique-se de se registrar.

1 – Rode no console substituindo o “YOUR NAME” pelo seu nome e o “YOUR@EMAIL.com” pelo seu e-mail do GitHub.

2 – A próxima etapa é pegar a chave SSH recém-gerada e adicioná-la à sua conta do Github. Você deve copiar e colar a saída do comando a seguir neste link.

3 – Depois de fazer isso verifique seu deu certo rodando:

4 – Você deve receber uma mensagem semelhante a essa (possivelmente em português)

 

Instalando o Ruby On Rails

1 – Para instala o Ruby On Rails rode:

2 – Para verificar que tudo deu certo rode:

Se você tiver uma saída diferente dessa pode significar que seu ambiente não foi configurado corretamente.

 

 

 

Instalando no MacOS 11.0

Vamos configurar um ambiente de desenvolvimento Ruby on Rails no macOS 11.0 Big Sur.

Versões mais antigas do sistema operacional são em sua maioria compatíveis, portanto, acompanhe o máximo que puder e, em seguida, pesquise no Google por quaisquer problemas que encontrar. Existem muitas pessoas que documentaram soluções para eles.

 

Instalando o ZSH no seu terminal

MacOS Catalina mudou o terminal padrão de Bash para ZSH. Como resultado, iremos adicionar configurações a ~ / .zshrc em vez de~/.bash_profile como usamos no passado.

1 – Você pode mudar manualmente de Bash para ZSH a qualquer momento, executando o seguinte comando:

 

 

Instalando o Homebrew

Primeiro, precisamos instalar o Homebrew. O Homebrew nos permite instalar e compilar pacotes de software facilmente do código-fonte.

O Homebrew vem com um script de instalação muito simples. Quando ele solicitar que você instale as ferramentas CommandLine XCode, diga que sim.

1 – Abra o Terminal e execute o seguinte comando:

 

 

Instalando o Ruby

Agora que temos o Homebrew instalado, podemos usá-lo para instalar o Ruby.

Vamos usar rbenv para instalar e gerenciar nossas versões Ruby.

1 – Execute os seguintes comandos em seu Terminal:

 

 

Configurando o Git

Vamos usar o Git para nosso sistema de controle de versão, então vamos configurá-lo de acordo com nossa conta Github. Se você ainda não tem uma conta no Github, certifique-se de se registrar.

1 – Rode no console substituindo o “YOUR NAME” pelo seu nome e o “YOUR@EMAIL.com” pelo seu e-mail do GitHub.

2 – A próxima etapa é pegar a chave SSH recém-gerada e adicioná-la à sua conta do GitHub. Você deve copiar e colar a saída do comando a seguir neste link.

3 – Depois de fazer isso verifique seu deu certo rodando:

4 – Você deve receber uma mensagem semelhante a essa (possivelmente em português)

 

 

Instalando o Rails

1 – Instalar Rails é tão simples quanto executar o seguinte comando em seu Terminal:

2 – O Rails agora está instalado, mas para usarmos o executável do rails, precisamos rodar o seguinte:

3 – E agora podemos verificar se o Rails está instalado:

 

 

Ajuste final

O Mojave mudou a localização dos arquivos de cabeçalho necessários para compilar extensões C.

1 – Pode ser necessário executar o seguinte comando para instalar o pg, nokogiri ou outras gems que requerem extensões C:

 

2 – Caso o NodeJs e o Yarn não venham instalados no seu MacOS acesse um desses link para realizar a instalação:

a – https://itsromiljain.medium.com/the-best-way-to-install-node-js-npm-and-yarn-on-mac-osx-4d8a8544987a
b – https://gist.github.com/rcugut/46904124d198a9dbd430abe88ebf849b
c – https://tecadmin.net/install-yarn-macos

 

Conclusão

Pronto, você instalou o Ruby On Rails e suas dependências na sua máquina e está pronto(a) para começar a criar seus projetos 🤘

Caso você tenha alguma problema com a instalação acesse a documentação oficial para ver outros caminhos para instalação: https://guides.rubyonrails.org/v5.0/getting_started.html