Skip to content

🧭 Pasos para Vincular un Jenkinsfile como Pipeline Declarativo en Jenkins

🔹 1. Tener Jenkins instalado y funcionando

Asegúrate de tener acceso a Jenkins:

  • Puedes instalarlo localmente (guía oficial).
  • O usarlo desde una máquina virtual o contenedor Docker.
  • Accede mediante navegador: http://localhost:8080 o la URL correspondiente.

🔹 2. Verificar los plugins necesarios

Ve a "Administrar Jenkins" > "Administrar Plugins" y asegúrate de tener instalados:

  • Pipeline
  • Git plugin
  • NodeJS plugin (para usar herramientas declaradas con tool)

✅ Si no los tienes, instálalos desde la pestaña “Disponible”.

alt text

🔹 3. Configurar la herramienta Node.js (una sola vez)

  1. Ve a "Administrar Jenkins" > "Global Tool Configuration".
  2. En la sección NodeJS, haz clic en "Añadir NodeJS".
  3. Asigna un nombre: Node 20.
  4. Marca “Instalar automáticamente” y elige la versión 20.x.
  5. Guarda los cambios.

alt text


alt text

🔹 4. Crear un nuevo proyecto tipo Pipeline

  1. En la pantalla principal de Jenkins, haz clic en “Nuevo elemento”.
  2. Asigna un nombre al proyecto, por ejemplo: pipeline-nodejs-react.
  3. Selecciona “Pipeline” y haz clic en “OK”.

alt text


alt text


🔹 5. Vincular el Jenkinsfile desde GitHub

Opción A: Jenkinsfile en repositorio GitHub (recomendado)

  1. Ve a la configuración del pipeline.
  2. En la sección “Pipeline”, selecciona:
    • Definición: Pipeline desde SCM
    • SCM: Git
    • URL del repositorio:
      https://github.com/<su repositorio>/node-project.git
    • Branch a construir:
      */*
    • Script Path:
      Jenkinsfile (o la ruta personalizada si está en una subcarpeta)

La imagen indica el repositorio de ejemplo. Asegúrate de usar el tuyo.

alt text


alt text


Opción B: Escribir Jenkinsfile directamente en el panel

  1. Cambia “Definición” a Pipeline script.
  2. Copia y pega directamente el contenido del Jenkinsfile.

🔹 6. (Opcional) Configurar credenciales de GitHub

Si tu repositorio es privado:

  1. Ve a "Administrar Jenkins" > "Credenciales".
  2. Agrega una credencial:
    • Tipo: Username with password o Personal Access Token
    • ID: github-creds (o el que uses)
  3. Luego, en la configuración del pipeline, selecciona estas credenciales en el campo “Credenciales”.

🔹 7. Ejecutar el Pipeline

  1. Haz clic en “Guardar”.
  2. En el panel del proyecto, presiona “Construir ahora”.
  3. Jenkins ejecutará el pipeline paso a paso.

Puedes ver el progreso en tiempo real desde la pestaña "Console Output".


alt text


🎯 Resultado Esperado

  • Jenkins instalará Node.js, limpiará el workspace, clonará el repositorio, instalará dependencias, ejecutará pruebas y generará la build final.
  • El bloque post mostrará mensajes según el resultado.

alt text


alt text