Cómo crear un nuevo trabajo de compilación en Jenkins Proyecto de estilo libre

Por: Tomas Hamilton Tomas Hamilton
Hours Actualizado

⚡ Resumen inteligente

Jenkins Freestyle Project es un trabajo de compilación repetible que agrupa la extracción del código fuente, los pasos de compilación y las acciones posteriores a la compilación en una tarea configurable, creada completamente a través de Jenkins Interfaz web sin necesidad de escribir código de canalización.

  • 🔘 Definición: Un trabajo de estilo libre es Jenkins' tipo de proyecto de propósito general, configurado a través de formularios en lugar de un Jenkins.
  • ☑️ Requisitos previos: Una carrera Jenkins Primero se requieren un controlador, un JDK en el agente de compilación, el complemento Git y un repositorio accesible.
  • ✅ Diez pasos: Inicia sesión, crea un nuevo elemento, asígnale un nombre, configura el repositorio, agrega un paso de compilación, guarda, compila y lee la salida de la consola.
  • 🧪 Ejemplo trabajado: Un proyecto HelloWorld obtenido de GitHub compila con javac y se ejecuta con java dentro de un Windows paso de compilación por lotes.
  • 🛠️ Mapa de configuración: Seis secciones del formulario: General, Fuente Code Administración, activadores de compilación, entorno de compilación, pasos de compilación y acciones posteriores a la compilación: abarca todas las opciones.
  • ⚙️ Límite de alcance: Los trabajos de estilo libre son adecuados para la automatización de tareas individuales; en cambio, el trabajo de entrega en varias etapas pertenece a un trabajo de Pipeline con control de versiones.
Descubre más

Cómo crear un nuevo trabajo de compilación en Jenkins Proyecto de estilo libre

¿Qué es Jenkins ¿Proyecto de estilo libre?

Jenkins Proyecto de estilo libre Es un trabajo de compilación repetible, un script o una canalización que contiene pasos y acciones posteriores a la compilación. Es un trabajo o tarea mejorada que puede abarcar múltiples operaciones. Le permite configurar activadores de compilación y ofrece seguridad basada en proyectos para su Jenkins proyecto. También ofrece complementos para ayudarte a crear pasos y acciones posteriores a la compilación.

Los tipos de acciones que puedes realizar en un Jenkins Los pasos de compilación o las acciones posteriores a la compilación son bastante limitados. Hay muchos complementos estándar disponibles dentro de un Jenkins Proyecto Freestyle para ayudarte a superar este problema.

El diagrama a continuación sitúa el trabajo de estilo libre dentro del marco más amplio. integración continua bucle, desde la extracción del código fuente hasta las acciones posteriores a la compilación que informan del resultado.

Pasos para crear un empleo en Jenkins Proyecto de estilo libre
Cómo crear un trabajo en Jenkins

Requisitos previos para la creación de una Jenkins Trabajo de estilo libre

Para que los diez pasos que se describen a continuación funcionen correctamente, deben cumplirse cuatro requisitos. La falta de cualquiera de ellos suele ser la razón por la que un primer montaje de estilo libre fracasa y termina con una bola roja en lugar de una azul.

  • Una carrera Jenkins controlador. Jenkins escucha en el puerto 8080 por defecto. Si Jenkins aún no está funcionando, siga el Tutorial de instalación de antemano.
  • Un JDK en la máquina que ejecuta la compilación. El ejemplo resuelto compila Java, asi que javac Debe estar en la ruta del controlador o agente que ejecuta el trabajo. Confirme esto con una línea java -version Construye el paso antes de agregar cualquier otra cosa.
  • El complemento de Git. El Git Esta opción solo aparece en Fuente Code Administración una vez instalado el complemento, a través de Gestionar Jenkins > Complementos.
  • Un repositorio accesible. Un HTTPS público URL no necesita credenciales. Un repositorio privado necesita una credencial almacenada en Jenkins Primero, de lo contrario, la compra fallará durante la primera compilación.

Una cuenta con el Trabajo/Crear También se necesita permiso, en un nuevo usuario único. Jenkins La cuenta de administrador ya lo tiene.

Cómo crear un nuevo trabajo de compilación en Jenkins

El trabajo de construcción de estilo libre es una opción muy flexible y fácil de usar. Puedes usarlo para cualquier tipo de proyecto; es fácil de configurar y muchas de sus opciones aparecen en otros trabajos de construcción. A continuación se muestra un proceso paso a paso para crear empleo en Jenkins.

Paso 1) Iniciar sesión en Jenkins

Para crear un Jenkins trabajo de estilo libre, inicie sesión en su Jenkins panel de control visitando su Jenkins ruta de instalación. Normalmente, estará alojado en localhost en http://localhost:8080 Si tiene una cuenta de cheques instalado Jenkins En otro camino, utilice el apropiado URL Para acceder a su panel de control, como se muestra a continuación. Jenkins Ejemplo de creación de empleo.

