Cómo instalar Ruby on Rails en Ubuntu 24.04

Ruby on Rails o RoR o Rails es un marco de aplicación web Ruby con arquitectura MVC (Modelo-Vista-Controlador), así como filosofías de diseño como No te repitas (DRY), Convención sobre Configuración (CoC) y patrón de registros activos. Es un marco web de pila completa para construir aplicaciones web de nivel empresarial.

En este tutorial, te guiaremos a través del proceso de instalación de Ruby on Rails en Ubuntu 24.04, creando el primer proyecto Rails, configurando PostgreSQL como la base de datos para tu proyecto Rails y generando un scaffold con el comando ‘rails’.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Ubuntu 24.04.
• Un usuario no root con privilegios de administrador sudo.

Instalación de dependencias

Para instalar Ruby on Rails en tu sistema Ubuntu, debes instalar dependencias como Ruby, Node.js, PostgreSQL (opcional para la base de datos), Git y paquetes de desarrollo adicionales. Esos paquetes están disponibles en el repositorio predeterminado de Ubuntu, y puedes instalarlos usando APT.

Para comenzar, actualiza tu repositorio de Ubuntu con el siguiente comando:

sudo apt update

Ahora instala las dependencias para Ruby on Rails con el comando a continuación. Con esto, instalarás Ruby, PostgreSQL, Node.js, git y algunos paquetes de desarrollador.

sudo apt install ruby ruby-dev postgresql libpq-dev nodejs yarnpkg git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev libffi-dev

Ingresa Y para proceder con la instalación.

Después de que la instalación esté completa, verifica la versión de Ruby y Node.js con lo siguiente:

ruby -v  
node -v

Puedes ver a continuación que Ruby 3.2 y Node.js 18.19 están instalados.

A continuación, ejecuta el comando a continuación para configurar Yarn como el administrador de paquetes de Node.js con el comando a continuación. Esto creará un nuevo comando ‘ yarn ‘ y verás la versión de Yarn.

sudo ln -s /usr/bin/yarnpkg /usr/bin/yarn  
yarnpkg -v

Por último, verifica el estado del servicio PostgreSQL con lo siguiente:

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

El servidor PostgreSQL se iniciará al arrancar, y el estado de PostgreSQL será ‘ activo (salido) ‘.

Creando usuario de PostgreSQL

Después de que las dependencias estén instaladas, crearás un nuevo usuario de PostgreSQL para tu proyecto Rails. Este usuario debe poder iniciar sesión y crear una nueva base de datos en PostgreSQL.

Inicia sesión en el servidor PostgreSQL con el siguiente comando.

sudo -u postgres psql

Ejecuta las siguientes consultas para crear un nuevo usuario de PostgreSQL ‘ appuser ‘ con la contraseña ‘ AppuserPassword ‘. Este usuario podrá crear una base de datos y un rol en PostgreSQL.

CREATE USER appuser WITH PASSWORD 'AppuserPassword';  
ALTER USER appuser CREATEDB CREATEROLE;

Ahora escribe quit o presiona Ctrl+d para salir de PostgreSQL.

A continuación, ejecuta el siguiente comando para iniciar sesión en PostgreSQL con el usuario ‘ appuser ‘. Ingresa tu contraseña cuando se te solicite.

su - postgres  
psql -U appuser -h 127.0.0.1 -d postgres

Después de iniciar sesión, verifica el estado de la conexión de PostgreSQL con lo siguiente:

elconninfo

Puedes ver a continuación que el nuevo usuario ‘ appuser ‘ puede conectarse al servidor PostgreSQL con la autenticación de contraseña a través de localhost o 127.0.0.1.

Instalando Ruby on Rails

En esta sección, instalarás la última versión de Ruby on Rails en el entorno específico del usuario. Así que necesitas configurar el directorio GEM_HOME predeterminado bajo tu usuario.

Primero, inicia sesión en tu usuario con el siguiente comando:

su - user

Crea un nuevo directorio ~/.gem y agrega la variable de entorno GEM_HOME a través del archivo ~/.bashrc. Con esto, todos los gemas de Ruby se instalarán en el directorio ~/.gem.

mkdir -p ~/.gem  
echo 'export GEM_HOME=$HOME/.gem' >> $HOME/.bashrc

