Está en la página 1de 23

INTEGRACIÓN CONTINUA CON JENKINS EN UN PROYECTO (MAVEN, GITHUB,

WILDFLY, ECLIPSE)

Elaborado por: Diego Carvajal – Sergio Gaspar, Mayo 29 de 2016.

En este tutorial se creará un proyecto sencillo Maven, que será enlazado a un repositorio
en GitHub (brindando la posibilidad de ser trabajado por distintos usuarios desde otros
computadores), para luego ser integrado con Jenkins que será el encargado de generar
el archivo .war que será puesto en el servidor de aplicaciones (WildFly).

Creación Proyecto Maven en Eclipse


En el eclipse IDE, se hace clic sobre File>New>Maven Project, en caso de no estar
esta opción, en Other… (Ctrl+N) se busca Maven>Maven Project.

En la ventana emergente, se deja todo por defecto y se hace clic en Next.


A continuación, se digita maven-archetype-wep, y se hace clic en Next.

En la siguiente ventana, se digita el Group Id y Artifact Id del proyecto, para este caso
org.uscosoft y jenkins_tutorial, respectivamente. Se finaliza dando clic en Finish.
Al finalizar el proceso, se puede observar algo como lo siguiente:

Para la compilación del proyecto, se hace clic derecho sobre el proyecto>Run


as>Maven Build…
En la ventana emergente se digita clean install y se finaliza con Run.

Para correr el proyecto en el servidor, clic derecho sobre el mismo>Run As>Run on


Server
Se configura en que servidor se quiere correr el proyecto y se finaliza (Para este caso en
WildFly 10).

Para comprobar el funcionamiento, se abre un navegador y se digita la localhost, el


puerto y el nombre del proyecto, para este caso será (localhost:8081/jenkins_tutorial/).
Creación y Configuración de un repositorio en GitHub con proyecto en Eclipse.
Se crea un repositorio publico en la cuenta personal de GitHub, para ello se inicia sesión
con el usuario y clave respectiva, luego nuevo repositorio. Se ingresa el nombre del
repositorio a crear, si se desea una descripción del mismo y se hace clic en Create
repository.

Luego, debe de salir algo similar a esto:

En en el Eclipse se va a subir al repositorio hecho, el proyecto Maven que fue creado


anteriormente, para ello se hace clic derecho sobre el proyecto>Team>Share
Project…
En la ventana emergente, se crea el repositorio local, para ello clic en Create.

Se busca la carpeta donde se vaya a dejar el repositorio local.


Con eso, ya se tiene el destino del repositorio loca y se finaliza la operación.

Al finaliza, se podrá ver algo como lo siguiente:

Para observar el repositorio creado, se hacle clic en la pestaña Windows>Show


View>Other…
En la ventana emergente, se busca la opción Git y se agregan las vistas de Git
Repositories y Git Staging. Con lo anterior, se activará la vista de los repositorios Git.

Para subir el proyecto Maven que se creó en el Eclipse al repositorio local de Git, se
hace clic derecho sobre el proyecto>Team>Commit…
Se documenta el proceso a realizar (Actualización, modificación, etc.), y se seleccionan
los archivos afecetados. Se finaliza haciendo clic en Commit. Luego de esto, se verá
que el repositorio local ha sido cargado con el proyecto Maven.

Para subir al repositorio remoto de GitHub el proyecto Maven que tenemos en el


repositorio Local, se da clic derecho sobre el repositorio local, luego Pusch Branch…;
En la ventana emergente, se digita la URL del repositorio remoto creado en GitHub y las
credenciales de ingreso al GitHub.
En las siguientes ventanas se deja todo por defecto.
Para comprobar que el proyecto se ha subido al repositorio remoto, basta con actualizar
la pagina del GitHub.
Instalación y configuración de Jenkins
La integración continua es una práctica de desarrollo software donde los miembros del
equipo integran su trabajo frecuentemente. Cada integración se verifica compilando el
código fuente y obteniendo un ejecutable (a esto se le llama build, y debe hacerse de
forma automatizada).
Jenkins es un servidor de integración continua, gratuito, open-source y actualmente uno
de los más empleados para esta función. Además es muy fácil de utilizar. Para
descargar Jenkins se ingresa a la página https://jenkins.io/ y se da clic en la opción de
Download Jenkins.

