gitbook-start-plugin-iaas-ull-es-ericlucastania

Práctica IAAS[PLUGIN]

Descripción de la práctica.

El objetivo de la práctica es llegar a que el usuario puede descargar el plugin gitbook-start-iaas-ull-es-ericlucastania y el paquete gitbook-start-elt de manera local en su maquina.El usuario tiene que tener en cuenta que tiene que tener previamente un cuenta en el iaas y tener un clone de su repositorio. Una vez que se tiene claro los anteriores comenzamos a explicar los pasos llevar a cabo el correcto funcionamiento de la práctica

Pasos a seguir

• Comprobar que tienes cuenta en el iaas,en caso de no tener cuenta no podrás llevar a cabo la práctica
  • Enlace al login del iaas

Pasos a ejecutar

1. Instala nuestro paquete de forma global

npm install -g gitbook-start-elt

2. Ejecuta el binario para el render del template

Tienes la opción de crear el repositorio o la opción de no crearlo:

Crear repositorio

• Si quieres que te cree un repositorio en Github tienes que poner la opción --repo

  gitbook-start --dir Carpeta --repo

Cuando ejecutes el paso anterior si no es la primera vez que lo haces te pedirá el usuario y contraseña de github.Si introduces los datos correctamente te pedirá que introduzcas el nombre que quieres ponerle al repo, Ahora se desplegará el libro en github:

Ejemplo de uso:

Una vez que se te creado el repo ya puedes trabajar en él,ya no tendrás que poner más el usuario y contraseña gracias a que se te generó un token para evitar que cada vez que quieras crear un repo te pida tus credenciales. El token que se genera se guarda en el ./gitbook-start/config.json un lugar seguro para que no pueda acceder nadie que no seas tu.

La siguiente función es la que se utiliza para guardar el token que se obtiene

    auth().then(function (resolve, reject) {
                    fs.mkdirSync(directorioHome + '/.gitbook-start');
                    var pac = directorioHome + '/.gitbook-start/';
                    fs.writeFile(pac + 'config.json', JSON.stringify(json), function (err) {
                        if (err) throw err;
                        else resolviendo(console.log("guardando el json correctamente.."));
 
                    });
                });

3. Entra en la carpeta

cd Carpeta

PLUGINS

1. Instala el plugin forma global

npm install -g gitbook-start-plugin-iaas-ull-es-ericlucastania

2. Cambia los datos del package.json que tiene el directorio que has creado en nuestro caso de llama Carpeta

Instrucciones de uso

Tenga en cuenta que para que el plugin funcione correctamente debe cambiar algunas cosas en el package.json

• Deberá poner la IP de su maquina del iaas.

• Tenga en cuenta que si el usuario de su máquina no es "usuario" deberá también cambiar esto en el fichero package.json

3. Ejecuta el plugin que desees, asegúrate de estar dentro de la carpeta

gitbook-start -d iaas !! También puedes usar la opción --deploy

4. Ejecuta el gulp creado

gulp deploy-iaas

Si se realiza este paso correctamente se clonara el repo creado y se instalarán las dependencias automaticamente en el IAAS

Entrar en el IAAS

El siguiente paso que deberás realizar es acceder al tu cuenta del iaas y si has seguido los pasos hechos anteriormente,te deberá aparecer una carpeta llamada Gitbook,en ella tienes la clonación del repo Por último ejecuta

    node app*

Ahora simplemente pon ti IP y el puerto en el navegador y podrás acceder al login del Gitbook

Si no te has registrado anteriormente hazlo clicando en la parte que aparece justo encima del botón login

Y en caso de estar registrado pon tus datos y si son correctos te llevará al Home donde tendrás la opción de ver tu profile o acceder al gitbook.

Si quieres cambiar la contraseña accede desde el login a Cambiar contraseñadd

Explicación

Cunado se ejecuta el gitbook-start -d iaas se te lanzará el initialize del módulo, el initialize crea una tarea en el gulp para realizar el deploy. Además de guardarte el paquete elegido en el package.json.

Opciones

gitbook-start [OPTIONS]
    --dir nombre_del_directorio a crear gitbook-start --dir miDirectorio
    -a autor del libro a crear node gitbook-star -a AutorDelLibro
    -e email del autor del libro node gitbook-star -e [e-mail]
    -r repositorio github contra el que se va a trabajar -r nameRepo
    -v muestra la version del paquete gitbook-start -v
    -h muestra ayuda sobre las opciones disponibles
    --repo opción que te permite crear un repositorio en GitHub

Enlaces interesantes

• Repositorio Práctica
• Descripción de la práctica
• PLUGIN IAAS
• NPM PLUGIN IAAS

Componentes del grupo de trabajo

• Eric Ramos
• Lucas Ruiz
• Tania González