Skip to content

gstn-caruso/tsundoku

Repository files navigation

Build Status

Cómo se usa

Cómo configurar el entorno de desarrollo

Clonar el proyecto

Lo primero que debemos hacer es git clone git@gitlab.com:unq-tpi-eis-alumnos-2017-s1/grupal-tsundoku.git

Instalando Ruby

Una vez descargado el proyecto, lo siguiente que debemos hacer es instalar un manejador de versions de Ruby, en nuestro caso utilizaremos RVM. Las instrucciones de instalación las podemos encontrar haciendo click acá. Habiendo instalado RVM como nos indica la documentación oficial, abrimos una consola y nos posicionamos en el directorio raíz del proyecto y seguimos las instrucciones que RVM nos indica por consola, esto nos instalará la versión adecuada del intérprete de Ruby. Es un proceso que puede llevar un tiempo, ya que lo que hace es descargar el código fuente del intérprete y compilarlo en nuestra máquina.

Instalando PostgreSQL

Es un procedimiento extenso de documentar, así que te pido que trates de buscar por tu cuenta hasta que pueda finalizar la documentación. Es necesario que realices la instalación antes de continuar.

Instalando Ruby on Rails

Antes que nada, lo primero que deberíamos hacer es ejecutar ruby -v y asegurarnos de que la versión de Ruby que estamos utilizando, es la que esperamos (la que se indica en el Gemfile). Lo siguiente que debemos hacer es instalar Bundler, un gestor de gemas. Esto lo haremos ejecutando gem install bundler. Finalmente utilizamos Bundler para instalar todo lo especificado en el Gemfile ejecutando bundler install. Si no hemos instalado PostgreSQL este proceso fallará, ya que no va a poder instalar la gema pg.

Configurando Ruby on Rails

Una vez instalado todo lo necesario, debemos dejar que Rails configure las bases de datos. Utilizaremos dos bases de datos, una para desarrollo, que es la que guardará los datos que generemos cuando ejecutemos la aplicación localmente y otra para test, que es la que se crea cada vez que ejecutamos un test. Para hacer esto, Rails espera que exista un achivo llamado Database.yml ubicado dentro del directorio config/. Dado que no existe y es una mala práctica subirlo, ya que aquí debemos poner nuestras credenciales de PostgreSQL, este archivo fue agregado al .gitignore y debemos generarlo, podemos copiar el que utiliza Gitlab-Ci y agregarle nuestras credenciales, esto lo podemos hacer ejecutando cp config/database.yml.gitlab config/database.yml. Una vez generado nuestro archivo de configuración, lo que debemos hacer es indicarle a Rails que genere las bases de datos, ejecutando rails db:setup y podemos probar si todo funciona adecuadamente iniciando la aplicación ejecutando rails s.

Configurando la IDE

En este caso recomiendo utilizar Rubymine, requeire la JDK, preferentemente superior a 1.8 de Oracle. Podemos descargar lo necesario de la página de Jetbrains. Inicialmente tenemos un período de prueba de 30 días, pero podemos utilizar una prueba de 1 año si lo solicitamos con la cuenta de mail provista por la UNQ.

Una vez instalado el programa, si queremos asegurarnos de que estamos utilizando la versión adecuada del intérprete de Ruby yendo a Settings > Languages & Frameworks > Ruby SDK and Gems, aquí deberá aparecer seleccionada la versión que esperamos usar de Ruby.