Sistemas y Tecnologías Web. Gitbook Start LocalStrategy y MongoDB. Plugin

Este paquete es un plugin del paquete gitbook-start-alex-moi-nitesh. Ofrece la posibilidad de desplegar una aplicación basada en autenticación local mediante el uso de passport y MongoDB, la aplicación tiene como objetivo contener un gitbook al cual solo podrán acceder aquellos usuarios que estén registrados en la misma.

Instalación

Debemos tener instalado el paquete principal en global y creada la estructura de directorios(opción -c paquete principal). Con esto hecho NO es necesario instalar el paquete plugin iaas-bbdd puesto que al ejecutar la aplicación de la forma que se expone a continuación, ésta lo instala por nosotros.

Para poner en funcionamiento este paquete vaya a la sección de ejecución donde se explican los pasos.

Descripción del paquete

El paquete cuenta con dos métodos, intialize() y deploy(). El primero, al ser invocado por el paquete principal gitbook-start-alex-moi-nitesh el cual añadirá una tarea gulp al gulpfile.js de la aplicación. Esta tarea se llamará deploy-iaas-bbdd e invocará el método deploy() que se encargará de arrancar el server en la maquina del iaas.

SSH keys

Para conectarnos a la máquina del iaas, tenenmos que tener configurado la vpn de la ULL, y poder configurar un alias para conectarnos más rápidamente por ssh. Para ello crearemos en ~/.ssh un fichero config con el siguiente contenido:

Host sytw
	HostName dir_ip_máquina
	User usuario

Con esto podremos conectarnos sin ningún problema a la máquina. También es necesario tener generado en la máquina del iaas las claves para utilizar repositorios Github. Puede encontrar la documentación apropiada en este link.

##Ejecución

Lo primero será, en nuestra máquina local, instalar el paquete principal en global y seguir los pasos de ejecución explicados aquí.

A continuación, ejecutaremos el paquete del iaas-ull-es para subir nuestro Gitbook a la máquina del IaaS.

Ejecutamos desde el directorio de nuestro gitbook (asegúrese de haber instalado todas las dependencias antes con npm install:

gitbook-start-alex-moi-nitesh -d iaas-ull-es --iaas_ip <direccion_ip> --iaas_path /home/nombre_usuario/ruta

Es importante que no ponga '/' al final de la ruta y en nombre_usuario el usuario de su maquina (generalmente usuario)

Si no ha introducido en el package.json->repository.url una direccion de un repositorio, póngala(version http).

A continuación, ejecute lo siguiente:

1. gulp build le creará en la carpeta gh-pages el libro
2. Suba sus cambios a github git add . git commit -m "cambios" git push origin master
3. gulp deploy-iaas le creara en su maquina iaas su libro

Si en algun momento hace algún cambio en su libro, vuelva a ejecutar los anteriores comandos.

Una vez hemos realizado los pasos anteriores, es decir, una vez hemos subido nuestro Gitbook al IaaS tendremos nuestro directorio Gitbook allí. Por tanto, nos movemos a dicho directorio y ejecutamos los comandos que se exponen a continuación:

1. npm install -g gitbook-start-alex-moi-nitesh
2. npm install
3. gulp build
4. gitbook-start-alex-moi-nitesh -d iaas-bbdd
5. sudo mkdir -p /data/db/
6. sudo chmod 0755 /data/db && chown $USER /data/db
7. Desde el mismo terminal ejecutar: mongod --dbpath /data/db --smallfiles (véase sección Observaciones)
8. Desde otro terminal: gulp deploy-iaas-bbdd

#####Observaciones:

• Debe tener instalado la base de datos mongoDB en su maquina, en caso contrario siga estos pasos (Sólo será necesario realizar los 4 primeros pasos).

##Versiones de los paquetes

• Paquete principal gitbook-start-alex-moi-nitesh versión v1.2.63
• Paquete gitbook-start-iaas-bbdd-moi versión v0.0.14

Enlaces importantes

• Página en NPM gitbook-start-heroku-localstrategy-alex-moi Plugin
• Página en NPM gitbook-start-alex-moi-nitesh
• Repositorio GitHub
• Descripción de la práctica
• Campus Virtual

Autores

• Alexander Cole Mora | Página Personal
• Moisés Yanes Carballo | Página Personal