Recursos · Integración n8n

Integración Jenkins n8nAutomatiza Jenkins con n8n.

Un job de Jenkins puede arrancar por algo que no sea una línea de cron. La integración Jenkins n8n trae 11 operaciones repartidas en 3 recursos: listar builds, crear o copiar un job, lanzarlo con o sin parámetros y gobernar la instancia. Jenkins no tiene nodo trigger, así que el workflow arranca en otro sitio.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración Jenkins n8n?

Es el nodo Jenkins, incluido en n8n, que llama a la API Remote Access de tu instancia con un credential de token API (un credential es la ficha de conexión que se guarda una sola vez en n8n). Cubre tres recursos: Build, Instance y Job. Desde un workflow puedes listar los builds de un job, crear un job a partir de su XML de configuración, copiar uno existente, lanzar un build con o sin parámetros, y poner la instancia en modo silencioso o reiniciarla.

Primer caso: un build que arranca por algo que no es Jenkins. Llega una aprobación, cambia un registro en una herramienta interna, y el workflow llama a job.trigger sobre el job correcto. La misma idea sirve a partir de un evento de GitHub cuando prefieres que la decisión de compilar viva en tu workflow y no en una configuración escondida dentro de Jenkins.

Segundo caso: el historial de builds donde el equipo lo mira de verdad. build.getAll devuelve los builds de un job y el nodo siguiente los deja donde toca, una tabla de Postgres para el repaso semanal o un canal de Slack con los últimos fallos. Ojo con Return All: si lo dejas apagado, n8n se queda en Limit en vez de recorrer todo el historial.

Tercer caso: mantenimiento sin nadie delante de una terminal. Antes de una ventana planificada, el workflow llama a instance.quietDown para que no arranque ningún build nuevo, deja terminar los que ya corren y encadena instance.safeRestart o instance.safeExit. ¿Se cancela la ventana? instance.cancelQuietDown devuelve la instancia al servicio.

La creación de jobs pide una aclaración. job.create espera el XML de una configuración de Jenkins, así que ese XML tiene que venir de algún sitio del workflow: una plantilla guardada en un nodo anterior, un archivo leído antes, o una cadena montada sobre la marcha. job.copy es el atajo cuando un job existente ya hace de plantilla.

Si un endpoint de la API de Jenkins no está entre estas 11 operaciones, el nodo HTTP Request lo llama directamente y reutiliza el mismo credential de Jenkins con la autenticación predefinida, sin salir de n8n. Como no hay nodo trigger de Jenkins, piensa la entrada del workflow: un Schedule Trigger a intervalo fijo, un Webhook de n8n al que llama un servicio externo, o el trigger de otra herramienta. La Reseña n8n explica qué cambia esa elección en workflows largos, y el Curso n8n repasa credentials y expresiones paso a paso.

Conexión

¿Cómo conectar n8n con tu instancia de Jenkins ?

  1. 01

    Genera un token API personal en Jenkins

    Abre el perfil del usuario en cuyo nombre actuará el workflow y entra en profile details, Configure, Add new token. Jenkins muestra el token una sola vez, cópialo en ese momento. El sistema de tokens se rehízo en 2018 y una instancia antigua todavía puede arrastrar tokens legacy. A partir de Jenkins 2.129, comprueba que el token creado no sea legacy: si lo es, las llamadas de n8n fallan en la autenticación.

  2. 02

    Crea el credential de Jenkins en n8n

    En n8n, entra en el menú Credentials y añade un credential de Jenkins. Hay tres valores. Jenkins Username es el usuario al que pertenece el token, no un nombre para mostrar. Personal API Token es el valor que acabas de copiar. Jenkins Instance URL es la URL base de la instancia a la que llamará n8n. Un credential se crea una vez y se reutiliza en todos los workflows, así que un segundo nodo Jenkins lo encuentra en su lista desplegable.

  3. 03

    Apunta el nodo a un job y ejecútalo una vez

    Añade el nodo Jenkins, elige el recurso y la operación, y fíjate en Job Name or ID. Es una lista desplegable que se llena desde tu instancia, o sea una prueba de conexión gratis: si aparecen los jobs, el credential funciona. También puedes salir de la lista y pasar una expresión como {{ $json.job }} cuando el nombre del job viene del nodo anterior. Ejecuta el nodo una vez antes de cablear el resto.

Acciones

Lo que hace el nodo Jenkins , operación por operación

El nodo Jenkins expone 11 operaciones en 3 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGet ManyCancel Quiet DownCopyShutdownQuiet DownRestartSafely ShutdownSafely RestartTriggerTrigger with Parameters
Build✓
Instance✓✓✓✓✓✓
Job✓✓✓✓

Build

1 operación
01

Get many builds

build.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve el historial de builds de un job, con los datos que Jenkins guarda de cada uno. Es la operación de lectura del nodo, la que se pone delante de un informe.

