#Práctica: Plugin para despliegues en Heroku

##¿Qué hace el módulo?

Este plugin extiende el paquete gitbook-start con un nuevo plugin que permita realizar el despliegue en Heroku con un simple gulp deploy-heroku. Puede encontrar el paquete gitbook-start y el otro plugin para el iaas-ull-es en la zona de Repositorio.

#####Instalación:

npm install --save gitbook-start-heroku-aitor-joshua-samuel

Para añadir el plugin al paquete gitbook-start ejecutar el siguiente comando:

gitbook-start -d heroku -p github --> Añades el plugin en gitbook-start para el despliegue con github
gitbook-start -d heroku -p local --> Añades el plugin en gitbook-start para el despliegue con local

#####Instrucciones:

• Al ejecutar el comando anterior, te pide el token de heroku y el nombre que quieres ponerle a la app
• El token de Heroku se puede obtener mediante el CLI de heroku con: heroku auth:token
• Una vez desplegado se puede desplegar en Heroku con la siguente tarea de Gulp:

gulp deploy-heroku --> Depsliega tu libro en heroku

Local

• Para el caso del depsliegue local, deberá añadir su token de dropbox y el link del archivo a descargar.
• Suba previamente el archivo users.json a Dropbox
• Obtener token de dropbox
• Rellene la URL para compartir el fichero y el token de Dropbox.
• Recuerde usar gitbook build para generar los HTML

{
    "url": "myUrl",
    "token": "myToken"
}

• Para Añadir un nuevo usuario puede hacer uso de la tarea de gulp: gulp new-user

Github

• Para el despliegue github debe rellenar el fichero userData.json con los siguientes campos:

1. La organización de acceso.
2. El token de github con los permisos necesarios.
3. La url callback de su github app.
4. El Client id de su github app.
5. El Client secret de su github app.

{
    "org": "myOrg",
    "token": "myToken",
    "url": "myCallbackUrl",
    "idClient": "myClientID",
    "secretClient": "mySecretClient"
}

Ejemplo

linux@user: gitbook-start -d heroku -p [github | local]
? Introduce tu token de Heroku: mi-token
? Introduzca el nombre de su app en Heroku: mi-aplicación
Aplicación creada: mi-aplicación

##Autores

1. Aitor Bernal Falcón
2. Samuel Ramos Barroso
3. Joshua Pérez García

##Repositorio

• Repositorio de entrega del main
• Repositorio de entrega del plugin heroku
• Repositorio de entrega del plugin iaas
• Enlace a NPM del main
• Enlace a NPM del plugin heroku
• Enlace a NPM del plugin iaas

##Enlaces de interés

• La práctica en gitbook