Integracion Continua con Jenkins + .Net + Subversion

Desde hace ya un buen rato he venido trabajando con la práctica de integración continua; obteniendo todos los beneficios de esta, sin embargo, hasta hace poco no me había tocado nunca realizar las configuraciones necesarias para algún proyecto.

Es por eso que esta vez les dejo los pasos para realizar la configuración general del servidor de integración continua para un proyecto de .Net, por medio de Jenkins y Subversion.

Instalación de Jenkins

Para realizar la instalación de jenkins, seguir los pasos indicados en la página oficial.

Instalación de plugins

Para poder realizar la compilación y ejecución de pruebas del proyecto de .Net vamos a requerir de los siguientes plugins:

• Subversion. El plugin de subversion nos va a permitir conectarnos al control de versiones y monitorear los cambios agregados en este.
• MsBuild. Este plugin nos va a permitir compilar el proyecto .Net por medio de MSBuild.
• MsTest. Este plugin nos va a permitir ejecutar las pruebas unitarias por medio de la herramienta de línea de comandos MSTest. MsTest son clases para el framework .Net que son integradas en Visual Studio.

Vamos a instalar los plugins mencionados:

1. Abrir jenkins. En mi caso lo he configurado en el puerto 8087, por lo que abro un explorador e ingreso la url: http://localhost:8087/jenkins/
2. Click en administrar Jenkins
3. Click en administrar plugins
4. Click en el tab plugins disponibles
5. Ingresar Subversion en el filtro de búsqueda
6. Seleccionar el plugin
7. Click en instalar
8. Repetir los pasos para los plugins MsBuild, MsTest
9. Reiniciar Jenkins

Configuración de plugins

Una vez instalados los plugins procedemos a su configuración:

Configuración de MsBuild

1. Abrir Jenkins
2. Click administrar Jenkins
3. Configurar el sistema
4. Click en añadir MsBuild
5. Ingresar el nombre
6. Ingresar la ruta del msbuild
7. Click en aplicar los cambios

Configuración de MsTest

1. Click en añadir MsTest
2. Ingresar nombre
3. Ingresar la ruta de MsTest
4. Click en aplicar los cambios
5. Click en guardar

Configuración del proyecto

Una vez instalados y configurados los plugins, es momento de configurar el proyecto que hará uso de la práctica de integración continua

1. Crear nueva tarea
2. Ingresar nombre
3. Crear proyecto de estilo libre
4. Ok
5. En la sección Configurar el origen del código fuente
1. Seleccionar Subversion
2. Ingresar la url del repositorio
3. Ingresar las credenciales
6. En la sección de disparadores de ejecución
1. Ejecutar periódicamente
2. Ingresar el valor H/5 * * * * (Hacer el pull cada 5 minutos)
7. Click en añadir nuevo paso
1. Seleccionar "Build a visual studio project or solution using msbuild"
2. En MsBuild Version seleccionar Visual Studio 2010 MsBuild
3. En MsBuild Build File ingresar la solución de nuestro proyecto (archivo.sln)
8. Click en añadir nuevo paso
1. Seleccionar Run unit tests with MSTest
2. En Test Files ingresar la url de la dll generada del proyecto de pruebas
3. Ingresar en Result File Name el nombre del archivo con el resultado de pruebas

Configuración de pruebas con NUnit

Si solo poseen la versión express de Visual Studio, es posible lanzar las pruebas unitarias con NUnit. Para utilizar NUnit, instalamos NUnit, el plugin para Jenkins con los pasos antes mencionados y realizamos la siguiente configuración:

1. Seleccionar el proyecto de trabajo
2. Click en configurar
3. Click Build
4. Agregar paso de construcción
5. Seleccionar Execute Windows Batch Command
6. Colocarlo después de la compilación con MsBuild

Esta es la configuración general para compilar y lanzar las pruebas unitarias del proyecto. En posteriores entradas veremos como configurar plugins para análisis de cobertura, generación de documentació, etc.