Tutorial: cómo instalar Ruby y Ruby on Rails y usar RubyGems

Seguramente ya has oído hablar de Ruby on Rails y de lo fácil que es crear aplicaciones funcionales en poco tiempo. Sin embargo, el proceso de crear nuevo software requiere algunas piezas y entender cómo gestionarlas de forma eficiente.

El primer paso es, por supuesto, instalar Ruby. Como el número de proyectos seguramente crecerá rápido, gestionar múltiples versiones de Ruby puede volverse bastante desagradable. Para ayudarte con eso, la comunidad de código abierto preparó varios gestores de versiones, siendo los más populares rbenv y rvm.

¿Cómo instalar Ruby en Mac?

Tanto rvm como rbenv están disponibles para macOS y las distribuciones Linux más populares, así que todo se reduce a pegar unas cuantas líneas de comando en la consola.

rbenv

1. Con Homebrew instalado, ejecuta init en tu Terminal (y si no lo tienes, puedes instalar rbenv con un checkout desde GitHub):

$ brew install rbenv

2. Cuando termine, escribe:

$ rbenv init

3. Esto mostrará una guía para configurar la shell. Normalmente basta con añadir una línea a .zshrc o .bash_profile:

$ echo 'eval "$(rbenv init -)"' >> ~/.zshrc

4. Ahora, cada vez que abras la Terminal, rbenv debería estar listo para funcionar.

$ source  ~/.zshrv

5. Por fin, toca instalar Ruby propiamente dicho. Ahora es tan simple como indicar el número de versión después del comando install:

$ rbenv install 2.7.0
$ rbenv global 2.7.0

6. Para definir la versión local que se usará, escribe:

$ rbenv local 2.7.0

rvm

Si ya instalaste Ruby usando rbenv, tu trabajo está hecho. rvm es una herramienta alternativa para hacer lo mismo y, por lo general, no es buena idea usar ambas a la vez; además, no tiene sentido.

Instalar rvm es bastante similar a rbenv y, de nuevo, solo necesitas ejecutar unos pocos comandos en la consola:

1. Empecemos añadiendo las claves PGP:

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

2. Luego descarga rvm e instala la última versión de Ruby a continuación:

$ curl -sSL https://get.rvm.io | bash -s stable --ruby

3. Se pueden descargar e instalar rápidamente distintas versiones de Ruby con el comando install, así:

$ rvm install 2.7.0

Es importante mencionar que en el directorio de tu proyecto puedes crear un archivo .ruby-version (un archivo de texto simple con el número de versión de Ruby). En base a este archivo, tanto rbenv como rvm intentarán usar la versión correcta de Ruby o te pedirán instalar la que falte.

¿Cómo instalar Ruby en Windows?

Si usas Windows, la mejor opción es utilizar RubyInstaller. Descarga el archivo .exe para la versión de Ruby que quieras e inicia la instalación. RubyInstaller puede combinarse con MSYS2 (un port del conjunto de herramientas de desarrollo Unix) y las bibliotecas MinGW, proporcionando un gran entorno de desarrollo.

Comprobar la instalación de Ruby

Tras la instalación, puedes comprobar la versión con:

$ ruby -v

Y ver dónde está el intérprete:

$ which ruby

Ruby es un lenguaje de programación interpretado. Para ejecutar código, basta con indicar el archivo .rb y ejecutarlo:

$ ruby app.rb

Junto con el intérprete viene la Interactive Ruby Shell (irb), que ejecuta comandos de Ruby en tiempo real mientras los escribes:

$ irb
irb(main):001:0> 2+2
=> 4

¿Qué es RubyGems?

La instalación estándar de Ruby incluye la Ruby Core API y Standard Library API, que se usan para escribir aplicaciones Ruby. Una aplicación sencilla puede escribirse desde cero usando esas APIs, pero cuando se trata de algo más complejo, lo mejor es usar paquetes de Ruby proporcionados por el gestor de paquetes. Ruby tiene uno llamado RubyGems y los paquetes se llaman gemas. 

RubyGems incluye una utilidad de línea de comandos llamada gem. Instala gemas desde repositorios públicos o privados especificados. Otra cosa que vale la pena mencionar es https://rubygems.org/, que aloja muchas gemas de la comunidad Ruby. Normalmente, una gema proporciona nuevas bibliotecas con funcionalidades concretas y, a veces, herramientas de línea de comandos. 

RubyGems viene con la instalación estándar de Ruby, así que no necesitas instalar nada más.

¿Cómo usar RubyGems?

Veamos cómo trabajar con gemas. Este comando imprimirá la configuración de RubyGems con información sobre dónde se instalan las gemas:

$ gem env

