Práctica 4. Sistemas y Tecnologías Web

Plugin: gitbook-start-iaas-ull-es-josue-nayra

Este plugin provee al paquete gitbook-start-josue-nayra del mecanismo necesario para realizar el despliegue en los servidores de iaas-ull-es de la ULL.

Paquete gitbook-start-josue-nayra

Pasos a seguir

1- Instalación del paquete gitbook-start-josue-nayra.

$ npm install -g gitbook-start-josue-nayra

2- Construir la estructura inicial del libro con el paquete instalado, por tanto se creará la jerarquía de directorios conteniendo los scripts y ficheros markdown para el libro

$ gitbook-start -d <directorio> --autor <nombre_autor> --name <nombre_libro> --url <url_repo>

3- Colocarse en la carpeta creada para nuestro libro e instalar las dependencias.

$ cd <directorio>
$ npm install

4- Instalar el plugin requerido como dependendecia con la opción --save, como por ejemplo: gitbook-start-iaas-ull-es-josue-nayra para el despliegue en iaas.

$ npm install --save gitbook-start-iaas-ull-es-josue-nayra 

5- Para la actualización de nuestro repositorio podemos ejecutar una de las tareas descritas en el gulpfile: gulp push --mensaje .

6- El usuario simplemente deberá tener su máquina IAAS encendida.

El plugin se encargará de realizar las siguientes tareas en el initialize:

• Copiar el fichero de clave pública 'id_rsa.pub' en la máquina del iaas para poder acceder a la máquina.

• Se clonará automáticamente el repositorio que contiene el libro.

7- Ejecutar el plugin:

$ gitbook-start --deploy iaas-ull-es --IP <ip> --path <ruta_maquina> --usuarioremoto <usuario_maquina_iaas>  

Opciones disponibles: --deploy --IP <ip de la máquina> --usuarioremoto <usuario de la máquina>

8- Una vez ejecutado el comando anterior, se generará automáticamente en el gulpfile.js una tarea llamada "deploy-iaas-ull-es" que permitirá al usuario actualizar el contenido de la máquina IAAS.

gulp.task("deploy-iaas-ull-es", function(){
    require(path.join(basePath, 'node_modules','gitbook-start-iaas-ull-es-josue-nayra')).deploy("10.6.128.176", "ea/", "https://github.com/JosueTC94/migitbook.git", "usuario");
});

NOTA: El despliegue en el IAAS se realizará por defecto en el puerto 8080. En el caso que quiera cambiarse hay que acceder al fichero app.js y modificarlo.

Tareas Gulp

• push

Tarea habilitada para que el usuario pueda actualizar el repositorio que contiene el gitbook. Está disponible una opción --mensaje para especificar el mensaje del commit.

$ gulp push --mensaje <mensaje del commit>

• deploy

Tarea deploy genérica que actualiza las gh-pages del gitbook.

$ gulp deploy

• deploy --iaas

Tarea generada posteriormente a la realización y ejecución del comando gitbook-start --deploy, que permite al usuario realizar posteriores despliegues y actualizaciones de su gitbook en la máquina remota con gulp. Por ejemplo, en el caso de que el usuario despliegue en el IAAS, después de haber desplegado con la opción gitbook-start --deploy iaas-ull-es, en el gulpfile se generará una tarea con el nombre deploy-iaas-ull-es.

$ gulp deploy-<máquina en la se ha desplegado previamente>

---

Enlaces

• Campus virtual

• Descripción de la práctica

• Publicación del paquete en npm

• Repositorio plugin

• Repositorio en Github.com del paquete gitbook-start

Referencias

• Tutorial para publicar paquetes nodejs

• Gulp

• Uso de templates

• Fyle System de Nodejs para el manejo de archivos

• Construyendo package.json

Integrantes

• Josué Toledo Castro Github personal
• María Nayra Rodríguez Pérez Github personal