maven with jenkins maven documentation
Este tutorial explicará todo sobre Jenkins y la integración de Maven con Jenkins. También aprenderá a crear documentación para el proyecto usando Maven:
Conoceremos qué es Jenkins, la integración de Maven Jenkins, las ventajas de Jenkins, cómo configurar Java y Maven en Jenkins, cómo crear trabajos de Jenkins con diferentes parámetros, informes de resultados de ejecución de Jenkins con complementos de TestNG, cómo pasar Maven comandos en forma de Objetivos en Jenkins, documentación de Maven para proyectos, etc. en detalle.
=> Mire aquí la serie de entrenamiento Simple Maven.
cómo convertir char a int en c ++
Lo que vas a aprender:
¿Qué es Jenkins?
Jenkins es una herramienta de integración continua que tiene una gran importancia en el mundo de las pruebas y el desarrollo de software. Es de código abierto e independiente de la plataforma. En nuestro trabajo diario, nos ocupamos de marcos de automatización que comprenden varios cientos de casos de prueba.
Hasta ahora, hemos visto que para ejecutar nuestros scripts desde el proyecto Maven tenemos que ejecutar los comandos de Maven desde el símbolo del sistema o abrir directamente Eclipse y activar los scripts.
Entonces, estamos activando manualmente los casos de prueba para su ejecución. Para automatizar este proceso, necesitamos programar trabajos que ejecutarán nuestros casos de prueba en un momento particular y también cuidar algunos parámetros importantes. Todo este proceso está automatizado con la ayuda de Jenkins.
Por lo tanto, en realidad, si tenemos alrededor de 800 casos de prueba que deben ejecutarse a las tres de la mañana, entonces se puede hacer fácilmente sin requerir ninguna intervención manual con la ayuda de trabajos de Jenkin.
Además, hay escenarios en los que es necesario ejecutar casos de prueba automatizados de Smoke o Sanity después de que haya algún control de código desde el lado del desarrollo en el entorno. Jenkins se encarga de todo esto automáticamente.
Jenkins tiene el registro de todas las modificaciones realizadas en repositorios como SVN o Git. Jenkins se puede instalar y configurar fácilmente en nuestro sistema. Además, se puede configurar en más de una máquina virtual si las compilaciones deben activarse de manera distribuida. Además, da acceso a través de enlaces a todas las compilaciones recientes.
Jenkins tiene características como la integración con TestNG con la ayuda de complementos, notificaciones por correo electrónico sobre el estado de la compilación que lo hacen más popular de usar hoy en día. Los problemas y errores se detectan y se resuelven muy pronto.
La mayoría de las tareas de integración se realizan automáticamente, lo que ahorra recursos y permite que el software se publique en cualquier momento sin problemas.
En el entorno Agile, tenemos analistas de negocios, desarrolladores y evaluadores trabajando juntos. Como resultado, puede darse el caso de que un analista de negocios (una persona no técnica) necesite ver y monitorear cómo es el resultado de la ejecución.
En tales casos, es posible que no necesite abrir un Eclipse o configurar y ejecutar comandos de Maven para activar los scripts. Puede ejecutar los casos de prueba con la ayuda de Jenkins y obtener los resultados de la ejecución.
Estamos en la página de inicio de Jenkins con un nombre de trabajo como Proyecto . Si una empresa desea ver los resultados de la ejecución, se debe hacer clic en el nombre del trabajo y se lo redireccionará a la página siguiente.
Entonces Construye ahora a la izquierda de la pantalla debe hacer clic. Por lo tanto, solo necesitamos abrir la URL de Jenkins (https: // localhost: 8080 / jenkins).
Si bien los casos de prueba se activan a través de Jenkins, es solo el entorno específico que se proporciona en Jenkins donde se ejecutan los casos de prueba. Es un escenario común que si estamos ejecutando nuestros casos de prueba fuera de Jenkins, entonces están fallando debido a que la versión de nuestras herramientas o lenguaje o jar no está alineado con lo que se supone que debe funcionar.
Por ejemplo, la versión de Java o nuestra versión de Maven se actualizó o degradó. Todo esto se puede evitar si usamos los trabajos de Jenkin para nuestra ejecución.
Por lo tanto, Jenkins tiene importantes contribuciones en nuestro marco de pruebas al mantener una configuración centralizada en todas las ubicaciones geográficas.
Ventajas de Jenkins
Las ventajas de Jenkins se enumeran a continuación:
- Jenkins es una plataforma de código abierto, independiente y portátil.
- Se puede instalar y configurar fácilmente. Se puede utilizar con facilidad.
- Jenkins ha automatizado los elementos de integración y muchos de los problemas de integración no ocurren, lo que aumenta la eficiencia y la productividad de los desarrolladores.
- Su documentación está bien descrita y facilita su aprendizaje.
- Jenkins fue desarrollado por los desarrolladores teniendo en cuenta las características que los desarrolladores realmente necesitan en el trabajo.
- Tiene una gran cantidad de complementos. Todos estos complementos hacen que Jenkins sea más poderoso y popular entre los desarrolladores.
- Jenkins ayuda a los entornos alojados en la nube.
- Tiene una gran comunidad de usuarios a los que se puede acceder fácilmente. Trabajan en retroalimentaciones y tocan la base con regularidad.
- Jenkins proporciona ayuda para probar la automatización de las siguientes formas:
- Característica de la programación de la ejecución de la prueba: Los profesionales de pruebas pueden programar sus casos de prueba para su ejecución y utilizar su tiempo para otras tareas.
- Informe de resultados de prueba personalizado: Jenkins da detalles sobre el patrón de resultados. Las representaciones gráficas y los detalles de los resultados de la ejecución se reflejan en el número total de casos de prueba, los tiempos de ejecución y otra información importante.
- Funciona correctamente con los procesos de integración continua: El tiempo de prueba se reduce con Jenkins.
Ruta de Java y Maven en Jenkins
Primero que nada, necesitamos tener Java y Maven instalados en nuestras máquinas. Una vez que estemos en la página de inicio de Jenkins, inicialmente no habrá trabajos.
Ahora haga clic en Administrar Jenkins enlace de la izquierda de la pantalla.
Luego haga clic en Configuraciones globales de herramientas . Aquí tenemos que hacer las configuraciones para Java y Maven. Para configurar Java, haga clic en el Instalaciones JDK botón.
Aquí tenemos que dar Nombre y JAVA_HOME ruta o esto se puede solucionar marcando Instalar automáticamente caja.
A continuación, debemos movernos a la sección Maven y hacer clic en el Instalaciones Maven botón.
Aquí tenemos que dar Nombre y MAVEN_HOME ruta o esto se puede solucionar marcando el Instalar automáticamente caja.
Después de realizar estas operaciones, haga clic en Salvar al final de la página.
Crear un trabajo de Jenkins
A continuación, necesitamos generar un trabajo para activar los scripts de nuestro proyecto Maven. Clickea en el Nuevo artículo enlace de la izquierda de la pantalla.
Ingrese un Nombre del árticulo y seleccione el Proyecto Freestyle luego haga clic en Aceptar.
Se nos dirigirá a la página de configuración del trabajo. Aquí necesitamos proporcionar toda la información específica de nuestro proyecto. Al principio, necesitamos dar la fuente de nuestro código de proyecto.
Gestión de código fuente de Jenkins
En el Gestión de código fuente sección, generalmente seleccionamos de la GitHub o Subversión y proporcionar los enlaces correspondientes. Jenkins obtendrá automáticamente el código desde allí.
Sin embargo, si nuestro código está presente en nuestro sistema local, debemos hacer clic en el Advanced botón debajo del General sección , y Entonces revisa Usar espacio de trabajo personalizado .
Necesitamos colocar nuestro proyecto Maven dentro del .jenkins carpeta y proporcione la ruta del archivo pom que reside dentro del proyecto Maven comenzando con $ {JENKINS_HOME}.
De esta manera, Jenkins se apodera del código fuente del proyecto.
Jenkins no solo lo usan los probadores para activar la ejecución de la prueba, sino que también los desarrolladores lo usan ampliamente para su trabajo. Algunas de estas opciones se proporcionan en el Entorno de construcción sección.
A continuación, debemos movernos a la sección Crear y seleccionar Invocar objetivo Maven de nivel superior opciones del menú desplegable.
Entonces Invocar objetivos Maven de nivel superior Se ampliará la sección. Aquí Versión de Maven se completará previamente a partir de la versión de Maven que hemos definido en el Configuración global de herramientas .
En Objetivos, debemos proporcionar el comando Maven para activar la ejecución. prueba mvn –Pregresión. En Jenkins, podemos omitir el término mvn y el resto del comando es suficiente.
Haga clic en Salvar y hemos creado un trabajo con éxito.
Solo un resumen de lo que hemos discutido hasta ahora:
- Ubicación de nuestro código (ya sea Git, Subversiones o desde un directorio local).
- Maven comando para activar la ejecución.
Nuestro trabajo se creará y estará visible en la página de destino de Jenkins:
Clickea en el Construye ahora desde la izquierda de la pantalla. Habrá una Historial de construcción sección a la izquierda de la pantalla visible después de la construcción. los número de construcción será seguido visiblemente por # junto con sello de tiempo . Ahora navega al Salida de consola .
Los resultados de la ejecución:
Integración de TestNG Jenkins para el informe de resultados de ejecución
Para obtener los detalles del resultado de la ejecución de la prueba, navegue hasta el proyecto Maven en Eclipse, vaya al objetivo carpeta luego a la informes-infalibles carpeta. Hay un index.html archivo dentro de los informes surefire. Obtenga la ubicación del archivo y ábralo en el navegador.
testng-results.xml Se requiere el archivo y el complemento de informes TestNG para obtener resultados en Jenkins.
Haga clic en Administrar Jenkins enlace de la izquierda de la pantalla de Jenkins. Luego haga clic en Administrar complementos Enlace.
cola de matriz circular c ++
Instala el Complemento de resultados de TestNG .
Una vez hecho esto, actualizaremos el trabajo que hemos creado desde el Configurar enlace de la izquierda de la pantalla. Luego navega hasta el Acciones posteriores a la construcción sección y seleccione Publicar resultados de TestNG desde el menú desplegable.
testng-results.xml archivo en nuestro Proyecto Maven se rellena automáticamente en el Patrón de informe XML TestNG campo por defecto. Luego haga clic en Guardar.
Programación de trabajos en Jenkins
Navega al Construir disparadores sección para programar los tiempos de construcción.
Si seleccionamos Construye periódicamente , entonces tendremos el Calendario sección visible. Aquí tenemos que mencionar cinco parámetros para programar el trabajo como se muestra a continuación.
- MINUTOS en una hora
- HORAS en un día
- DAYMONTH día en un mes
- MES en un año
- DAYWEEK día de la semana
Para programar los scripts a las 8:00 a.m. de la mañana, debemos especificar como se muestra a continuación:
Ahora activaremos la compilación nuevamente, para verificar los resultados de TestNG. Vaya a la página de inicio de Jenkins y haga clic en el trabajo. Ahora tendremos un Resultados de TestNG enlace dentro de nuestra pantalla de trabajo.
En caso de que la ejecución no tenga fallas, el Último resultado de la prueba El enlace no mostrará fallas. Haga clic en el enlace TestNG Results para obtener más detalles sobre los resultados.
Podemos hacer clic en el construir # número para obtener más detalles sobre los resultados.
Para consultar nuestro código, debemos hacer clic en el Espacio de trabajo enlace a la izquierda de la pantalla. De esta forma, Jenkins y Maven pueden trabajar juntos.
Documentación de Maven para el proyecto
Podemos crear documentación para nuestro proyecto con la ayuda de Maven. Como se discutió anteriormente, Maven consta de tres ciclos de vida, es decir, limpio, sitio y predeterminado.
La tarea de eliminar cualquier error y eliminar los artefactos de la compilación anterior se realiza en el limpio ciclo. Mientras que la defecto está a cargo del proceso de implementación total, el sitio ciclo de vida es para crear la documentación del proyecto.
Se considera una buena práctica, realizar una limpieza antes del sitio para que tengamos una documentación actualizada.
Navegue a la carpeta del proyecto y ejecute el siguiente comando desde el símbolo del sistema.
|_+_|Se iniciará el proceso de construcción del proyecto. Después del éxito de la construcción, la documentación del proyecto se generará como se muestra a continuación.
Al hacer clic en el archivo index.html, podemos tener documentación detallada del proyecto que consiste principalmente en la información de construcción y proyecto, sobre el proyecto, integración continua, dependencias, lista de correo, licencias, etc.
Sección de preguntas frecuentes
P # 1) ¿Cómo trabaja Jenkins con Maven?
Responder: Jenkins funciona bien con Maven siguiendo ciertas condiciones previas. Necesitamos configurar rutas de Java y Maven en Jenkins. Luego, debemos crear los trabajos de Jenkins con todos los parámetros, incluidas las acciones posteriores a la compilación, la programación de las compilaciones, etc.
P # 2) ¿Qué son Maven y Jenkins?
Responder: Maven es una herramienta de construcción y gestión de proyectos desarrollada en Java. Jenkins es una herramienta de integración continua que es de código abierto. Tanto Maven como Jenkins se utilizan ampliamente en la industria hoy en día.
P # 3) ¿Cuál es el objetivo de Maven en Jenkins?
Responder: Proporcionamos los comandos de Maven dentro de la sección Objetivos de Jenkins. Este es un paso clave al crear un trabajo de Jenkins.
P # 4) ¿Por qué usamos Maven?
Responder: Maven es una herramienta de construcción y gestión de proyectos que se basa en un archivo pom.xml. Ha hecho que el proceso de construcción sea simple, fácil y consistente.
P # 5) ¿Maven es una herramienta de CI?
Responder: No, Maven no es una herramienta de integración continua. Es una herramienta de construcción que tiene más funciones que Ant. Jenkins es una herramienta de integración continua.
P # 6) ¿Qué es pom xml en Maven?
Responder: Project Object Model o pom es un archivo xml que forma el núcleo de Maven. Contiene la lista de dependencias, configuraciones, perfiles, etc. del proyecto.
P # 7) ¿Podemos integrar TestNG y Jenkins con Maven?
Responder: Sí, podemos integrar TestNG y Jenkins con Maven. Todo esto se logra con la ayuda de complementos.
mejor programa para corregir errores de registro
P # 8) ¿Cuáles son las tres compilaciones del ciclo de vida de Maven?
Responder: Las tres versiones estándar del ciclo Maven se enumeran a continuación.
- Defecto
- Limpio
- Sitio
P # 9) ¿Cómo configurar XML de configuración de Jenkins?
Responder: En Jenkins, vaya a la sección Crear del trabajo y luego haga clic en Avanzado. Archivo de configuración La opción será visible allí. La ubicación de settings.xml debe especificarse allí.
P # 10) ¿Cómo configuro variables ambientales en Jenkins?
Responder: Las variables ambientales en Jenkins se pueden establecer desde el Configurar pantalla. En el Construir sección, seleccione Inyectar variables de entorno . Allí necesitamos proporcionar la variable de entorno como el patrón VARIABLE_NAME = VALUE.
Conclusión
Esperamos que a una gran parte de Maven le guste su integración con Jenkins, los complementos de TestNG para que Jenkins muestre resultados, la creación de trabajos en Jenkins, Java y Maven configurados en Jenkins, las configuraciones globales en Jenkins deberían entenderse fácilmente ahora.
Además, los mecanismos de programación de compilación de Jenkins, sus acciones posteriores a la compilación, cómo Jenkins maneja el código que reside en Git o cualquier otro repositorio o localmente se ha ilustrado en detalle aquí. Practique cada paso uno por uno y la fusión de Maven Jenkins será clara. También hemos explorado la documentación de Maven para proyectos.
Jenkins, una herramienta de integración continua, tiene un uso real para desarrolladores, probadores, analistas de negocios, etc. en un mundo ágil. Cada organización busca utilizar y adaptar procesos de integración continua de vez en cuando.
=> Visite aquí para ver la serie de formación Maven para todos.
Lectura recomendada
- Qué es Maven - Tutorial de Maven para principiantes
- Complementos de Gradle Vs Maven y Maven
- Tutorial de Jenkins CI: ¿Qué es la integración continua de Jenkins?
- Jenkins Jobs: configuración de SCM, creación de trabajos y sondeo de SCM
- Complementos de Jenkins: SCM, analizadores e instalación de complementos
- Integración de Maven con TestNg utilizando el complemento Surefire de Maven
- Seguridad de Jenkins: Activación de la seguridad y la matriz de seguridad del proyecto
- Configuración de Maven con Eclipse Java IDE