Explorando la Interfaz de Jenkins

Introducción

Bienvenido a tu primera experiencia práctica con Jenkins. Jenkins es un potente servidor de automatización de código abierto utilizado para construir, probar y desplegar software, una práctica conocida como Integración Continua y Despliegue Continuo (CI/CD).

En este laboratorio, te familiarizarás con los aspectos fundamentales de la interfaz de usuario de Jenkins. Te guiaremos a través del panel principal, te mostraremos cómo crear y configurar tu primer proyecto sencillo, ejecutar una compilación e inspeccionar los resultados. El servicio de Jenkins ya está instalado y en funcionamiento en este entorno, por lo que puedes centrarte directamente en explorar sus funcionalidades.

Al finalizar este laboratorio, serás capaz de:

• Navegar por el panel principal de Jenkins.
• Crear un nuevo proyecto Freestyle.
• Ejecutar manualmente un trabajo de compilación.
• Ver el historial de compilaciones y la salida de la consola.

Empecemos.

Accediendo y Explorando el Panel de Jenkins

En este paso, iniciará sesión en la interfaz web de Jenkins y se familiarizará con el panel de control principal. El servicio de Jenkins ya se está ejecutando en un contenedor para usted.

Primero, acceda a la interfaz web de Jenkins. En la parte superior de su pantalla de LabEx, haga clic en la pestaña Desktop Interface (Interfaz de Escritorio). Dentro del escritorio virtual, abra el navegador web Firefox. El navegador se abrirá automáticamente en http://localhost:8080, por lo que no necesita introducir la URL manualmente. No se requiere inicio de sesión.

Verá el panel de control principal de Jenkins. Tómese un momento para observar sus componentes clave:

• Barra Lateral de Navegación (Izquierda): Este es su menú de navegación principal. Encontrará enlaces importantes como New Item (para crear nuevos trabajos/jobs), Build History (una vista global de todas las compilaciones/builds).
• Área de Contenido Principal: Esta área muestra una lista de todos los trabajos que ha creado. Inicialmente, estará vacía.

Ahora que está familiarizado con el panel de control, está listo para crear su primer proyecto.

Creando un Proyecto Freestyle

En este paso, crearás tu primer trabajo (job) de Jenkins utilizando el tipo "Proyecto Freestyle" (Freestyle project). Un proyecto Freestyle es una opción muy flexible y fácil de usar, perfecta para principiantes y para una amplia variedad de tareas de automatización.

1. En la interfaz web de Jenkins, haz clic en New Item (Nuevo Elemento) en la barra lateral de navegación izquierda.

2. En la siguiente página, deberás proporcionar un nombre para tu proyecto y seleccionar su tipo.

   • En el campo Enter an item name (Introducir un nombre de elemento), escribe My-First-Job.
   • Selecciona Freestyle project de la lista de opciones.
   • Haz clic en el botón OK en la parte inferior.

3. Ahora estarás en la página de configuración del proyecto. Aquí es donde defines lo que hará tu trabajo. Para este laboratorio, añadiremos un único y simple paso de construcción (build step). Desplázate hacia abajo hasta la sección Build Steps (Pasos de Construcción).

4. Haz clic en el botón desplegable Add build step (Añadir paso de construcción) y selecciona Execute shell (Ejecutar shell). Esto te permite ejecutar comandos shell como parte de tu construcción.

5. Aparecerá un cuadro de comandos. En este cuadro, escribe el siguiente comando:

   echo "Hello from my first Jenkins job!"

6. Finalmente, desplázate hasta el final de la página y haz clic en el botón Save (Guardar).

Después de guardar, Jenkins te redirigirá a la página principal de tu proyecto recién creado, My-First-Job.

Ejecutando el Job de Compilación

En este paso, ejecutarás, o "construirás" (build), el trabajo que acabas de crear. Ejecutar un trabajo significa procesar los pasos que configuraste para él.

Actualmente deberías estar en la página del proyecto para My-First-Job. Si te has desplazado a otra sección, puedes volver haciendo clic en su nombre en el panel principal (dashboard) de Jenkins.

1. En la página del proyecto para My-First-Job, mira la barra de navegación lateral a la izquierda. Verás una opción llamada Build Now (Construir Ahora).

2. Haz clic en Build Now para iniciar el proceso de construcción.

Una vez que hagas clic, se programará una nueva construcción (build). La verás aparecer bajo la sección Build History (Historial de Construcciones) en la parte inferior izquierda. A la construcción se le asignará un número, comenzando con #1.

Aparecerá un pequeño icono de estado junto al número de la construcción. Un icono verde parpadeante significa que la construcción está en progreso. Un círculo verde sólido significa que la construcción fue exitosa. Dado que nuestro trabajo es muy simple, se completará en solo uno o dos segundos.

Ahora has activado con éxito tu primera construcción.

Visualizando la Salida de la Consola

En este paso, aprenderá a verificar los resultados de su compilación (build). Revisar la salida es una parte crítica de cualquier proceso de automatización, ya que le indica exactamente lo que sucedió y si tuvo éxito.

1. En la página del proyecto My-First-Job, observe la sección Build History (Historial de Compilaciones) en la esquina inferior izquierda. Debería ver su primera compilación, etiquetada como #1, con un círculo verde que indica éxito.

2. Haga clic en el número de compilación #1 para ir a la página de detalles de esa compilación específica.

3. En la página de la compilación, verá varios detalles sobre la misma, como cuándo se ejecutó. El enlace más importante aquí para la depuración (debugging) es Console Output (Salida de la Consola). Haga clic en Console Output en la barra lateral izquierda.

4. La página de Salida de la Consola muestra un registro detallado de cada acción que Jenkins realizó durante la compilación. Verá que Jenkins inició la compilación, ejecutó su comando shell y luego marcó la compilación como finalizada.

La salida debería ser similar a esta:

Started by user admin
Running as SYSTEM
Building in workspace /var/jenkins_home/workspace/My-First-Job
[My-First-Job] $ /bin/sh -xe /tmp/jenkins12345.sh
+ echo 'Hello from my first Jenkins job!'
Hello from my first Jenkins job!
Finished: SUCCESS

Como puede ver, el registro incluye el comando echo que configuramos y su salida: Hello from my first Jenkins job!. El estado final Finished: SUCCESS confirma que el trabajo se ejecutó sin errores.

Resumen

¡Felicitaciones por completar este laboratorio introductorio! Has dado tus primeros pasos con éxito en el mundo de Jenkins.

En este laboratorio, has aprendido a:

• Acceder al panel de Jenkins e identificar sus componentes clave.
• Crear un nuevo proyecto Freestyle desde cero.
• Configurar un simple paso de compilación "Execute shell".
• Disparar manualmente una compilación para tu proyecto.
• Encontrar e inspeccionar el historial de compilaciones y la salida detallada de la consola para verificar el resultado.

Estas habilidades fundamentales son los pilares para crear flujos de trabajo de automatización más complejos y potentes. Ahora estás bien preparado para explorar funciones más avanzadas de Jenkins.