Tutorial de Instalação para Rails Girls

Criado por Katie Ots, site da Katie

Traduzido por Marcela Oliveira, @magaeu

Tempo previsto: 5min ativo / 15-30min passivo

Para construir apps e outras coisas com Ruby on Rails, precisamos configurar alguns softwares e o ambiente de desenvolvimento em seu computador.

Siga as instruições para seu sistema operacional (SO). Se você tiver algum problema, não entre em pânico. Avise-nos e vamos resolver juntos.


Instalação para macOS

1. Vamos checar a versão do seu sistema operacional.

Clique no menu Apple e escolha About this Mac.

Apple menu

2. Na janela você irá encontrar a versão do seu sistema operacional.

Se a versão do seu sistema começa com 10.6, 10.7, 10.8, 10.9, 10.10 ou 10.11, esse é o tutorial exato para você. Caso seja outra versão, podemos configurar sua máquina durante o evento.

About this Mac dialog

3a. Se a versão do seu OS X/macOS é igual ou maior que 10.9:

Se o número da sua versão começa com 10.9, 10.10 ou 10.11, siga os passos abaixo. Vamos instalar o homebrew e rbenv.

3a1. Instalação via terminal por linha de comando:

xcode-select --install

3a2. Instalar Homebrew:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3a3. Instalar rbenv:

brew update
brew install rbenv ruby-build
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
echo 'export PATH="$HOME/.rbenv/shims:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

3a4. Instalar Ruby com rbenv:

Você pode encontrar a versão mais recente do Ruby pelo comando “rbenv install -l”.

rbenv install 2.6.4

Se aparecer o erro OpenSSL::SSL::SSLError: … : certificate verify failed, tente dessa maneira:

brew install curl-ca-bundle
cp /usr/local/opt/curl-ca-bundle/share/ca-bundle.crt `ruby -ropenssl -e 'puts OpenSSL::X509::DEFAULT_CERT_FILE'`

3a5. Configurar versão padrão do Ruby:

rbenv global 2.6.4

3a6. Instalar Rails:

gem install rails --no-document

3b. Se a versão do seu OS X/macOS é 10.6, 10.7, ou 10.8:

Faça download do RailsInstaller para a versão do seu macOS:

Dê um duplo clique no arquivo baixado e ele será descompactado no diretório atual. Dê um duplo clique no arquivo descompactado RailsInstaller-1.0.4-osx-10.7.app ou RailsInstaller-1.0.4-osx-10.6.app e siga as instruções. O arquivo README será aberto com Rails Installer macOS no topo. Favor IGNORAR as instruções desse arquivo.

Se a versão do Rails não for a mais recente, você pode atualizá-la via terminal:

gem update rails --no-document

4. Instalar yarn

brew install yarn

Se você precisa de mais informações para instalação do yarn, confira a documentação de instalação do yarn

5. Instalar editor de texto

Para esse workshop recomendamos o editor de texto Atom.

Se você estiver usando macOS 10.7 ou versões anteriores, você pode utilizar outro editor Sublime Text 2.

6. Atualizar seu navegador

Acesse whatbrowser.org e atualize seu navegador, caso não tenha a versão mais recente.

7. Verificar o ambiente

Para ter certeza que tudo funciona bem crie uma aplicação via terminal:

rails -v

Deverá mostrar Rails 6.0.0(ou uma versão superior).

rails new myapp
rails cd myapp
rails server

Vá para http://localhost:3000 no seu navegador, você verá a página ‘Yay! You’re on Rails!’.

Parabéns, seu ambiente de desenvolvimento Ruby on Rail está pronto!

INSTRUTOR(A): Recomendamos verificar o procedimento executando o comando scaffold e adicionando dados com a página gerada para assegurar que está tudo funcionando. Também remova o app de teste myapp para ter certeza que ninguém está na pasta errada, seguindo as etapas do workshop.


Instalação para Windows

Para instalar o Rails for Windows, precisamos instalar Ruby e várias ferramentas de suporte, como Git, Node.js e SQLite. Siga as etapas abaixo para instalar essas ferramentas no seu computador. Ao concluir essas etapas, você terá um aplicação Rails em execução no seu computador.

