Cómo instalar Ruby on Rails en Debian 12

Ruby on Rails o RoR es un marco de aplicación web gratuito y de código abierto escrito en Ruby y lanzado bajo la licencia MIT. Rails es un marco web de pila completa para construir fácilmente aplicaciones de nivel empresarial. Rails se envía con diferentes herramientas que permiten a los desarrolladores crear fácilmente aplicaciones tanto frontend como backend. Ruby on Rails también tiene características de seguridad integradas, como protección contra ataques comunes como inyección SQL, XSS y CSRF.

Ruby on Rails proporciona una estructura predeterminada para la base de datos, renderizando plantillas HTML, un servicio web y una página web. Sigue la arquitectura de modelo-vista-controlador (MVC) y también utiliza filosofías de diseño bien conocidas como No te repitas (DRY), Convención sobre configuración (CoC) y patrón de registros activos. Ruby on Rails fue diseñado para ser rápido y fácil de usar y aprender. Algunos sitios notables desarrollados con Rails son Twitch, Airbnb, Github, Soundcloud, etc.

En esta guía, te guiaremos a través de la instalación de Ruby on Rails en el servidor Debian 12. Instalarás Ruby on Rails con un servidor de base de datos PostgreSQL y el administrador de versiones de Ruby Rbenv. También crearás un scaffold, la estructura básica del proyecto Rails.

Requisitos previos

Antes de comenzar, confirma que tienes:

• Un servidor Debian 12.
• Un usuario no root con privilegios de administrador sudo.

Instalando dependencias

En el primer paso, instalarás algunas dependencias básicas en tu servidor Debian. Esto incluye el servidor de base de datos PostgreSQL que se utilizará como base de datos para tu proyecto Rails, node.js y el administrador de paquetes Yarn que será utilizado por Rails para compilar activos estáticos.

Para comenzar, actualiza y refresca tu índice de paquetes ejecutando el comando apt update a continuación.

sudo apt update

A continuación, instala las dependencias utilizando el siguiente comando apt install. Esto incluye el servidor de base de datos PostgreSQL, el controlador libpq, Node.js, Yarn, Git y algunas bibliotecas y herramientas del sistema.

sudo apt install 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 software-properties-common libffi-dev

Escribe y para confirmar y proceder con la instalación.

Una vez que las dependencias estén instaladas, verifica el estado del servidor PostgreSQL utilizando el siguiente comando. Esto asegurará que PostgreSQL esté en ejecución y habilitado en tu máquina Debian.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Si PostgreSQL está habilitado, deberías obtener la salida habilitada. Cuando PostgreSQL esté en ejecución, deberías obtener la salida activa (en ejecución) o activa (salida).

Por último, verifica el administrador de paquetes Node.js y Yarn ejecutando el comando a continuación.

node --version  
yarnpkg --version

En este ejemplo, Node.js 18 y Yarn 1.22 están instalados.

Instalando Rbenv

Después de instalar las dependencias del paquete, el siguiente paso es instalar Rbenv, el administrador de versiones de Ruby para sistemas operativos similares a Unix. Con Rbenv, puedes administrar fácilmente el entorno de tus aplicaciones Ruby, además de poder instalar múltiples versiones de Ruby en tu sistema.

Inicia sesión en tu usuario utilizando el siguiente comando.

su - user

Descarga el código fuente de rbenv y el plugin ruby-build a través del comando git a continuación.

git clone https://github.com/rbenv/rbenv.git ~/.rbenv  
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

Ahora ejecuta el siguiente comando para agregar un PATH personalizado a tu shell.

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc  
echo 'eval "$(rbenv init -)"' >> ~/.bashrc  
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc

Recarga tu configuración ~/.bashrc para aplicar los cambios. Después de ejecutar el comando, tu instalación de rbenv debería estar activada.

source ~/.bashrc

Verifica rbenv ejecutando el comando rbenv a continuación. Si la instalación de rbenv es exitosa, deberías ver los comandos/opciones de rbenv disponibles.

rbenv commands

Instalando Ruby a través de Rbenv

Con Rbenv instalado, ahora puedes instalar Ruby en tu sistema. Con Rbenv, instalarás Ruby solo en tu entorno actual, lo que no afecta a todo el sistema. Instalarás Ruby 3.2.2 en tu entorno de usuario actual.

Ejecuta el comando rbenv install a continuación para instalar Ruby 3.2.2 en tu sistema.

rbenv install 3.2.2

Durante la instalación, deberías ver esto:

Una vez que Ruby esté instalado, ejecuta el siguiente comando para configurar la versión predeterminada de Ruby a 3.2.2.

rbenv global 3.2.2

Por último, verifica la versión de Ruby en tu sistema utilizando el comando a continuación.

ruby -v

Si todo va bien, deberías ver que Ruby 3.2.2 está instalado.

Instalando Ruby on Rails

En este punto, tu sistema está configurado y listo para instalar Ruby on Rails en tu máquina Debian. En este ejemplo, instalarás Ruby on Rails 7.0 y verificarás la lista de versiones disponibles de Rails en el sitio oficial.

Ejecuta los comandos gem a continuación para instalar el bundler, luego instala Ruby on Rails 7.0.7.2.

gem install bundler  
gem install rails -v 7.0.7.2

Durante la instalación, deberías ver una salida como la siguiente:

Ahora ejecuta el comando rebenv a continuación para rehacer y recargar tu entorno actual.

rbenv rehash

Por último, ejecuta el comando rails a continuación para asegurarte de que Ruby on Rails esté instalado.

rails version  
rails -h

Si la instalación es exitosa, deberías ver tu versión actual de Rails y la página de ayuda del comando rails.