Ahora ejecuta el comando a continuación para recargar tu shell actual y verificar la variable de entorno GEM_HOME. Verás que GEM_HOME apunta al directorio ~/.gem.

source ~/.bashrc  
echo $GEM_HOME

A continuación, ejecuta el comando gem a continuación para instalar el bundler en tu sistema.

gem install bundler

Después de eso, instala Ruby on Rails con el siguiente comando gem. Puedes instalar la última versión de Ruby on Rails o elegir una versión específica usando la opción -v.

gem install rails  
gem install rails -v 7.1.0

Cuando la instalación esté terminada, verifica la versión de Ruby on Rails con el siguiente comando:

rails --version  
rails --help

Como se muestra a continuación, la última versión de Ruby on Rails 7.1.3 está instalada, y también puedes ver el uso básico del comando ‘ rails ‘.

Creando un proyecto con Ruby on Rails y PostgreSQL

Ahora que has instalado Ruby on Rails. En esta sección, crearás tu primer proyecto Rails con PostgreSQL como la base de datos predeterminada.

Ejecuta el comando ‘rails’ a continuación para crear un nuevo proyecto Rails. En este ejemplo, crearás un nuevo proyecto testapp con la base de datos predeterminada PostgreSQL.

rails new testapp -d postgresql

Puedes ver a continuación que la aplicación Rails se ha generado, incluyendo la inicialización de git.

Ahora muévete al directorio ~/testapp y edita el archivo de configuración de la base de datos ‘ config/database.yml ‘.

cd ~/testapp/  
nano config/database.yml

Cambia los detalles de la base de datos para los entornos desarrollo, prueba y producción como sigue. La base de datos para cada entorno se creará automáticamente durante la migración.

development:  
 <<: *default  
database: testapp_development  
username: appuser  
password: AppuserPassword  
host: localhost  
port: 5432  
  
test:  
 <<: *default  
database: testapp_test  
username: appuser  
password: AppuserPassword  
host: localhost  
port: 5432  
  
production:  
 <<: *default  
database: testapp_production  
username: appuser  
password: <%= ENV["TESTAPP_DATABASE_PASSWORD"] %>

Cuando termines, guarda el archivo y sal.

A continuación, ejecuta el siguiente comando ‘ rails ‘ para configurar y migrar la base de datos.

rails db:setup  
rails db:migrate

Después de que la migración de la base de datos esté completa, ejecuta tu proyecto Rails con lo siguiente:

rails server -b 0.0.0.0

Puedes ver a continuación que tu proyecto Rails se está ejecutando en el puerto predeterminado 3000.

Visita la dirección IP de tu servidor http://192.168.5.30:3000/ usando tu navegador web. Si tu instalación de Rails es exitosa, deberías obtener el siguiente índice predeterminado de Rails:

Generando con Scaffolding

Ruby on Rails proporciona una manera fácil de construir tu aplicación para principiantes. Puedes utilizar un scaffold para generar la estructura básica de un proyecto Rails, que incluye un controlador, un modelo y una vista.

Ejecuta el siguiente comando para generar un scaffold para una aplicación simple ‘ site ‘ con dos entradas de usuario ‘ name ‘ y ‘ url ‘.

rails g scaffold site name:string url:string

A continuación se muestra el modelo, controlador y vista generados por Rails para tu aplicación.

Después de que el scaffold se haya generado, ejecuta el siguiente comando para migrar tu base de datos Rails.

rails db:migrate

Puedes ver a continuación que la base de datos para Rails ha sido migrada.

Ahora ejecuta tu proyecto Rails con el siguiente comando.

rails server -b 0.0.0.0

Por último, visita la dirección IP de tu servidor http://192.168.5.30:3000/sites para acceder a la aplicación ‘ site ‘. Puedes enviar un nuevo nombre de datos y url. Luego, puedes ver a continuación un ejemplo después de que se envían nuevos datos.

Conclusión

¡Felicidades! Has terminado la instalación de Ruby on Rails en Ubuntu 24.04. Has creado un proyecto Rails con PostgreSQL como la base de datos. Por último, también has aprendido a generar aplicaciones básicas en Rails utilizando la función de scaffold.