El mejor tutorial que he encontrado hasta ahora para hacer una instalación es de O'Reilly: Rolling with Ruby on Rails (vendría a ser: "Rodando con Rubí sobre Rieles"). El problema es que está orientado hacia el sistema operativo Windows.
En mi caso particular uso GNU/Linux y no Windows para desarrollar. La distribución que estoy usando actualmente es Fedora Core 4 (no son todas las distribuciones iguales) y no he obtenido los resultados esperados con la documentación.
Entonces, que mejor que hacer un mini-tutorial contando mi experiencia desde "la óptica de un novato en RoR" ;-)
Paso 1: Instalar Ruby
En el caso de Linux es la tarea más fácil: casi todas las distribuciones lo incluyen por defecto. Si la instalación de la distribución no incluyó Ruby, lo puedes hacer desde los CD's. También puedes usar un instalador en línea, para bajar las últimas versiones de los paquetes desde Internet.
El más famoso es el apt-get de Debian. En el caso de Fedora tenemos yum (que si no lo tienes, es hora de que lo instales ;-).
Con yum, es muy sencillo:
yum install rubyPaso 2: Instalar Gem
Esta explicación es anecdótica: en la actualidad se está conociendo este framework como Ruby On Rails, cuando en realidad el framework se llama Rails, pero está basado en Ruby.
O sea, nosotros tenemos que instalar ahora Rails, pues Ruby ya está instalado ;-)
Esta es la parte, por decirlo de una manera, un poco más difícil.
Rails cuenta con un propio instalador en línea que se llama gem (vendría a ser el yum de Fedora, pero este solo es para Rails). Para poder instalar el framework hay que bajar primero el "gem" y luego correrlo para que instale el Rails. La dirección oficial es:
http://docs.rubygems.org/shelf
Y en la sección "download" nos encontramos con la última versión de gem:
http://rubyforge.org/frs/?group_id=126
Me bajo la versión comprimida con tgz, y lo descomprimes en tu directorio preferido, en este caso yo uso /opt.
tar zxvf rubygems-0.8.11.tgz
Y para instalarlo, luego de entrar en el directorio generado, hay que ejecutar:
cd rubygems-0.8.11
ruby setup.rb
En mi caso, la instalación no dió errores.
Paso 3: Instalar Rails
Ya estamos prontos para instalar Rails usando nuestro instalador Gem.
Los parámetros que más cuadraron fueron los siguientes:
gem install rails --remote --include-dependencies
Si no agregas el último ("dependencias") por cada software que falte te va a preguntar si quieres instalarlo, lo que sucede casi en seis oportunidades (demasiado). La verdad que prefiero el "piloto automático" y que me resuelva las "dependencias" solo.
En este caso, sí surgieron problemas.
gem install rails --remote --include-dependencies
Attempting remote installation of 'rails'
Successfully installed rails-1.0.0
Successfully installed activesupport-1.2.5
Successfully installed activerecord-1.13.2
Successfully installed actionpack-1.11.2
Successfully installed actionmailer-1.1.5
Successfully installed actionwebservice-1.0.0
/usr/lib/site_ruby/1.8/rubygems/custom_require.rb:21:in `require__': no such file to load -- rdoc/rdoc (LoadError)
Por lo que entendí, no encontraba el "rdoc", y en algún momento de mi vida recuerdo haber sentido este nombre, conclusión, debía ser una aplicación que había que instalar. Simplemente ejecuté el yum:
yum install rdoc
Installing:
rdoc i386 1.8.4-1.fc4 updates-released 119 k
Installing for dependencies:
irb i386 1.8.4-1.fc4 updates-released 62 k
[Mensaje resumido]
Y de paso, me avisa que hay una "dependencia a cumplir" que es instalar el irb, lo cual acepté.
Volví a correr la instalación y concluyó con éxito:
gem install rails --remote --include-dependencies
Attempting remote installation of 'rails'
Successfully installed rails-1.0.0
Paso 4: Probar la instalación
En primera instancia, debemos tener disponible el comando "rails" desde nuestra consola. Para probarlo, nos posicionamos en un directorio que alojaremos nuestros proyectos web basados en RoR. En mi caso, yo uso /var/www, y ejecutamos "rails" y el nombre del proyecto a crear:
cd /var/www
rails pruebarails
Lo cual genera una estructura de directorios con contenidos "base" para nuestra aplicación RoR:
create
create app/controllers
create app/helpers
create app/models
create app/views/layouts
create config/environments
create components
create db
create doc
create lib
create lib/tasks
create log
create public/images
create public/javascripts
create public/stylesheets
create script/performance
create script/process
create test/fixtures
create test/functional
[Sigue un listado más largo]
Entramos en el directorio de nuestra aplicación y ejecutamos un mini servidor web para probar que nuestro entorno RoR esté respondiendo:
cd pruebarails
script/server
El último comando ejecuta el servidor, y la salida en consola es la siguiente:
=> Booting WEBrick...
=> Rails application started on http://0.0.0.0:3000
=> Ctrl-C to shutdown server; call with --help for options
[2006-01-23 16:45:54] INFO WEBrick 1.3.1
[2006-01-23 16:45:54] INFO ruby 1.8.4 (2005-12-24) [i386-linux]
[2006-01-23 16:45:54] INFO WEBrick::HTTPServer#start: pid=7627 port=3000
Nuestro servidor atenderá el puerto 3000. Si usamos nuestro navegador y apuntamos a la dirección http://localhost:3000 (localhost representa nuestro "servidor local"), nos deberá responder un mensaje de bienvenida a Ruby On Rails:
Y pronto, el primer paso está dado.
En posteriores entregas voy a ir armando micro-tutoriales para ir aprendiendo a crear las primeras aplicaciones y las primeras conexiones con la bases de datos.
Cualquier duda al respecto, puedes enviar un comentario a este "post" que lo responderé lo más pronto que pueda (si, tengo vida social ;-)
¡Saludos!
