El proyecto final de la asignatura, consistirá en realizar un nuevo paquete. Con él, se conseguirá desplegar tanto en el Iaas como en Heroku, un book. Además se podrán registrar usuarios en el servicio web.
##Instalación
npm install -g proyecto-sytw-alex-moi Para ejecutar, ponemos el siguiente comando:
proyecto-alex-moi [opciones]
[opciones] serían:
- -a: Especificar el autor del gitbook
- -n: Especificar el nombre del gitbook
- -c: Especificar el nombre del directorio donde crear el gitbook
- -u: Especificar la url del repositorio git
- -h: Help (ayuda)
- -v: Versión del paquete
- --ip: Especificar ip en caso de despliegue en Iaas
- --path: Especificar ruta en caso de despliegue en Iaas
A continuación explicaremos como podemos desplegar el paquete y que es necesario exactamente.
Lo primero es configurar las 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
Introduzca el siguiente comando ssh-copy-id usuario@direccion-servidor-iaas
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.
Para crear la estructura de directorios del Gitbook ejecutamos:
proyecto-alex-moi -c nombre_directorio -u https://github.com/usuario/ejemplo.git --ip 10.6.128.1 --path /home/usuario (sin '/' al final de la ruta)
Y luego ejecutamos desde nombre_directorio:
npm link proyecto-sytw-alex-moiElija la opcion 1. Una vez instalado y ejecutado, en la carpeta que se ha creado hacemos:
npm install
gulp build
git init
git remote add origin url(del repositorio que ha puesto en la opcion -u)
git add .
git commit -m "haciendo cambios"
git push origin master
gulp deploy-iaasLo siguiente es acudir a nuestra máquina del IAAS y donde se ha creado la nueva carpeta ejecutar:
npm install
mongod --smallfiles
node server.js (en otra terminal)Su servicio estrá desplegada en http://ip:8080
Podrá disponer de un servicio web donde se registren, muestren los datos del usuario, acceda al book o en el caso de ser administrador, borrar cuentas de usuario. Para esto último es importante que registre una cuenta con el siguiente email: [email protected], puesto que es la única cuenta que tiene esa posibilidad.
Para crear la estructura de directorios del Gitbook ejecutamos:
proyecto-alex-moi -c nombre_directorio -u https://github.com/usuario/ejemplo.git
Y luego ejecutamos desde nombre_directorio:
npm link proyecto-sytw-alex-moiElija la opcion 2.
Una vez instalado y ejecutado, en la carpeta que se ha creado hacemos:
npm install
gulp build
git init
heroku git:remote -a nombreapp
gulp deploy-herokuLLegados a este punto ya tendremos nuestra aplicación en heroku desplegada y funcionando.
Podrá disponer de un servicio web donde se puede:
- Registrar y mostrar los datos de un usuario
- Acceder al book de la aplicación
- Descargar el book en pdf
En el caso de ser administrador también se permite: 5. Añadir/borrar cuentas de usuario 6. Establecer permisos de administrador a un usuario 7. Eliminar dichos privilegios de un usuario que los posea.
En la base de datos se encuentra creada una cuenta con el siguiente email: [email protected], que es el admin de la aplicación. Es IMPORTANTE que entre en la cuenta de este usuario con ese email y password: admin y modifique la password del mismo dado que sino cualquier usuario podrá acceder a ella como admin y manipularla a su antojo.
####Google authentication Los pasos a seguir para conseguir la autenticación mediante google en la aplicación son los descritos en el siguiente tutorial: Documentación
Los formatos de las rutas de origen deben ser similares a estos:
- c9: http://nameworkspace.c9users.io:8080
- localhost: http://localhost:8080
- heroku: https://nameapp.herokuapp.com
Los formatos de las rutas de callback deben ser similares a estos:
- c9: http://nameworkspace.c9users.io:8080/auth/google/callback
- localhost: http://localhost:8080/auth/google/callback
- heroku: https://nameapp.herokuapp.com/auth/google/callback
Una vez hecho esto bastará con copiar nuestro id, secret y callback en el fichero auth.js y luego descargar el json y meterlo en nuestro directorio. Es importante añadir el json(sección credenciales de la página) a nuestro directorio puesto que sino la autenticación mediante google no funcionará.
####Facebook authentication Los pasos a seguir para poner en funcionamiento la autenticacion con facebook son los que se exponen a continuación.
Lo primero será dirigirnos a la web Facebook developers y registrarnos en la pagina, te pedirá si aun no lo tienes hecho que confirmes tu cuenta mediante el envío de un código de verificación al móvil.
Una vez estas registrado, creas una nueva aplicación en la sección mis aplicaciones y te saldrá un cuadro como este :
Rellenamos nuestro tu correo, nombre de aplicación y en categoría seleccionamos 'aplicaciones para paginas'. A continuación introducir el captcha que nos pide.
En el menu de la izquierda de la pagina a la que nos redirecciona ir a Revisión de la Aplicación. Marcar SI donde se pregunta ¿Quieres que tu aplicación sea pública?.
A continuación hacer click en el menu de la izquierda en Panel. Luego copiamos nuestro id y nuestro secret en el fichero auth.js de nuestro directorio, cada uno en su correspondiente lugar y añadimos la callback
Los formatos de las rutas de callback deben ser similares a estos:
- c9: http://nameworkspace.c9users.io:8080/auth/facebook/callback
- localhost: http://localhost:8080/auth/facebook/callback
- heroku: https://nameapp.herokuapp.com/auth/facebook/callback
Volviendo a la pagina de developers de facebook en la sección de Panel hacemos clic en Elegir plataforma y luego clic en Sitio Web. Esto nos redirecciona a otra pagina, en ésta lo único que debemos hacer es dirigirnos al final del todo, a esta sección:
Y colocar la url de nuestra página por ejemplo, continuando con los ejemplos anteriores, la url debería tener la forma siguiente:
- c9: http://nameworkspace.c9users.io:8080
- localhost: http://localhost:8080
- heroku: https://nameapp.herokuapp.com
- Este paquete está actualizado. Utilice la última versión
- Alexander Cole Mora | Página Personal
- Moisés Yanes Carballo | Página Personal