hitos_proyecto/hito_3.md
## Hito 3
En este hito, el principal objetivo era desplegar el sistema en un PaaS, de forma que conociesemos las diferentes posibilidades de PaaS y como funcionan.
En mi caso he elegido Heroku. El motivo por el que he elegido este servicio es que es gratuito y cumple con los requisitos de entrega de este hito. Además, ya conocía este PaaS de haberlo utilizado antes en proyectos personales, por lo que es un añadido el hecho de conocer el servicio, y conocer algunos de los problemas que me había encontrado antes (por ejemplo al subir una aplicación con una base de datos Mongo y tareas Grunt).
Mi proyecto hace uso de dos bases de datos: MongoDB y Redis, además de servir la aplicación web a través de Express (NodeJS). Para configurar estas bases de datos me he registrado en [MongoLab](http://mongolab.com/) y [RedisLabs](http://redislabs.com/), ya que estos servicios ofrecen bases de datos de forma gratuita (aunque con limitación de espacio). Una vez tenía las bases de datos creadas en estos servicios DBaaS (Database as a Service), he adaptado la aplicación para que use las bases de datos creadas y no las bases de datos locales. Para ello, he hecho uso de las variables de entorno, que es como suele hacerlo todo el mundo. En mi aplicación NodeJS, solamente hago uso de las variables de entorno con variables del tipo `process.env.MONGODB_URL` o `process.env.REDIS_URL`. En el fichero principal de la aplicación [app.js](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/blob/master/app.js) podemos ver, justo al principio, como obtengo las variables de entorno necesarias (de las BD y otras) para poder hacer funcionar la aplicación correctamente. En el modo en el que esta hecho, se utilizan las variables de entorno si estás están fijadas, en caso de que no se hayan configurado se utilizará una configuración por defecto para conectar la aplicación a BDs locales (usando los puertos habitules).
Una vez tenemos las variables de entorno configuradas en el panel de Heroku, la aplicación debe funcionar perfectamente al desplegarla. Para desplegar la aplicación he configurado Travis, de forma que, al pasar los tests, la aplicación se despliegue en Heroku automáticamente. Para ello, he configurado Heroku en el fichero [.travis.yml](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/blob/master/.travis.yml). Como podemos ver, lo he configurado de forma que solamente desplegará el sistema cuando hagamos push sobre la rama `production`(evidentemente después de comprobar que esta rama supera satisfactoriamente los tests). Además, solamente hará el despligue para la versión `0.10.13` de NodeJS, por lo que el requisito será que los tests de Travis de esa versión pasen los tests. De este modo conseguimos que el despliegue funcione bien, pues si ponemos esta restricción se tratará de hacer el despligue al mismo tiempo cuando se pasen los tests de todas las versiones que tengamos configuradas. Además, la versión que nos interesa que funcione es la `0.10.13`, pues es la que hemos indicado en el fichero [package.json](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/blob/master/package.json) y la que usará Heroku para hacer funcionar nuestra aplicación. El motivo de usar esta versión (que no es de las más recientes) es que es la que uso en mi ordenador para pruebas en local, y con ella se instalan correctamente las dependencias necesarias para la aplicación (concretamente la librería de Mongo, que es la que me ha dado problemas en otras versiones; por algún motivo en Heroku me ha dado problemas).
También debemos tener en cuenta el fichero [Procfile](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/blob/master/Procfile), en el que se le indica a Heroku como iniciar la aplicación web. Sin el nuestra aplicación no funcionará.
Con todo esto configurado, lo único que tenemos que hacer para desplegar nuestra aplicación en Heroku es hacer `git push origin production` para subir los cambios en la rama "production". Una vez hacemos push, Travis pasará los tests al código, y en caso de que todos pasen correctamente en la versión `0.10.13` de Node, desplegará la aplicación en Heroku haciendo uso de la API y del token cifrado indicado en el fichero [.travis.yml](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/blob/master/.travis.yml). Obteniendo el siguiente resultado en el test de Travis:
Y el siguiente resultado si consultamos el log de Heroku con `heroku logs`
Como podemos ver, Heroku ha recibido las peticiones a través de la API para hacer el despliegue, y se ha realizado correctamente.
Y con todo esto, ya tenemos todo funcionando para desplegar de forma sencilla nuestra aplicación, al mismo tiempo que se comprueba que todo sigue funcionando correctamente. Fácil, rápido y para toda la familia. Ahora, solamente tenemos que ir añadiendo funcionalidad a la rama `master`, y cuando este lista toda la funcionalidad que deseemos desplegar, simplemente hacemos `merge` de las ramas master y production, y hacemos push de la rama production.
La aplicación desplegada en su última versión está disponible en: http://osc-test.herokuapp.com/
Adicionalmente, a los objetivos práctica de la asignatura, se han añadido otros objetivos para avanzar en el desarrollo del proyecto. En este hito se ha comenzado a trabajar en la parte del cliente, añadiendo los formularios de inicio de sesión y registro de usuarios en el sistema. Ambos son totalmente funcionales y generan, como se había pensado en un principio, las claves de cifrado para el uso del sistema (además de preparar y cifrar los datos para enviarlos y guardarlos en la BD del servidor de forma segura). Para ello, se han creado una serie de "issues" y "milestones" en Github, de forma que supiesemos en todo momento cuales eran los objetivos que se deseaban cumplir en este hito. En estos issues, se indica también los commits en los que se cumplen y resuelven. Se pueden ver [aquí](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/issues?q=is%3Aissue+is%3Aclosed) y [aquí los milestones](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/milestones).
Además, se incluye un fichero [deploy_setup.sh](https://github.com/segura2010/CC-Proyecto-OpenSecureChat/blob/master/deploy_setup.sh), en el que se indican los comandos necesarios para crear la aplicación en Heroku (PaaS que he decidido utilizar) y para modificar las variables de entorno, en caso de que se desee hacer (para configurar las bases de datos, el puerto de la web Express y la longitud de la clave de cifrado). A parte de crear la aplicación en Heroku (es más fácil hacerlo en su panel web), no hace falta nada más para hacer deploy, a parte de crear las variables de entorno en Heroku para que todo funcione correctamente. Para ello, se proporcionan también en el script los comandos con los que se pueden configurar las variables de entorno de nuestra aplicación en Heroku. Podemos usar esos comandos (modificando como necesitemos los valores de las variables, para configurar nuestra aplicación Heroku).
Evidentemente, los datos de configuración en en fichero .travis.yml en los que se indica el token de Heroku cifrado y el nombre de la app, deben cambiarse para que funcione correctamente el despliegue automático en "forks" de la aplicación que configuren su repositorio de Travis.
Finalmente, no se han añadido al script los comandos básicos y típicos de NodeJS, pero esta claro que para poder hacer funcionar la aplicación en local (en Heroku lo hará automáticamente) es necesario instalar las dependencias con `npm install` y ejecutar las tareas necesarias de Grunt para que se instalen las librerías de Bower y se generen los ficheros necesarios (de CSS y JS comprimidos). Para ejecutar dichas tareas será necesario ejecutar el comando: `grunt`. La tarea por defecto generará los ficheros necesarios, comprimidos para poner la aplicación en producción. En caso de querer una "versión de desarrollo", en la que no comprime los ficheros JavaScript del cliente, de forma que sea más fácil resolver errores, se puede ejecutar la tarea `grunt dev`.
En Heroku por defecto se ejecutará la tarea "setup" (`grunt setup`), que prácticamente igual que `grunt`, pero sin perder tiempo en generar la documentación. Para que Heroku ejecute estás tareas al hacer el despliegue es necesario indicar en el Package.json la opción "postinstall", que se encargará de ejecutar `grunt setup` después de instalar las librerías con `npm install`. De hecho, ni siquiera es necesario ejecutar grunt en local, pues después de hacer `npm install` se ejecutará la tarea grunt necesaria.