Jobs DSL

Este proyecto genera mediante codigo en groovy, 2 pipelines y 2 jobs en jenkins

Plugins de Jenkins necesarios

• Job DSL
• GitHub plugin

Plugins utilizados dentro de los Jobs y Pipelines

• NodeJS Plugin
• SonarQube Scanner for Jenkins
• Docker Pipeline

Como ejecutar el proyecto

1. Generar una nueva tarea de estilo libre en Jenkins.
2. Configurar el origen del codigo fuente en Git.
   • Ingresar la URL del repositorio: https://github.com/manfer993/jobs-dsl.git
   • Especificar la rama del repositorio: /master
3. Establecer a Github hook trigger como disparador de ejecuciones.
4. Añadir un paso para ejecutar de tipo: Process Job DSLs
   • Ingresar el nombre de los DSL scripts que se van a construir:
     • jobNodejsApp.groovy
     • pipelineNodejsApp.groovy
     • pipelineReact.groovy
5. Guardar.
6. Construir el proyecto.
   

La primera construcción del proyecto va a fallar puesto que Jenkins necesita que sean aprobados los scripts antes de construirlos.

7. Ingresar a Manage Jenkins > In-process Script Approval.
8. Aprobar los 3 Scripts del proyecto.
9. Construir el proyecto nuevamente.
   

Ahora se deben haber generados los 2 nuevos pipelines y los 2 nuevos jobs dentro del workspace de Jenkins

Project Name	Type	General description of the project
Portafolio_backend_test	Freestyle	Run a test case to API REST services with Newman
Portafolio_deploy_docker	Pipeline	Build an angular App and deploy it in a nginx container
Portafolio_deploy_heroku	Freestyle	Build an angular App and deploy it in Heroku
ReactApp_deploy	Pipeline	Build a react App and deploy it in the localhost waiting to test

Proyecto Portafolio_backend_test

• Script groovy que genera el proyecto: jobNodejsApp.groovy.
• Url del proyecto: https://github.com/manfer993/test-postman-newman.git
• Rama del repositorio: */master.
• Pre-requisitos Jenkins:
  • Plugin NodeJS.
  • Instalar Nodejs version 10.15.3 dentro de Jenkins, ruta: manage jenkins > Global Tool Configuration > NodeJS.
• Pasos del Freestyle job:
  • Obtener codigo fuente.
  • Proporcionar nombre de la instalacion de NodeJS, Provide Node & npm bin/ folder to PATH.
  • Instalar dependencias del proyecto mediante linea de comando shell npm install.
  • Correr test case de postman exportado en formato Json mediante Newman mediante linea de comando shell npm run test.

Proyecto Portafolio_deploy_docker

• Script groovy que genera el proyecto: pipelineNodejsApp.groovy.
• Url del proyecto: https://github.com/manfer993/portafolio.git
• Rama del repositorio: */development.
• Pre-requisitos Jenkins:
  • Plugins NodeJS, SonarQube Scanner.
  • Tener instalado docker dentro del servidor de Jenkins.
  • Instalar Nodejs version 10.15.3 dentro de Jenkins, ruta: manage jenkins > Global Tool Configuration > NodeJS.
• Pasos del Jobs DSL:
  • Establecer los push de github como disparador de la construccion.
  • Programar a Jenkins para que consulte cambios en el repositorio cada 5 minutos.
  • Definir el pipeline mediante script dentro del repositorio en el documento jenkinsfile.
• Pasos del Pipeline dentro del Jenkinsfile:
  • SCM: obtener codigo fuente.
  • Install node modules: instalar modulos del proyecto npm install.
  • Build project: Construir el proyecto npm run build.
  • Scan project: escanear el proyecto con sonarqube.
  • Build image: crear imagen base docker.build("ferman18/nodejs_app_dev") utilizando el dockerfile que se encuentra en la raiz del proyecto.
  • Validate container existence: validar que no exista un contenedor con el mismo nombre.
  • Create container: Crear contenedor con la imagen previamente creada y exponerlo por el puerto 8085.

Proyecto Portafolio_deploy_heroku

• Script groovy que genera el proyecto: jobNodejsApp.groovy.

• Url del proyecto: https://github.com/manfer993/portafolio.git

• Rama del repositorio: */development.