Durante estas etapas, solicitaremos que você abra e feche o prompt de comando do Windows de vez em quando. Pode ser o aplicativo “Prompt de Comando” ou “Powershell” (dependendo do seu computador). Pedimos que você feche e abra novamente, porque quando o prompt de comando é iniciado, ele recarrega no seu ambiente. Quando instalamos um novo aplicativo, o ambiente não é atualizado automaticamente no prompt de comando. Para testar se a instalação foi bem-sucedida, precisamos reiniciar o prompt de comando e carregar o novo ambiente.

1. Instalando Ruby

2. Instalando Git

3. Instalando Node.js

node --version

3a. Instalando yarn

yarn --version

4. Instalando SQLite

sqlite3 --version

5. Instalando o Rails

gem install rails bundler --no-document
rails --version

Se você tiver algum problema durante esta etapa, verifique a parte de Possíveis erros para obter possíveis soluções.

6. Instalar um editor de texto

Para esse workshop recomendamos o editor de texto Atom.

Se você estiver usando o Windows Vista ou versões anteriores, poderá usar outro editor, como por exemplo Sublime Text 2. Apenas garanta que você não esteja confundindo o prompt de comando com o editor de texto: altere o tema do editor, escolhendo uma das seguintes opções: “iPlastic”, “Slush & Poppies”, or “Zenburnesque”.

7. Verificando o ambiente

Para ter certeza que tudo funciona bem crie uma aplicação via terminal:

rails new myapp
cd myapp
rails server

Vá para http://localhost:3000 no seu navegador, você deverá ver a página ‘Yay! You’re on Rails!’. Parabéns!

Se você tiver algum problema durante esta etapa, verifique a parte de Possíveis erros para obter possíveis soluções.

Instrutor(a): Recomendamos verificar o comando scaffold e inserir dados com a página gerada com os instrutores(as) para garantir que tudo esteja funcionando. Além disso: remova o aplicativo de teste myapp para garantir que ninguém esteja trabalhando na pasta errada, seguindo as etapas do workshop.


Instalação para Linux

Para instalar o ambiente de Ruby on Rails você deve apenas copiar a linha abaixo para sua distribuição Linux (Ubuntu ou Fedora), e colar no Terminal e pressionar Enter. Aproveite o texto que aparece na tela; irá levar algum tempo para o processo acabar. Nesse meio tempo, encorajamos você a pegar uma bebida refrescante antes de comecar.

1. Instalar Yarn

Se você precisa de mais informações para instalação do yarn, confira a documentação de instalação do yarn

Para Ubuntu:

sudo apt-get install curl
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install yarn

Para Fedora:

curl -sL https://rpm.nodesource.com/setup_12.x | bash -
curl --silent --location https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo yum install yarn

2. Instalar Rails

Para Ubuntu