Jenkins panel alcanzado en el Jenkins ruta de instalación después de iniciar sesión

Paso 2) Crear nuevo artículo

Haga clic en "Nuevo elemento” en la parte superior izquierda de tu panel de control. La captura de pantalla a continuación muestra dónde se encuentra ese enlace.

Enlace Nuevo artículo en la parte superior izquierda de la pantalla. Jenkins Afiliados

Paso 3) Ingrese los detalles del artículo

En la siguiente pantalla,

  1. Ingrese el nombre del elemento que desea crear. Usaremos "Hola mundo" para esta demostración.
  2. Seleccionar proyecto de estilo libre
  3. Haga clic en Aceptar

Cuadro de nombre del elemento con el proyecto Freestyle seleccionado antes de hacer clic en Aceptar

Paso 4) Ingrese los detalles del proyecto

Introduzca los detalles del proyecto que desea probar. La página de configuración que se abrirá se muestra a continuación.

Detalles del proyecto ingresados ​​en el Jenkins Página de configuración de trabajo de estilo libre

Paso 5) Ingrese al repositorio URL

Bajo fuente Code Administración, ingrese su repositorio URLTenemos un repositorio de pruebas ubicado en https://github.com/kriru/firstJava.git

Fuente Code Sección de administración con el repositorio de pruebas de Git URL entrado

También es posible que utilice un repositorio local.

Si tu repositorio de GitHub es privado, Jenkins Primero validará tus credenciales de inicio de sesión con GitHub y solo entonces descargará el código fuente de tu repositorio de GitHub.

ARTÍCULOS RELACIONADOS

Paso 6) Modifica la configuración

Ahora que ha proporcionado todos los detalles, es hora de compilar el código. Ajuste la configuración en el construimos sección para construir el código en el momento que desee. Incluso puedes programar la compilación para que se realice periódicamente, en horarios establecidos.

En construcción,

  1. Haga clic en "Agregar paso de compilación"
  2. Haga clic en "Implementación Windows comando por lotes”Y agregue los comandos que desea ejecutar durante el proceso de compilación.

El menú desplegable que muestra los pasos de compilación disponibles tiene este aspecto.

Se abrió el menú desplegable "Agregar paso de compilación" en la página de configuración del trabajo de estilo libre.

⚠️ Nota de versión: reciente Jenkins Los lanzamientos etiquetan esta área Pasos de construcción más bien que Configurary en Linux o macOS agentes la opción equivalente es Ejecutar shellEl botón todavía se llama Agregar paso de compilación.

Aquí, agregué los comandos de Java para compilar el código de Java.

He añadido los siguientes comandos de Windows:

javac HelloWorld.java
java HelloWorld

A continuación se muestra el cuadro de comandos con esas dos líneas introducidas.

Implementación Windows Caja de comandos por lotes que contiene los comandos javac y java.

Paso 7) Guarde el proyecto

Cuando hayas introducido todos los datos,

  1. Haga clic en Aplicar
  2. Guardar el proyecto.

Paso 8) Construir el código fuente

Ahora, en la pantalla principal, haga clic en el botón Construir ahora en el lado izquierdo para compilar el código fuente.

Botón "Construir ahora" en el lado izquierdo de la pantalla del proyecto de estilo libre.

Paso 9) Verifique el estado

Después de hacer clic en Construir ahora, puede ver el estado de la compilación que ejecuta en Historial de compilación.

Panel de historial de compilación que muestra el estado de la compilación de estilo libre que se ejecutó.

Paso 10) Ver la salida de la consola

Haz clic en el número de compilación y luego en Salida de la consola para ver el estado de la compilación que ejecutaste. Debería mostrarte un mensaje de éxito, siempre que hayas seguido la configuración correctamente como se muestra a continuación. Jenkins crear un nuevo ejemplo de trabajo.

Pantalla de salida de la consola que muestra el mensaje de éxito de la compilación finalizada.

En resumen, hemos ejecutado un programa HelloWorld alojado en GitHub. Jenkins Descarga el código del repositorio remoto y lo compila continuamente con la frecuencia que usted defina.

Jenkins Explicación de las secciones de configuración del proyecto Freestyle

El tutorial anterior solo abarca los campos necesarios para el ejemplo HelloWorld. La página de configuración se divide en seis secciones de formulario, y saber qué función cumple cada una facilita enormemente la búsqueda de las demás opciones.

