Este capítulo explica cómo puede usted instalar Rails en su plataforma de desarrollo.
Rails es un proyecto de fuente abierta, y como tal, hay varias maneras de instalarlo y obtenerlo dependiendo de su plataforma y sus necesidades.
En este artículo cubriremos dos maneras de instalar rails:
Si usted es un desarrollador de software, la manera más sencilla de utilizar rails es mediante una solución todo-en-uno que no afecte su ambiente actual.
Si usted utiliza Windows, puede instalar la plataforma Rails completa (incluyendo una version de mysql) utilizando proyecto Instant Rails. Éste proyecto incluye apache, ruby, rails, y el servidor de mysql, todo listo para ejecutarse.
Si utiliza Macintosh OS X, puede utilizar el proyecto Locomotive. Locomotive incluye ruby, rails y sqllite (en vez de un servidor de mysql). Si usted tiene un servidor mysql en otra máquina, locomotive incluye las librerías de mysql para conectarse.
Estos ambientes de desarrollo son adecuados para comenzar a escribir aplicaciones en Rails en su propia máquina, pero no son adecuados para ambientes multiusuario. Así que una vez que usted tenga su programa listo para que otras personas lo utilizen (ya sea en modo de prueba, pre-producción o producción), necesitará comprender como instalar un ambiente de rails desde cero.
Para efectos de instalación, Rails se puede dividir en los siguientes componentes:
Ruby es un lenguaje de programación interpretado. Ruby funciona con cualquier sistema operativo moderno, pero se siente más "en casa" en sistemas tipo Unix.
La manera en que usted instale ruby depende mucho de su tipo de máquina y sus necesidades. Es recomendable que lea todo lo relevante a la plataforma que desee instalar antes de que haga una decisión acerca de cómo instalarlo.
Si usted tiene una máquina que proviene de la familia Unix (incluyendo Mac OS X), es probable que ya tenga Ruby incluido. Rails requiere de ruby 1.8.2 o 1.8.4 (pero 1.8.3 no funciona).
Para verificar su versión de ruby, ejecute el comando "ruby -v". Si su versión es adecuada, usted puede proceder a la sección de Gems.
Si su versión de ruby no es compatible con rails, usted tiene dos opciones:
Nota: Muchos administradores de sistema Unix (en especial de Linux) prefieren instalar los sistemas de web compilando los archivos fuente. Esto permite el control absoluto de su ambiente, pero requiere de mayor conocimiento de su sistema, así como un compilador.
Si usted decide instalar un sistema ruby desde código fuente, baje el código fuente del sitio oficial de Ruby (en Mac OS X también necesita instalar las herramientas XCode, que normalmente vienen incluidos en sus discos del sistema operativo), y utilice la manera estándar de compilar programas en Unix:
$ cd ruby-1.8.4-src
$ ./configure --prefix=/usr/local
$ make
$ make install
Después de instalarlo, añada el directorio /usr/local/ruby/bin a su variable PATH.
Recuerde: Si su máquina ya incluía ruby, el directorio de su nueva copia de Ruby debe estar antes de los demás directorios en su variable PATH.
Ahora verifique que su instalación funciona ejecutando ruby -v y verificando la nueva versión.
Como mencioné anteriormente, ruby se encuentra "más en casa" en un sistema Unix. El problema principal de Windows es que éste sistema operativo no viene con un compilador - los usuarios de Windows se sienten más comodos con paquetes en binarios y con instalador.
Si usted no tiene deseo de aprender a manejar un sistema Unix, usted puede utilizar el One Click Ruby Installer for Windows. Este es un instalador que incluye ruby, muchas librerías en binario, y el libro "Programming Ruby: The Pragmatic Programmer's Guide" en un archivo de ayuda. Una vez instalado, sencillamente ejecute una línea de comando y escriba "ruby -v" para verificar su versión.
Pero si usted quisiera instalar un subsistema tipo Unix bajo Windows (o si usted está obligado a usar Windows por su trabajo pero prefiere usar Linux en casa), usted puede instalar Cygwin, que es una recompilación de las utilerías GNU bajo windows. Durante la instalación, seleccione Ruby para que se encuentre incluido.
RubyGems es un manejador de librerías de Ruby que hace muy sencillo instalar librerías. Gems esta a punto de convertirse en parte de ruby. Pero si gems no está incluido en su versión de ruby (lo cual puede verificar ejecutando gem -v para ver la versión de gems instalada), lo necesita instalar. Como usted ya tiene ruby, el procedimiento para instalarlo es el mismo para todos los sistemas operativos:
# cd rubygems
# ruby setup.rb
# gem -v
Ahora que tiene ruby gems, puede proceder a instalar rails.
Ahora necesita una base de datos. Si usted utiliza Unix, es importante instalarla antes de instalar el paquete mysql de gems porque las librerías de cliente de mysql son necesarias.
Para instalar mysql, baje la versión para su plataforma del sitio de internet de MySQL.com. Una vez que la instale, puede proceder a instalar rails.
Ahora sí podemos instalar rails. Para instalar rails ejecute lo siguiente
$ sudo gem install rails --include-dependencies $ sudo gem install mysql --with-mysql-dir=/usr/local/mysql
El parámetro with-mysql-dir sólo es necesario si su mysql no instala correctamente (porque el compilador no encontró las librerías de mysql). Asegúrese de que el directorio queutiliza en el parámetro sea el directorio donde instaló mysql.
Finalmente, ejecute el comando rails --version para verificar que su versión de rails fué instalada correctamente.