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 OS X

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 é 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.3.1

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.3.1

3a6. Instalar Rails:

gem install rails --no-document

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

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

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 OS X 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

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

rails new myapp

4. Instalar editor de texto

Para esse workshop recomendamos o editor de texto Atom.

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

5. Atualizar seu navegador

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!


Instalação para Windows

1. Instalar Rails

Baixar o RailsInstaller e executá-lo. Utilize as configurações padrões durante a instalação.

Abra o Command Prompt with Ruby and Rails e execute os comandos abaixo para resolver problemas com o RailsInstaller3.2.0.

Coach: O erro No such file or directory ocorre quando o comando rails é utilizado no RailsInstaller3.2.0. Esse problema acontece devido a um erro no caminho do arquivo rails.bat e bundle.bat. Podemos resolvê-lo copiando o arquivo rake.bat para rails.bat e bundle.bat. (github issue page)

cd C:\RailsInstaller\Ruby2.2.0\bin
copy rake.bat rails.bat
copy rake.bat bundle.bat

Abra o Command Prompt with Ruby and Rails e execute o seguinte comando:

rails -v

Se a versão do Rails for menor que 5, atualize-o utilizando o seguinte comando:

gem update rails --no-document

Possíveis erros

Gem::RemoteFetcher error

Se você se deparar com o erro abaixo quando 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)

Significa que você possui uma versão antiga do Rubygems e será necessário atualizá-lo manualmente. Primeiro, verifique a sua versão do Rubygems (via terminal):

gem -v

Se a versão for menor que 2.6.5 você precisa atualizá-la manualmente através dos seguintes passos:

Primeiro baixe o ruby-gems-update gem. Mova o arquivo para c:\\rubygems-update-2.6.11.gem e execute (via terminal):

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

Verifique novamente sua versão do Rubygems:

gem -v

Tenha certeza que seja igual ou maior que 2.6.11. Caso não, execute o procedimento acima novamente.

Se você ainda está enfrentando problemas, você pode sempre encontrar a versão mais recente do rubygems online em rubygems.org. Se você clicar em GEM, você terá a última versão.

Durante bundle install

O erro Gem::RemoteFetcher::FetchError: SSL_connect pode também acontecer durante a etapa de bundle install ao criar um novo rails app.

O erro irá mencionar bit.ly/ruby-ssl. O que é relevante para usuários de Windows neste ponto é este GitHub gist. O manual descrito se provou ser bem sucedido para resolver esse erro de bundle install.

Erro ‘x64_mingw’ não é uma plataforma válida

Algumas vezes você pode se deparar com o seguinte erro quando executar rails server:

'x64_mingw' is not a valid platform

Se você encontrar esse erro após utilizar o RailsInstaller, você terá que editar o arquivo Gemfile. Para isso, siga os passos abaixo:

No final do arquivo verifique se as últimas linhas possuem as seguintes informações:

gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw].

Se a linha possui :x64_mingw, então apague a parte :x64_mingw.

O final deverá ser da seguinte maneira: gem 'tzinfo-data', platforms: [:mingw, :mswin].

Após fazer o procedimento, favor usar seu prompt de comando novamente e executar bundle update.

2. Instalar editor de texto

Para esse workshop recomendamos o editor de texto Atom.

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

3. 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.

4. Instalar Node

O procedimento não é estritamente necessário, mas pode evitar problemas com e ExecJS::RuntimeError que podem ocorrer posteriormente (ver stackoverflow).

Verifique sua versão do Node:

node --version

Tenha certeza que está mostrando uma versão qualquer do Node.

5. Verificar o ambiente

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

rails new myapp
cd myapp
rails server

Acesse http://localhost:3000 em seu navegador. Você deverá ver a página ‘Yay! You’re on Rails!’.

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

Coach: Recomendamos verificar o procedimento executando o comando scaffold e adicionando dados com a página gerada pelos coaches para assegurar que tudo está funcionando bem.


Instalação para Linux

1. Instalar Rails

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.

Para Ubuntu:

sudo apt-get install curl
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

2. Instalar editor de texto

Para esse workshop recomendamos o editor de texto Sublime Text

3. 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