gitbook-start-https-alex-moi

Sistemas y Tecnologías Web. Servidor https. 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, utilizando certificados de OpenSSL para disponer de un servidor HTTPS, 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-https 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 https
5. sudo mkdir -p /data/db/
6. openssl req -x509 -newkey rsa:2048 -keyout private.key -out certificate.pem -days 365 (deberá introducir dos veces una contraseña e información adicional no obligatoria)
7. openssl rsa -in private.key -out newkey.pem && mv newkey.pem private.key
8. Desde el mismo terminal ejecutar: mongod --dbpath /data/db --smallfiles (véase sección Observaciones)
9. Desde otro terminal: gulp deploy-https

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.66
• Paquete gitbook-start-https-alex-moi versión v0.0.8

Enlaces importantes

• Página en NPM gitbook-start-https-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