Creando el primer proyecto Rails

En esta sección, aprenderás cómo crear tu primer proyecto con Ruby on Rails. Utilizarás PostgreSQL como la base de datos predeterminada para tu proyecto Rails. Para lograr eso, debes completar lo siguiente:

• Preparar el usuario de PostgreSQL para la aplicación.
• Crear el primer proyecto Rails.

Preparar el usuario de la base de datos

Primero, debes crear un nuevo usuario de PostgreSQL que se utilizará para tu aplicación Rails. Este usuario debe tener privilegios para crear bases de datos y usuarios.

Regresa a tu cuenta de usuario e inicia sesión en el servidor PostgreSQL utilizando el comando a continuación.

sudo su  
sudo -u postgres psql

Ahora crea un nuevo usuario bob con la contraseña p4sswordbob. Luego, asigna nuevos privilegios para crear una base de datos y roles al usuario bob.

CREATE USER bob WITH PASSWORD 'p4sswordbob';  
ALTER USER bob CREATEDB CREATEROLE;

Verifica la lista de usuarios y privilegios en tu servidor PostgreSQL utilizando el comando a continuación.

du

Deberías ver al usuario bob con privilegios CREATEDB y CREATEROLE.

Escribe \q para cerrar sesión en el servidor PostgreSQL.

Por último, inicia sesión en tu usuario y ejecuta el siguiente comando psql para iniciar sesión en el servidor PostgreSQL como el nuevo usuario bob.

su - user  
psql -U bob -h 127.0.0.1 -d postgres

Una vez conectado al servidor PostgreSQL, ejecuta la siguiente consulta para verificar tu información de conexión.

\conninfo

Deberías ver que te has conectado al servidor PostgreSQL como el usuario bob.

Escribe \q para salir del servidor PostgreSQL.

Creando el proyecto Rails

Después de crear un usuario de PostgreSQL, ahora puedes comenzar a crear un nuevo proyecto Rails a través de la utilidad de línea de comandos rails.

Para crear un nuevo proyecto rails, ejecuta el comando rails a continuación. En este ejemplo, crearás un nuevo proyecto testapp con la base de datos predeterminada PostgreSQL.

rails new testapp -d postgresql

La salida del comando debería verse así:

Después de que se cree el proyecto, también se creará el nuevo directorio ~/testapp. Entra en el directorio ~/testapp y abre la configuración de la base de datos config/database.yml utilizando tu editor de texto preferido.

cd testapp/  
nano config/database.yml

Cambia la configuración de la base de datos predeterminada para desarrollo, prueba y producción. Asegúrate de ingresar tu nombre de usuario y contraseña de PostgreSQL.

development:  
  <<: *default  
  database: testapp_development  
  
  # El rol de base de datos especificado se está utilizando para conectarse a postgres.  
  # Para crear roles adicionales en postgres, consulta `$ createuser --help`.  
  # Cuando se deja en blanco, postgres utilizará el rol predeterminado. Este es  
  # el mismo nombre que el usuario del sistema operativo que ejecuta Rails.  
  username: bob  
  
  # La contraseña asociada con el rol de postgres (nombre de usuario).  
  password: p4sswordbob  
  
  # Conectar en un socket TCP. Omitido por defecto ya que el cliente utiliza un  
  # socket de dominio que no necesita configuración. Windows no tiene  
  # sockets de dominio, así que descomenta estas líneas.  
  host: localhost  
  
  # El puerto TCP en el que el servidor escucha. Por defecto es 5432.  
  # Si tu servidor se ejecuta en un número de puerto diferente, cámbialo en consecuencia.  
  port: 5432

Guarda y cierra el archivo cuando hayas terminado.

Ahora ejecuta el comando rails a continuación para migrar la base de datos. Esto creará automáticamente una nueva base de datos para tu proyecto testapp.

rails db:setup  
rails db:migrate

A continuación, deberías ver la salida durante la migración de la base de datos del proyecto testapp.

Después de que la base de datos esté migrada, ejecuta el comando rails a continuación para ejecutar el proyecto testapp. Esto ejecutará testapp dentro de tu dirección IP en el puerto 3000.

rails server -b 192.168.10.15

En la salida siguiente, deberías ver que testapp está en ejecución.

Ahora lanza tu navegador web favorito y visita la dirección IP de tu servidor seguida del puerto 3000, como http://192.168.10.15:3000/. Si tu instalación es exitosa, deberías ver la página index.html predeterminada de Ruby on Rails.

Presiona Ctrl+c para terminar tu aplicación Rails.

Scaffold de Rails para el kit de inicio

Un scaffold es una forma automática de generar la estructura básica de un proyecto Rails, que incluye un controlador, un modelo y una vista.

Ejecuta el comando rails a continuación para crear un scaffold books con tres campos title, author y publication_year.

rails g scaffold books title:string author:string publication_year:integer

Ahora migra la base de datos para aplicar los cambios utilizando el comando rails a continuación.

rails db:migrate

A continuación, ejecuta tu proyecto Rails ejecutando el comando rails server a continuación.

rails server -b 192.168.10.15

Una vez que testapp esté en ejecución, verifica el scaffold de libros a través de la ruta URL /books, como http://192.168.10.15:3000/books. Si todo va bien, deberías ver el scaffold generado como el siguiente:

Ahora puedes insertar nuevos datos en el scaffold de libros como el siguiente:

Conclusión

En conclusión, has completado la instalación de Ruby on Rails con el servidor de base de datos PostgreSQL y Rbenv en el servidor Debian 12. También has aprendido cómo generar scaffolds para estructuras básicas para el proyecto Rails.