Instalar / desinstalar gemas

Para instalar y desinstalar gemas, escribe:

$ gem install gem_name (-v versión para indicar la versión de la gema)
$ gem uninstall gem_name

Actualizar gemas

Para actualizar una gema concreta, ejecuta:

$ gem update gem_name

O todas las gemas:

$ gem update

Listar gemas

Las gemas se instalan en un repositorio local. Para listar las gemas instaladas, escribe:

$ gem list

Al instalar gemas, sus dependencias se instalan junto con ellas.

Ruby Bundler

Durante el desarrollo puedes descubrir que tu proyecto necesita cada vez más gemas. Instalar todas manualmente con el comando gem haría muy difícil, si no imposible, cuadrar todas las dependencias. Hay una herramienta inteligente para gestionar todas las gemas de un proyecto: Bundler.

Instalar Bundler y especificar gemas para el proyecto

Viene como una gema, así que primero instálala:

$ gem install bundler

Luego crea un Gemfile en la carpeta raíz de tu proyecto con el contenido:

source ‘https://rubygems.org’ gem ‘rails’, ’6.0.2.1’ gem ‘rspec’

Instalar gemas con Bundler

Para instalar, escribe:

$ bundle install

Instalará todas las gemas con la versión especificada y sus dependencias. Si quieres usar otra gema en tu proyecto, añádela al Gemfile y ejecuta de nuevo bundle install.

Actualizar gemas con Bundler

Si quieres actualizar algunas gemas de tu proyecto, cambia la versión en el Gemfile y, de nuevo, ejecuta:

$ bundle install

Para actualizar una gema concreta, ejecuta:

$ bundle update gem_name

O todas las gemas:

$ bundle update

En cualquier caso, Bundler resolverá las dependencias.

¿Cómo usar Ruby on Rails?

Tras todas las instalaciones y ajustes, es momento de iniciar un nuevo proyecto de Ruby on Rails y configurar un par de cosas. 

Instalar Rails

Sin sorpresas aquí: Rails viene como una gema:

$ gem install rails

Esto instalará la versión más reciente de Rails junto con otras gemas de las que depende. Rails incluye su propia utilidad de línea de comandos que puede usarse para crear una nueva aplicación Ruby on Rails.

Comprueba la versión y los mensajes de ayuda que describen las opciones para crear una app nueva.

$ rails -v
$ rails -h

Nueva aplicación Rails

Para crear un proyecto Rails con las opciones predeterminadas, escribe:

$ rails new my_amazing_rails_app

Ese comando generará toda la estructura del proyecto bajo el directorio my_amazing_rails_app. Verás la salida de la creación de archivos de la aplicación y luego Bundler instalará todas las dependencias del Gemfile recién creado. 

A continuación, entra en el directorio my_amazing_rails_app e inicia un servidor de Rails.

$ cd my_amazing_rails_app
$ rails server

Esto iniciará el servidor web Puma, que es el que usan por defecto las aplicaciones Rails. El puerto predeterminado es el 3000. Ve a tu navegador y entra en http://localhost:3000 y deberías ver la página de bienvenida de Rails.

¿Cómo configurar un entorno de desarrollo Ruby on Rails?

La base de datos predeterminada que usa Rails es SQLite. Si quieres usar otra BD desde el principio, puedes indicarla con la siguiente opción:

$ rails new my_amazing_rails_app —database postgresql

La configuración de la base de datos está en el archivo config/database.yml. Rails ejecuta la aplicación en el entorno especificado (para iniciar la app en local se usa por defecto el entorno “development”). Para definir la configuración de tu BD, edita los ajustes de development en config/database.yml. 

Otra opción muy usada es api, que configura la aplicación con un middleware limitado, solo para aplicaciones tipo API.

$ rails new my_amazing_rails_app —api

Rails genera muchos archivos. En el directorio app encontrarás los archivos principales de la aplicación. Como Rails se creó siguiendo el patrón MVC (Model-View-Controller), encontrarás archivos para modelos, controladores y vistas en sus directorios correspondientes. En el directorio config verás archivos de configuración de la aplicación, los entornos, la base de datos, las rutas, etc. En el directorio db están el esquema de la BD y los archivos de migración.

¿Dónde seguir?

Existen muchos tutoriales y guías de Rails. Por mencionar uno, https://guides.rubyonrails.org/ describe la mayoría de características de Rails con ejemplos. Las APIs de Ruby y Rails están bien documentadas. Solo crea una nueva app, crea un modelo, un controlador y una vista para él, ¡y puede que te enamores de Rails!

Si te interesa el desarrollo con Ruby on Rails, lee nuestro artículo para descubrir por qué vale la pena aprender Ruby on Rails.