Configuración de una aplicación Rails 4 tradicional

Aplicación Rails tradicional vs SPA (Single Page Application)

Actualmente existen dos enfoques para desarrollar una aplicación web, el tradicional, que es impulsado por frameworks como Rails 4 y el de las SPA (Single Page Application).

En el enfoque tradicional tenemos todo nuestro código en una aplicación Rails. En ella tenemos toda la lógica de negocios en los modelos, el cómo la operamos en los controladores y la interfaz de usuario en las vistas. Programamos las vistas con Slim, Ruby y Sass, usamos gemas como simple_form para poder describir formularios en Ruby.

El enfoque SPA, por su lado, cuenta con dos aplicaciones, básicamente separadas: Un cliente web para la UI (en Javascript) y la aplicación servidor (Ruby+Rails). Esta separación nos lleva a diseñar la aplicación del servidor con una API JSON enfrente. Programamos las vistas con HTML, CSS y Javascript.

En principio, puede parecer atractiva la idea de hacer las vistas con Ruby y sus amigos, pero la verdad es que no hay como trabajar en el lenguaje del ambiente natural en donde se despliegan nuestras aplicaciones: Javascript.

En principio, también, puede parecer meh trabajar con HTML y amigos, sin embargo cuando descubres cosas como Grunt, Yeoman, Bower y AngularJS y lo que te permiten hacer en cuestión de organización del proceso de desarrollo, simplemente no puedes dar marcha atrás.

El desarrollo de la UI (User Interface) es en sí, un universo propio, requiere de herramientas adecuadas para poderla desarrollar de manera efectiva.

Ambos enfoques me agradan y he hecho buen uso de ellos en algunos proyectos que he desarrollado, sin embargo, me siento mucho más atraído por las SPA debido a la clara separación entre frontend y backend.

Proceso de creación

A continuación viene el comando que utilizo para crear una nueva aplicación Rails:

rails new NuevaAplicacion --skip-test-unit --database=postgresql

TODO: jruby con MS sqlserver

Prefiero minitest a testunit, y PostgreSQL a MySQL.

Inicializa git y realiza el primer commit.

cd NuevaAplicacion
git init
git add .
git commit -m "Commit inicial"

Proceso de configuración

Agrega el directorio de los IDEs de JetBrains a la lista de ignorados.

echo ".idea" >> .gitignore

Modifica Gemfile.

gem 'minitest-rails'
gem 'minitest-reporters'
gem 'pg'
gem 'slim-rails'
gem 'bootstrap-sass', '~> 3.0.0'
gem 'simple_form'

Instala las gemas.

bundle install

Genera configuraciones.

rails g minitest:install
rails g simple_form:install --bootstrap

Modifica config/application.rb

config.i18n.enforce_available_locales = true
config.time_zone = 'Mexico City'
config.i18n.default_locale = "es-MX"
config.sass.preferred_syntax = :sass
config.generators do |g|
  g.stylesheets false
  g.test_framework :minitest, :spec => true, :fixture => true
end

Crea un usuario y una base de datos para esta aplicación, revisa esta guía: Cómo instalar PostgreSQL en Ubuntu

Configura el host y el password en config/database.yml

development:
  host: localhost
  adapter: postgresql
  encoding: unicode
  database: NuevaAplicacion_development
  pool: 5
  username: NuevaAplicacion
  password: MiPalabraSecreta123

(Para las tres configuraciones: development, test & production).

Descarga el archivo es-MX.yml y ponlo en: config/locales/es-MX.yml
Lista de localizaciones para Rails

Modifica config/initializers/inflections.rb

ActiveSupport::Inflector.inflections(:en) do |inflect|
  inflect.clear
 
  inflect.plural(/$/, 's')
  inflect.plural(/([^aeéiou])$/i, '\1es')
  inflect.plural(/([aeiou]s)$/i, '\1')
  inflect.plural(/z$/i, 'ces')
  inflect.plural(/á([sn])$/i, 'a\1es')
  inflect.plural(/é([sn])$/i, 'e\1es')
  inflect.plural(/í([sn])$/i, 'i\1es')
  inflect.plural(/ó([sn])$/i, 'o\1es')
  inflect.plural(/ú([sn])$/i, 'u\1es')
 
  inflect.singular(/s$/, '')
  inflect.singular(/es$/, '')
 
  inflect.irregular('el', 'los')
end
Debes usar ActiveSupport::Inflector.inflections(:en) (en Inglés) para que Rails pluralice de forma adecuada nombres de rutas, controladores y modelos.

Crea app/assets/stylesheets/estilos.css.sass

@import "bootstrap"

Modifica app/assets/scripts/application.js

// Loads all Bootstrap javascripts
//= require bootstrap

Realiza el commit con los cambios en la configuración.

git add --all
git commit -m "Configuración inicial"

¡Listo, a desarrollar! ;)

Recursos

Inflexiones en español para Rails
Configurar usuario y base de datos en PostgreSQL

Cómo instalar PostgreSQL 9.3 en Ubuntu 14.04

Abre una terminal y teclea:

sudo apt-get install postgresql postgresql-client postgresql-contrib libpq-dev

Esto instala el cliente y servidor de la base de datos y algunos scripts de utilería. El paquete de libpq-dev nos servirá para poder compilar la gema Ruby para PostgreSQL más adelante.