Parámetros clave

  • Job Name or ID: el job del que quieres los builds, elegido en la lista que se carga desde tu instancia o pasado como expresión del tipo {{ $json.job }} cuando viene del nodo anterior.
  • Return All: activado, n8n encadena las páginas y trae todo el historial; desactivado, se detiene en Limit, que fija el número máximo de builds devueltos.
Casos de uso
el resumen del lunes sobre los builds del job de release, o un control que revisa los últimos antes de lanzar otro.

Instance

6 operaciones
02

Cancel Quiet Down an instance

instance.cancelQuietDown

Lo que ves en n8n

Notas y casos de uso

Levanta el modo silencioso y deja que Jenkins vuelva a aceptar builds. Es la contraparte de la operación que activa ese modo y no pide ningún parámetro: el nodo actúa sobre la instancia del credential elegido y no hay nada más que rellenar.

Casos de uso
una ventana de mantenimiento que termina antes de lo previsto, o que se cancela. El workflow llama a esta operación y la cola de builds vuelve a moverse sin que nadie abra la interfaz de Jenkins. Con un Schedule Trigger detrás, la instancia nunca se queda callada más tiempo del reservado.
03

Quiet Down an instance

instance.quietDown

Lo que ves en n8n

Notas y casos de uso

Pone Jenkins en modo silencioso: no arranca ningún build nuevo, los que están en marcha llegan al final y la instancia queda lista para apagarse. Nada es obligatorio, así que funciona como un paso de un clic dentro de un workflow más largo.

Parámetros clave

  • Reason: texto libre con el motivo del modo silencioso. Jenkins se lo enseña a quien mire la instancia, así que una línea con el número del ticket de cambio ahorra preguntas.
Casos de uso
la apertura de una secuencia de mantenimiento, unos minutos antes de actualizar un plugin o reiniciar la máquina.
04

Restart an instance

instance.restart

Lo que ves en n8n

Notas y casos de uso

Reinicia Jenkins de inmediato, en los entornos donde eso es posible. La palabra clave es inmediato: lo que esté compilando en ese instante no llega al final. Sin parámetros, la operación se aplica a la instancia del credential.

Casos de uso
una instancia que ya no responde bien y hay que levantar rápido, o el último paso de un workflow de recuperación que ya comprobó que no corre nada importante. Cuando los builds tienen que terminar, la variante segura es la que toca.
05

Safely Restart an instance

instance.safeRestart

Lo que ves en n8n

Notas y casos de uso

Pide a Jenkins que se reinicie cuando ya no quede ningún job corriendo. Jenkins espera a que la cola se vacíe en lugar de cortar por lo sano, y ahí está la diferencia con la versión inmediata. Tampoco hay nada que configurar.

Casos de uso
el reinicio que se programa al final del día y se olvida. El workflow llama a la operación, Jenkins aguanta hasta el último build y la instancia vuelve sola. Vale en entornos donde reiniciar es posible.
06

Safely Shutdown an instance

instance.safeExit

Lo que ves en n8n

Notas y casos de uso

Apaga Jenkins cuando ya no corre ningún job. Misma paciencia que el reinicio seguro, con una diferencia: la instancia no vuelve por su cuenta, hace falta algo fuera de Jenkins para arrancarla otra vez. La operación no pide parámetros.

Casos de uso
liberar una máquina de compilación al cerrar un sprint, o parar una instancia antes de mover el servidor que la aloja. Ponla después de un paso de modo silencioso para que nada nuevo entre en la cola mientras terminan los últimos builds.
07

Shutdown an instance

instance.exit

Lo que ves en n8n

Notas y casos de uso

Corta Jenkins al momento, sin esperar a los jobs en marcha. Los builds en curso se interrumpen donde estén, lo cual a veces es justo lo que quieres y a veces una sorpresa desagradable. No hay ningún campo que rellenar, el credential decide a qué instancia apunta.

Casos de uso
una parada de emergencia disparada desde una alerta, por ejemplo un workflow que recibe una señal de monitorización y baja la instancia antes de que empeore la cosa. Para lo planificado, la variante segura cuesta unos minutos y salva los builds en curso.

Job

4 operaciones
08

Copy a job

job.copy

Lo que ves en n8n

Notas y casos de uso

Duplica un job existente con un nombre nuevo y conserva la configuración del original. Más rápido que rehacer una configuración a mano cuando el job de origen ya se parece a lo que buscas.

Parámetros clave

  • Job Name or ID: el job que se copia, elegido en la lista cargada desde tu instancia o indicado con una expresión.
  • New Job Name: el nombre del job que creará Jenkins. Tiene que estar libre en la instancia, así que constrúyelo con datos del flujo, por ejemplo el nombre de la rama que lleva el item.