Secciones Lo que controla Configuración típica
General Descripción del trabajo, descarte de compilaciones antiguas, parámetros y si el trabajo se ejecuta en un agente específico. Descriptión más un límite de retención de compilación
Fuente Code Gestión ¿Qué repositorio consultar y con qué credenciales y rama? Git, un HTTPS URL, rama */master or */main
Construir disparadores ¿Qué inicia la compilación automáticamente? Consultar el sistema de control de versiones (SCM), compilar periódicamente o usar un webhook de GitHub.
Entorno de compilación Envoltorios aplicados alrededor de toda la compilación Elimine el espacio de trabajo antes de que comience la compilación; agregue marcas de tiempo al registro de la consola.
Pasos de construcción Los comandos que realizan el trabajo se ejecutan de arriba a abajo. Implementación Windows comando por lotes o ejecutar shell
Acciones posteriores a la compilación ¿Qué sucede después de que finalizan los pasos, sea cual sea el resultado? Architener los artefactos, publicar un informe de prueba, enviar un correo electrónico

Dos hábitos ahorran mucho trabajo de depuración posterior. Agregue los pasos de compilación en el orden en que deben ejecutarse, porque Jenkins Los procesa de arriba abajo y se detiene ante el primer fallo. A continuación, archiva todo lo que produce la compilación como acción posterior a la misma, ya que el espacio de trabajo se reutiliza en la siguiente compilación, mientras que los artefactos archivados se conservan por número de compilación.

Proyecto de estilo libre vs. Pipeline: ¿Cuál deberías usar?

El estilo libre no es el único tipo de proyecto en la pantalla de Nuevo elemento, y no siempre es el correcto. La tabla a continuación lo compara con un Trabajo en oleoducto en los puntos que deciden la mayoría de las decisiones importantes.

Punto de comparación Proyecto de estilo libre Tubería
Cómo se define Formularios web almacenados en el trabajo config.xml en el controlador A Jenkinsarchivo confirmado con el código de la aplicación
Cambia la historia Atrapado por Jenkins, fuera de su repositorio RevRevisado y versionado como cualquier otro archivo fuente.
Etapas y trabajo en paralelo Una única lista plana de pasos de construcción Etapas con nombre, ramificaciones paralelas y una vista de la etapa.
Curva de aprendizaje No se necesita programación Requiere la sintaxis de canalización declarativa.
Mejores ajuste Una compilación, un script, una tarea programada o aprendizaje Jenkins Flujos de compilación, prueba e implementación en múltiples etapas en distintos entornos.

Una regla práctica: recurra al estilo libre mientras el trabajo sea una sola tarea y aún esté aprendiendo la herramienta, y traslade el trabajo a un Canalización de CI / CD tan pronto como crezca una segunda etapa o necesite ser revisado junto con el código. Los equipos que se emparejan Jenkins con las herramientas de compilación a menudo se llega a ese punto rápidamente: Maven y Selenium Configure es un desencadenante común para el interruptor, y el mismo razonamiento se aplica a cualquier pruebas de automatización Suite que se desarrolla en varias fases.

Preguntas Frecuentes

La salida de la consola indica la causa. Las tres causas más comunes son: falta javac en la variable de entorno PATH del agente, un repositorio privado sin credenciales almacenadas y un nombre de rama incorrecto. Corrija la línea indicada y vuelva a ejecutar la compilación.

Abra los activadores de compilación y marque Construir periódicamente, luego ingrese la sintaxis de cron como por ejemplo H 2 * * * para correr todas las noches. H Distribuye la carga a lo largo de la hora. Encuesta SCM Utiliza la misma sintaxis, pero solo se compila cuando el repositorio ha cambiado.

Elija Ejecutar shell desde el menú Agregar paso de compilación en lugar de Ejecutar Windows Comando por lotes. La opción que se muestra depende del sistema operativo del controlador o agente al que está vinculada la tarea, no de su propia máquina.

Almacene el token o la clave SSH una vez que esté Gestionar Jenkins CredencialesLuego, selecciónelo en el menú desplegable Credenciales en la Fuente. Code Sección de administración. Jenkins Lo valida antes de finalizar la compra, por lo que una credencial incorrecta provoca que la compilación falle de inmediato.

Las herramientas de aprendizaje automático leen los registros de la consola y agrupan los fallos repetidos, lo que permite diferenciar un error de compilación real de un agente inestable o un tiempo de espera agotado. Este análisis te ayuda a identificar la línea relevante en lugar de tener que revisar manualmente un registro extenso.

Copiloto de GitHub Genera el script por lotes o de shell dentro de un paso de compilación, y su interfaz de línea de comandos (CLI) puede resumir un registro de consola fallido. No permite navegar por el formulario de configuración, por lo que se recomienda revisar cada comando generado antes de guardarlo.

Agregar Architener los artefactos como una acción posterior a la compilación y darle un patrón como por ejemplo: **/*.class. ArchiLos archivos ved se almacenan por número de compilación, por lo que se conservan incluso si el espacio de trabajo se reutiliza o se limpia en la siguiente ejecución.

Cada trabajo se encuentra en JENKINS_HOME/jobs/<job-name>, con la configuración del formulario en config.xml y cada carrera bajo builds/Con hacer una copia de seguridad de esa carpeta es suficiente para mover o restaurar el trabajo.

Resumir este post con: