Introdução ao Ruby On Rails

Geralmente, existem 3 instalações: OSX, Windows e Linux, sendo esta última a mais fácil.

Windows:

Vá para http://www.rubyonrails.org/, e baixe o pacote contendo gems (instalador para Windows).

Instale o pacote.

Atualize o sistema de gemas via:

gem update --system

Atualize as gems instaladas via:

gem update

Quando isso estiver feito, instale as gems relevantes. Eu sugeriria o seguinte como mínimo:
*rails (para o framework)
Por favor, note que rails 2.02 é a versão mais nova, você pode instalar uma versão mais antiga via

gem install v1.2.6 rails

mysql (para acesso ao banco de dados) mongrel (servidor web melhor que webrick)

Quando solicitado pela versão que você deseja usar, escolha a versão mais nova, que tem win32 na opção.

OSX 10.4 e 10.5

Vá para http://www.macports.org/ e baixe a versão correta do arquivo (tiger/leopard).

Leia o guia de instalação: http://www.macports.org/install.php

Guia rápido:
Instale o xcode correto para o seu sistema.
Instale o programa macports (isso pode levar um tempo)
Quando terminar, faça:

sudo port install ruby  
sudo port install rb-gems (habilitando gems sob ruby)  
sudo gem install rails (framework)  
sudo port install rb-mysql (mysql para uso sob RoR)  
sudo gem install mongrel (servidor web)  
sudo port install subversion (para instalação fácil de plugins remotos)

Linux (baseado em Ubuntu / Debian)

sudo apt-get update && sudo apt-get upgrade (obtendo a lista mais nova e atualizando o software antes de continuar).  
sudo apt-get install ruby subversion mysql libmysql-ruby1.8

sudo gem install rails  
sudo gem install mongrel

E você deve estar pronto para começar.

IDE para uso com RoR:
Textmate (OSX), tem uma integração muito pobre com subversion, mas boa integração com RoR
Não é gratuito
Eclipse (boa integração, via plugins)
http://www.eclipse.org/ baixe plugins via o site Aptana, para suporte a RoR.
Gratuito

Aptana (boa integração via plugins) http://www.aptana.com/
IDE completa, baseada em eclipse. Gratuito
IDEA (boa integração via plugins)
Conjunto completo de IDE, com ótima integração de subversion, mysql e até jira para rastreamento de bugs.
Profissional, mas caro.

Lembre-se de apontar sua IDE para onde seu RoR / rails está instalado para melhor integração:
Windows geralmente: c:\ruby\bin
OSX: /opt/local/
Linux: /usr/bin/ruby

Erros:

Linux:

sudo gem update --system

O que introduziu este erro:

/usr/bin/gem:23: uninitialized constant Gem::GemRunner(NameError)

sempre que eu tentava executar rubygems. No fórum rails, encontrei uma solução para isso!. Basta adicionar a linha ao arquivo /usr/bin/gem (pode ser diferente em um mac):

require 'rubygems/gem_runner'

depois de

require 'rubygems'

Fonte: http://www.nickpeters.net/2007/12/31/fix-for-uninitialized-constant-gemgemrunner-nameerror/

Este erro ao instalar gems:

extconf.rb:1:in `require’: no such file to load—mkmf (LoadError)

do extconf.rb:1.

Faça:

sudo apt-get install ruby1.8-dev

Fonte: http://www.rousette.org.uk/projects/forums/viewthread/177/