Casos de uso
montar un pipeline por rama a partir de un job de referencia en cuanto aparece una rama nueva.
09

Create a job

job.create

Lo que ves en n8n

Notas y casos de uso

Crea un job desde cero en la instancia, a partir del XML de configuración que espera Jenkins. El workflow tiene que llevar ese XML, así que decide de dónde sale antes de cablear el nodo.

Parámetros clave

  • New Job Name: el nombre del job que se creará en la instancia.
  • XML: el XML de configuración de Jenkins que define el job. Casi siempre una expresión que apunta a una plantilla guardada en un nodo anterior, con las partes variables sustituidas en el flujo.
Casos de uso
preparar el job de integración continua de un servicio nuevo en el mismo momento en que se crea su repositorio, para que nadie tenga que acordarse después.
10

Trigger a job

job.trigger

Lo que ves en n8n

Notas y casos de uso

Lanza un build del job elegido, en su versión sencilla, sin parámetros de compilación. La que se usa cuando el job ya sabe qué hacer por su cuenta.

Parámetros clave

  • Job Name or ID: el job que se lanza, tomado de la lista que n8n rellena desde tu instancia o definido con una expresión como {{ $json.jobName }} cuando el nombre viaja con el item.
Casos de uso
un job nocturno arrancado por un Schedule Trigger, o un job de despliegue lanzado tras un paso de aprobación, con las condiciones viviendo en el workflow y no en Jenkins.
11

Trigger a job with parameters

job.triggerParams

Lo que ves en n8n

Notas y casos de uso

Lanza un build pasándole parámetros, que es como un solo job cubre varios casos en lugar de clonarse.

Parámetros clave

  • Job Name or ID: el job parametrizado que se lanza, desde la lista o con una expresión.
  • Parameters: los parámetros que recibe el job, añadidos uno a uno con Add Parameter. Los nombres deben coincidir con los que declara el job y los valores pueden venir del flujo.
Casos de uso
un único job de despliegue gobernado por un entorno y un número de versión, ambos leídos del item que arrancó el workflow.
Necesitas ayuda

¿Necesitas ayuda para automatizar Jenkins con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Jenkins y n8n, las dudas que vienen después

01¿La integración Jenkins n8n es gratuita?
Sí por el lado de n8n. El nodo Jenkins viene incluido con n8n, no hay nada que instalar ni coste extra para desbloquearlo, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition bajo licencia Sustainable Use. Las 11 operaciones y los 3 recursos están disponibles en ambos casos, y un workflow construido en uno funciona igual en el otro sin tocar nada. Lo que cuesta tu instancia de Jenkins es otro asunto, depende de cómo la alojes y esta página no lo trata.
02¿Qué credenciales hacen falta para Jenkins en n8n?
Un token API. El credential de Jenkins en n8n pide tres valores: el Jenkins Username, es decir el usuario al que pertenece el token, un Personal API Token generado desde profile details, Configure, Add new token en ese mismo usuario, y la Jenkins Instance URL a la que llamará n8n. Como el token va atado a un usuario, el nodo puede hacer exactamente lo que ese usuario puede hacer en Jenkins, así que elige bien la cuenta. El sistema de tokens se rehízo en 2018: en una instancia antigua, usa un token que no sea legacy.
03¿Qué límites tiene el nodo Jenkins en n8n?
Dos que conviene tener claros. La lectura de builds va paginada: Get many builds trae el historial completo solo con Return All activado, si no se para en Limit, y un export que parece corto casi siempre viene de ahí. Además, el nodo cubre un perímetro definido, 11 operaciones sobre los recursos Build, Instance y Job. Para un endpoint de la API Remote Access de Jenkins que quede fuera, el nodo HTTP Request lo llama directamente reutilizando el mismo credential con la autenticación predefinida, sin salir del workflow.
04¿Puede n8n reaccionar a un build de Jenkins en tiempo real?
Desde Jenkins no, porque Jenkins no tiene nodo trigger en n8n. Cualquier workflow que toque Jenkins arranca en otro punto. Tres entradas habituales: un Schedule Trigger que se ejecuta a intervalo fijo y revisa los builds con Get many builds, un Webhook de n8n, o sea una URL que n8n expone y a la que llama un servicio externo cuando pasa algo, o el trigger de otra herramienta que ya esté en el flujo. El nodo Jenkins actúa luego dentro de ese workflow.
05¿n8n o Make para Jenkins?
Depende de dónde tenga que vivir la automatización. Make lo aloja Make, sin opción de autoalojamiento, y se factura por operación: un workflow que consulta a menudo el historial de builds sube de coste con cada control. n8n corre en Cloud o en tu propia máquina, algo que pesa cuando la instancia de Jenkins está en una red privada inaccesible desde fuera. Los dos montan workflows de forma visual. Mira el alojamiento, el control de los datos, el modelo de coste y la soltura del equipo con las expresiones.