Instalando Rails
Lo primero que debes hacer es abrir una consola de comandos. En Mac OS X eso significa abrir la aplicación Terminal.app
. En Windows pincha sobre el menú de inicio y elige la opción Ejecutar
y teclea cmd.exe
.
Las líneas que empiezan por $
son los comandos que debes ejecutar en la consola. Lo primero es comprobar que tienes instalada alguna versión reciente de Ruby:
$ ruby -v ruby 2.0.0p353
Una vez comprobado que tienes tanto Ruby, para instalar Rails, usa el comando proporcionado por RubyGems gem install
:
$ gem install rails
Para verificar que tu instalación esté correcta, deberías poder ejecutar lo siguiente:
$ rails --version
Si dice algo como «Rails 4.1.1», estás listo para continuar
Creando la aplicación de Blog
Rails viene con un número de generadores que están diseñados para hacer tu ciclo de desarrollo más fácil. Uno de esos es el generador de nuevas aplicaciones, que crea la estructura base de una aplicación Rails, por lo que no tienes que escribirla por ti mismo.
Para usar este generador, abre la consola de comandos, navega hacia el directorio en donde tienes permiso para crear archivos, y ejecuta:
$ rails new blog -d mysql (Si no desea usar mysql usar el comando: rails new blog que utilizará por defecto sqlite).
Esto creará una aplicación Rails llamada Blog
en un directorio llamado blog
e instalará las dependencias (gemas) que están mencionadas en el Gemfile
usando el comando bundle install
.
Después de crear la aplicación, entra a su directorio para continuar trabajando directamente en la aplicación:
$ cd blog
El comando rails new blog
que acabamos de ejecutar, creó una carpeta en tu directorio de trabajo llamado blog
. El directorio blog
tiene un número de archivos autogenerados y carpetas que conforman la estructura de una aplicación Rails.
La mayoría del trabajo en este tutorial se llevará a cabo en la carpeta app/
, así que primero hagamos un repaso rápido al propósito de cada archivo y carpeta de Rails:
Archivo/Carpeta | Propósito |
---|---|
app/ |
Contiene los controllers, models, views, helpers, mailers y assets para tu aplicación. Te centrarás en esta carpeta por el resto de esta guía. |
config/ |
Configura las reglas de ejecución de la aplicación, rutas, base de datos y más. Este tema es cubierto en mayor detalle en Configuring Rails Applications. |
config.ru |
Configuración Rack para servidores basados en Rack usados para iniciar la aplicación. |
db/ |
Contiene el esquema actual de tu base de datos, así como las migraciones de la base de datos. |
doc/ |
Documentación detallada de tu aplicación. |
Gemfile Gemfile.lock |
Estos archivos te permiten especificar qué dependencias de gemas son necesitadas para tu aplicación Rails. Estos archivos son usados por la gema Bundler, ver Sitio web de Bundler |
lib/ |
Módulos extendidos para tu aplicación. |
log/ |
Archivos de Log de tu aplicación. |
public/ |
La única carpeta vista por el mundo tal como es. Contiene los archivos estáticos y assets compilados. |
Rakefile |
Este archivo localiza y carga tareas que pueden ser ejecutadas desde la línea de comandos. La lista de tareas son definidas a través de los componentes de Rails. En vez de cambiar el Rakefile, deberías agregar tus propias tareas, añadiendo archivos al directorio lib/tasks de tu aplicación. |
README.rdoc |
Este es un breve manual de instrucciones para tu aplicación. Deberías editar este archivo para comunicar a otros lo que tu aplicación hace, cómo configurala y demás. |
script/ |
Contiene el script de Rails que inicia tu aplicación y contiene otros scripts usados para deployar o correr tu aplicación. |
test/ |
Pruebas unitarias, fixtures y otras pruebas. Éstos son cubiertos en Testing Rails Applications. |
tmp/ |
Archivos temporales (como archivos de caché, PID y archivos de sesiones). |
vendor/ |
Lugar para código de terceros. En una típica aplicación Rails, ésta incluye librerías y plugins. |
Configurando base de datos MySql
development: adapter: mysql2 encoding: utf8 database: frasesror pool: 5 username: apeaime password: master host: localhost test: adapter: mysql2 encoding: utf8 database: frasesror pool: 5 username: apeaime password: master host: localhost production: adapter: mysql2 encoding: utf8 database: frasesror pool: 5 username: apeaime password: master host: localhost
El archivo de configuración se encuentra en la carpeta config del proyecto y el archivo es: database.yml
Lo único que deben de hacer es cambiar por el nombre de su base de datos, su usuario y su contraseña.
Si no desean crear la base de datos manualmente utilizar el siguiente comando:
rake db:create