bash < <(curl -sL https://raw.github.com/railsgirls/installation-scripts/master/rails-install-ubuntu.sh)

Se você for usar a instalação do RVM com gnome-terminal, você provavelmente vai precisar mudar suas configurações padrões antes de começar a usar a versão correta do Ruby on Rails. Descubra como: Documentação do RVM.

Para Fedora

bash < <(curl -sL https://raw.github.com/railsgirls/installation-scripts/master/rails-install-fedora.sh)

Para ter certeza que tudo funciona bem crie uma aplicação via terminal:

rails new myapp

3. Instalar editor de texto

Para esse workshop recomendamos o editor de texto Sublime Text

4. Atualizar seu navegador (browser)

Acesse whatbrowser.org e atualize seu navegador, caso não tenha a versão mais recente.

Parabéns, seu ambiente de desenvolvimento Ruby on Rail está pronto!


Utilização da Máquina Virtual

Ao invés de instalar todas as ferramentas em seu computador, você pode configurar um ambiente de desenvolvimento em uma Máquina Virtual. Favor, verifique os deltalhes aqui.


Utilização de Serviço em Nuvem

Ao invés de instalar Ruby on Rails e o editor em seu computador, você pode utilizar um webservice para desenvolvimento. Tudo que precisa é um navegador e conexão com a internet. Esse tutorial explica como utilizar o codenvy.io. Se você utilizar outro serviço, talvez eles utilizem outra nomeclatura, como por exemplo ‘workspace’ ao invés de ‘box’, mas o processo é geralmente bem parecido.

1. Atualizar seu navegador (browser)

Se você utiliza Internet Explorer, recomendamos instalar o Firefox ou Google Chrome.

Acesse whatbrowser.org e atualize seu navegador, caso não tenha a versão mais recente.

2. Criar uma conta

Acesse codenvy.io e crie sua conta de graça.

3. Configure seu workspace de desenvolvimento Ruby on Rails

O Ruby on Rails Workspace possui pré-instalado todo o software que nós precisamos para o workshop. Para criar um workspace, logue em codenvy.io e clique em ‘Dashboard’. Se nenhum foi criado, o botão ‘New Workspace’ irá aparecer.

Na tela ‘New workspace’, algumas configurações tem que ser feitas.

4. Encontre e reinicie seu workspace

5. Codificar com sua box de desenvolvimento

Possíveis erros durante a instalação

Gem::RemoteFetcher error

Se você ver este erro ao executar rails new railsgirls ou gem update rails:

Gem::RemoteFetcher::FetchError: SSL_connect returned=1 errno=0 state=SSLv3 read
server certificate B: certificate verify failed (https://rubygems.org/gems/i18n-0.6.11.gem)

Isso significa que você possui uma versão mais antiga do Rubygems e precisará atualizá-la manualmente. Primeiro verifique sua versão atual do Rubygems no seu terminal:

gem -v

Se for menor que 2.6.5, será necessário atualizá-la manualmente:

Primeiramente baixe ruby-gems-update gem. Mova este arquivo para c:\\rubygems-update-2.6.11.gem e execute:

gem install --local c:\\rubygems-update-2.6.11.gem
update_rubygems --no-document
gem uninstall rubygems-update -x

Confira novamente sua versão de ruby:

gem -v

Verifique se é igual ou superior a 2.6.11. Execute novamente o comando que estava falhando anteriormente.

Se você ainda estiver com problemas, sempre poderá encontrar a versão mais recente do rubygems online em [rubygems.org] (https://rubygems.org/pages/download). Se você clicar em GEM, deverá ver a versão mais recente.

Durante o bundle install

O erro Gem :: RemoteFetcher :: FetchError: SSL_connect também pode ocorrer durante a fase de bundle install ao criar uma aplicação nova em rails.

O erro deve mencionar [bit.ly/ruby-sslingerie(http://bit.ly/ruby-ssl). O que pode ser relevante para os usuários de Windows neste momento é [esta página do GitHub] (https://gist.github.com/867550). A maneira manual descrita nesta solução provou ser bem-sucedida na solução do erro instalação do pacote configurável.

‘x64_mingw’ is not a valid platform Error

Às vezes, você pode receber o seguinte erro ao executar rails server: 'x64_mingw' is not a valid platform Se você tiver esse erro após executar o RailsInstaller, precisará fazer uma pequena edição no arquivo Gemfile:

Olhe para a parte inferior do arquivo. Você provavelmente verá algo assim como uma das últimas linhas do arquivo: gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw]. Se você tem essa linha com :x64_mingw, delete a parte :x64_mingw. No fim, queremos que se pareça com: 'tzinfo-data', platforms: [:mingw, :mswin]

Depois de fazer isso, abra seu prompt de comando novamente e digite bundle update.

The sqlite3 gem failed to install

Ao executar rails new myapp, a gem sqlite3 pode falhar na instalação. Quando isso acontecer, feche primeiro seu prompt de comando. Em seguida, abra o prompt novamente.

Em seguida, instale o sqlite3 separadamente do rails executando o seguinte comando no prompt de comando:

gem install sqlite3

Se isso der certo, remova o diretório myapp que o instalador do rails criou anteriorment e retorne às instruções de instalação para criar o app novamente (rails new myapp).


Outros Guias