Luego de haber descargado e instalado Jenkins, en un navegador se abrirá una pestaña


con dirección http://localhost:8080/login?from=%2F donde se debe de ingresar la clave
por defecto del administrador, esta clave se encuentra en el archivo ubicado en la ruta
que muestra la página. Se ingresa la clave y se da clic en Continue.
A continuación aparecen dos opciones, instalar los plugins mas usasdos o seleccionar
los plugins a instalar, se recomienda seleccionar la primera opción, si es necesario,
luego se pueden instalar más plugins.

Se iniciará el proceso de descarga e instalación de los plugins.

Luego, se debe registrar los datos del usuario administrador y clic en Continue as
Admin.
Finalmente, se tiene el panel principal de Jenkins.

Para este tutorial, se necesita que estén instalado los complementos Git plugin y Maven
Integration Plugin. Para ello vamos a Manage Jenkins>Manage Plugins.

Se selecciona la opción Available y en el cuadro de búsqueda se escriben los plugins a


instalar, se seleccionan y se da clic en Install without restart.
Una vez instalado los plugins necesarios, se procede con la configuración del JDK,
Maven y Git, se hace clic en Manage Jenkins>Global Tool Configuraction

Se agrega la configuración del JDK, se asigna nombre y la ruta en donde está instalado
el JDK en el equipo y se agrega la instalación.
Se agrega la configuración del Git, se asigna nombre y la ruta en donde está instalado el
Git en el equipo y se agrega la instalación.

Se agrega la configuración del Maven, se asigna nombre y la ruta en donde está la


carpeta del Apache Maven en el equipo y se agrega la instalación. Se finaliza todo el
proceso dando clic en Apply y Save.
Creación Proyecto Maven en Jenkins
En la ventana principal de Jenkins, damos clic en create new Jobs o New Item.

Digitamos el nombre del proyecto, seleccionamos Maven project y clic en OK.

En la siguiente ventana se especifica una descripción del proyecto.


Se digita la URL del repositorio donde está alojado el proyecto en GitHub y se agregan
las credenciales de acceso (usuario y clave de acceso a GitHub).

Se especifica cuando se debe de compilar el proyecto, si se desea especificar cada


cierto tiempo, se activa la opcion Build periodically y se ingresa cada cuanto quiere que
se compila la aplicación.

Se ingresa la ubicación del pom.xml, seleccionamos que se compile sin importar el


resultado. Para que el archivo generado por Jenkins quede en el WildFly, seleccionamos
Execute Windows batch command y agregamos lo siguiente:
Copy “ruta donde se genera el .war por defecto” “ruta donde está el servidor”

Para nuestro caso sería:

copy jenkins_tutorial\target\jenkins_tutorial.war
E:\Usco\INGENIERIA_DE_SOFTWARE\wildfly-
10.0.0.Final\standalone\deployments\jenkins_tutorial.war

Se finaliza dando clic en aplicar y guardar.


Para compilar el proyecto, se hace clic en Build Now.

En la parte inferior se puede ver el estado de la compilación.


Para mirar los detalles de la compilación, se hace clic sobre la misma, luego en Console
Output y se verán los resultados del proceso de compilación.

Se puede observar que la compilación fue exitosa y que se copió el archivo


jenkins_tutorial.war al directorio del WildFly.
Para comprobar el funcionamiento, se ejecuta el servidor WildFly y en un navegador se
digita la corresponeidnete URL, que para este caso sería
http://localhost:8081/jenkins_tutorial/ .