• Pre-requisitos proyecto:

  • Tener un proyecto en HerokuApp llamado ci-node-app
  • Tener un repositorio publico dentro de DockerHub llamado nodejs_app_dev

• Pre-requisitos Jenkins:

  • Plugins NodeJS, docker build and publish.
  • Tener instalado docker dentro del servidor de Jenkins.
  • Instalar Nodejs version 10.15.3 dentro de Jenkins, ruta: manage jenkins > Global Tool Configuration > NodeJS.
  • Tener credenciales repositorio de Heroku
  • Tener credenciales repositorio de DockerHub
  • Instalar sonar scanner dentro de Jenkins, ruta: manage jenkins > Global Tool Configuration > SonarQube scanner.
  • Configurar SonarQube servers dentro de Jenkins, ruta: manage jenkins > Configure System > SonarQube servers ingresando la URL y llave de autenticacion generada en el servidor de SonarQube.

• Pasos del Freestyle job:

  • SCM: obtener codigo fuente desde el repositorio de git y heroku, definiendo el remote configurados en el versionamiento de codigo, definicion de usuario y correo para git
  • Triggers: Establecer los push de github como disparador de la construccion.
  • Triggers: Programar a Jenkins para que consulte cambios en el repositorio cada 5 minutos.
  • Wrappers: Proporcionar nombre de la instalacion de NodeJS para que el servidor Jenkins pueda utilizar las funcionalidades de NodeJS, Provide Node & npm bin/ folder to PATH.
  • Steps: Instalar el cliente de angular dentro del servidor de Jenkins npm install @angular/cli.
  • Steps: Instalar modulos del proyecto npm install.
  • Steps: Construir el proyecto npm run build.
  • Steps: Dockerizar la aplicacion y construir la imagen en DockerHub, haciendo referencia a un usuario / repositorio existente en dockerHub ferman18/nodejs_app_dev y proporcionando las credenciales respectivas. Esta construccion consulta el archivo dockerfile ubicado dentro de la raiz del proyecto.
  • Steps: Validar que no exista un contenedor con el nombre portafolioDev y en el caso de que exista se detiene y borra dicho contenedor.
  • Streps: Crear contenedor con la imagen previamente creada, con el nombre portafolioDev y exponerlo por el puerto 8085.
  • Publishers: Hacer un push en la rama */master del repositorio de heroku para que este realice la publicacion de la aplicacion en el proyecto ci-node-app el cual se expone en la URL https://ci-node-app.herokuapp.com/

• Faltantes

  • Ingresar al Job Portafolio_deploy_heroku.
  • Addicionar un nuevo Step de tipo Execute SonarQube Scanner.
  • Ubicar este paso despues de la construccion del proyecto.
  • Ingresar el siguiente script dentro del campo Analysis properties:

sonar.projectKey= build_NodeJs_App
sonar.projectName= build_NodeJs_App
sonar.projectVersion=1.0
sonar.sourceEncoding=UTF-8
sonar.sources=src
sonar.exclusions=**/node_modules/**,**/*.spec.ts,**/dist/**,**/docs/**,**/*.js,**/e2e/**,**/coverage/**
sonar.tests=src/app
sonar.test.inclusions=**/*.spec.ts
sonar.ts.tslint.configPath=tslint.json

Proyecto ReactApp_deploy

• Script groovy que genera el proyecto: pipelineNodejsApp.groovy.
• Url del proyecto: https://github.com/manfer993/simple-node-js-react-npm-app.git
• Rama del repositorio: */master.
• Pre-requisitos Jenkins:
  • Tener instalado docker dentro del servidor de Jenkins.
  • Tener instalado NodeJs dentro del servidor de Jenkins.
• Pasos del Jobs DSL:
  • Establecer los push de github como disparador de la construccion.
  • Definir el pipeline mediante script dentro del repositorio en el documento Jenkinsfile.
• Pasos del Pipeline dentro del Jenkinsfile:
  • Build: Construir el proyecto, instalando los modulos del proyecto npm install.
  • Test: Correr las pruebas del proyecto por medio del comando react-scripts test --env=jsdom.
  • Deliver: Desplegar la aplicacion en un ambiente local expuesto por el puerto 300, a la espera de que se pruebe para culminar el pipeline.