makelele29/geoke-web repository overview

⁠Web Geoke

⁠Descripción

La web está diseñada para darle apoyo a la aplicación en android Geoke (TFG), dicha aplicación consiste en jugar a las gymkhanas creadas cerca de ti, ya sean tuyas o de otro usuario.

Está diseñada especialmente para ayuntamientos y colegios que son los que más utilizan este tipos de juegos.

Consistirá en que los usuarios puedan crear, eliminar y editar gymkhanas, además, dichos usuarios tendrán la oportunidad de ver estadísticas sobre las gymkhanas que han jugado y los ranking de los mejores de cada gymkhana.

⁠Servicios necesarios

⁠Servidor de base de datos

• Base de datos para usuarios
• Base de datos para la creación de gymkhanas, estadisticas, ranking, etc.
• Base de datos para almacenar las localizaciones de los usuario

⁠Requisitos

• Mongodb server
• MySQL server
• nodejs
• npm

⁠Ejecución

⁠Instalación

npm install
sudo service mongod start
npm start

⁠Test

npm test

⁠Instalación del contenedor

Instalar docker⁠

Hay dos maneras de crear el contenedor:

• Local: Se deberá clonar o copiar el repositorio y ejecutar el siguiente script.

  ./script/docker.sh
  

  Copy

• DockerHub: Solo se tendrá que ejecutar estos comandos.

  docker run -d --name mongoDB mongo
  
  docker pull makelele29/geoke-web
  
  docker run --link=mongoDB:mongodb -it makelele29/geoke-web
  

  Copy

⁠Despliegue automático

⁠Instalación

• Instalar Vagrant⁠

  • Instalar el plugin para Vagrant de Azure

    vagrant plugin install vagrant-azure --plugin-version '2.0.0.pre1'
    

    Copy

• Instalar Ansible

  sudo apt-get install ansible
  

  Copy

⁠Configuración

Para la configuración se deben hacer cambios en el Portal de Azure y sacar varias variables de las cuales se debe hacer export.

export AZURE_TENANT_ID="****************"
export AZURE_CLIENT_ID="****************"
export AZURE_CLIENT_SECRET="****************"
export AZURE_SUBSCRIPTION_ID="****************"

Todo este proceso se explica detalladamente aqui⁠

⁠Despliegue

Instalar fabric

  sudo apt install fabric

Las funciones que contiene el fichero fabfile.py son:

• install: Para instalar el modulo forever
• start: Para ejecutar la aplicación
• test: Para ejecutar los test
• stop: Para parar la aplicación
• restart: Para reiniciar la aplicación
• pull: Para actualizar el repositorio y reiniciar la aplicación

Para usarlo simplemente utilizamos el comando:

fab vagrant@DNS_VM <funcion>