##Instalación
####Requisitos previos:
1.- Lo primero es instalar Node.js. Para ello primero instalamos el paquete python-software-properties que nos permite añadir repositorios mediante el comando add-apt-repository. Seguidamente añadimos el repositorio para instalar Node.js, actualizamos la lista de paquetes e instalamos nodejs.
sudo apt-get install python-software-properties
sudo apt-add-repository ppa:chris-lea/node.js
sudo apt-get update && sudo apt-get install nodejs
Comprobamos que Node.js y NPM (su gestor de paquetes) se han instalado correctamente.
node -v
npm -v
####Descarga del proyecto:
2.- Descargamos todo el contenido del repositorio para poder ejecutar la aplicación. Es preferible que siempre hagamos el clonado de un repositorio mediante SSH para lo que es necesario que primero hayamos subido nuestra clave SSH a GitHub. En la propia página de GitHub explican como hacerlo desde aquí.
-
Mediante el uso de git:
$ git clone https://github.com/rosanamontes/Teranga.Go.git -
A través de la interfaz web, utilizando el botón "Download ZIP"
####Puesta en marcha de la base de datos de prueba:
$ mysql -u root -p[root_password] < Teranga.Go/tfgdata.sql
La instrucción anterior creará la base de datos necesaria así como creará al usuario (tfg) con los permisos pertinentes para que el servidor pueda conectarse a la misma. (Recomendado poner un espacio antes de la órden para no registrar la misma, junto con la contraseña, en el historial)
##Ejecución
-
Ejecución directa con node / nodemon
$ cd Teranga.Go/ && node server.js -
Mediante un script de inicio del archivo
package.json. Es imprescindible que ejecutemos este script con permisos de superusuario debido a que los archivos de registro se almacenarán en directorios que requieren dichos permisos. Desde stos scripts podemos cambiar el puerto y la IP del host
{
...
"scripts": {
"start": "PORT=3000 IP=127.0.0.1 node server.js",
...
}
sudo npm start
##Acceso
Desde cualquier navegador (recomendado chrome):
localhost:8080
Para acceder a la API REST (web-service), basta con realizar una petición GET, POST o PUT al servidor, dependiendo de la acción deseada (recomendado usar la aplicación POSTMAN)
##Actualización a la última versión:
Desde la misma carpeta que se ejecutó el clone:
$ cd Teranga.Go/ && git pull