Confirma que la instalación terminó adecuadamente tecleando:

psql --version

En mi caso la respuesta fue:

psql (PostgreSQL) 9.3.4

PostgreSQL Ruby gem

Si planeas usar PostgreSQL con Ruby, necesitarás esto:

gem install pg

En Rails, puedes crear una aplicación configurada para usar PostgreSQL así:

rails new mi-nueva-aplicacion -d postgresql

Asigna el host en database.yml

Si trabajas con Ruby y Rails, es posible que al ejecutar algunos comandos de base de datos, te encuentres con un error que dice algo como:

FATAL: Peer authentication failed for user “X”

Para evitarlo necesitas editar el archivo config/database.yml en tu aplicación Rails y agregar la línea siguiente en las tres configuraciones (development, test y production):

host: localhost

Cómo crear un usuario en la base de datos para la aplicación Rails

Para crear un usuario llamado usuario_ejemplo que puedas usar en tu database.yml, teclea:

sudo su postgres -c psql
CREATE USER usuario_ejemplo WITH PASSWORD 'xxxxxx';
ALTER ROLE usuario_ejemplo WITH CREATEDB;
\q

¡Listo! :D

Tuneando PostgreSQL

Es importante tunear el servidor PostgreSQL para tener un rendimiento aceptable en un ambiente de producción.
Checa esta excelente guía: PostgreSQL: HW Tunning

Recursos

Install PostgreSQL on Ubuntu 8.04 (cómo acceder a tu DB desde otras máquinas en la red).
Switching Rails to PostgreSQL
PostgreSQL — Guía Ubuntu Wiki
Is there a way to break into a PostgreSQL database if you forgot the password?
Improving the Command-Line Postgres Experience

Cómo instalar PostgreSQL en Ubuntu 11.04

[singlepic=668,160,,,left]

Acabo de incorporarme a un proyecto en Rails en el que usan PostgreSQL, y como recién formateé y le puse Ubuntu 9.04 a la laptop, necesito ahora instalar este manejador de base de datos.

Y es un buen pretexto para por fin escribir la guía de cómo instalarlo en Ubuntu.

Como siempre, vamos a la terminal (Aplicaciones → Accesorios → Terminal) y tecleamos:

1
sudo apt-get install postgresql postgresql-client postgresql-contrib libpq-dev pgadmin3

Eso instala el cliente y servidor de la base de datos, algunos scripts de utilería y la aplicación pgAdmin para administrar la base de datos. El paquete de libpq-dev nos servirá para poder compilar la gema Ruby de PostgreSQL más adelante.

Confirmemos que la instalación terminó adecuadamente teclando:

1
psql --version

En mi caso la respuesta fue:
psql (PostgreSQL) 8.4.7

Cambiar la contraseña del usuario administrador

Ahora necesitamos establecer la contraseña del usuario administrador postgres. Teclea la siguiente línea en la terminal (cambia la palabra password por la contraseña que desees usar):

1
2
3
sudo su postgres -c psql
ALTER USER postgres WITH PASSWORD 'password';
q

Eso altera la contraseña dentro de la base de datos, ahora necesitamos hacer lo mismo para el usuario Linux postgres:

1
2
sudo passwd -d postgres
sudo su postgres -c passwd

Te aparecerá un prompt, introduce la misma contraseña que pusiste antes.

Poner a punto pgAdmin

Listo, de ahora en adelante podemos usar pgAdmin o la terminal para administrar nuestra base de datos como el usuario postgres. Pero antes de que te metas a pgAdmin deberías configurar el PostgreSQL Admin Pack, que te permite llevar un mejor registro y monitoreo de tu base de datos.

Ejecuta lo siguiente desde la línea de comandos en tu terminal:

1
sudo su postgres -c psql < /usr/share/postgresql/8.4/contrib/adminpack.sql

Para ejecutar pgAdmin ve a tu menú de aplicaciones:
Aplicaciones → Programación → pgAdmin III

Cambiar el esquema de autentificación de PostgreSQL

Al ejecutar algunos comandos de base de datos, es posible que te encuentres con un error que dice algo como:

FATAL: la autentificación Ident falló para el usuario «x»

Para evitarlo necesitas editar el archivo /etc/postgresql/8.4/main/pg_hba.conf y cambiar el esquema de autentificación. Abre el archivo con privilegios de root:

1
sudo gedit /etc/postgresql/8.4/main/pg_hba.conf

Y cambia esto:

1
2
# Database administrative login by UNIX sockets
local   all         postgres                          ident

Por:

1
2
# Database administrative login by UNIX sockets
local   all         postgres                          md5

Reinicia el servidor de PostgreSQL tecleando en tu terminal:

1
sudo /etc/init.d/postgresql restart

PostgreSQL Ruby gem

Si planeas usar PostgreSQL dentro de Ruby, necesitarás esto:

1
gem install pg

Si deseas instalar la gema desde código fuente, sigue estas instrucciones.

En Rails 3, puedes crear una aplicación configurada para usar PostgreSQL con este comando:

1
rails new mi-nueva-aplicacion -d postgresql

¡Listo! :D

Recursos

Install PostgreSQL on Ubuntu 8.04 (cómo acceder de manera remota a tu servidor)
Switching Rails to PostgreSQL