INTEGRACIÓN JENKINS n8n: AUTOMATIZAR JENKINS CON N8N

Esta acción permite activar un job Jenkins que acepta parámetros. Es la acción más utilizada para lanzar builds de manera condicional o con valores dinámicos provenientes de otras etapas del workflow n8n.

Configuración:

• Credential to connect with: credencial Jenkins (requerido) para autenticar la conexión
• Resource: fijado a "Job" para indicar que se actúa sobre un job Jenkins
• Operation: fijado a "Trigger with Parameters"
• Job Name or ID: campo de texto para especificar el nombre exacto o el ID del job a activar (requerido). Atención: si ves un error "Error fetching options from Jenkins", verifica que tus credenciales están correctamente configuradas y que el job existe.
• Parameters: sección para añadir pares clave/valor representando los parámetros esperados por el job Jenkins. Haz clic en "Add Parameter" para cada parámetro a pasar (opcional, según la configuración de tu job)

Casos de uso típicos: Activar un build de deployment con variables como ENVIRONMENT=staging, VERSION=1.2.3, BRANCH=develop; lanzar un job de tests con parámetros dinámicos recuperados desde otro nodo (por ejemplo, lista de módulos a testear); ejecutar un pipeline de procesamiento de datos con fechas o rutas de archivos variables.

Cuándo usarlo: cada vez que tu job Jenkins espera parámetros de entrada y que quieres pasarlos dinámicamente desde n8n. Verifica bien que el job Jenkins está configurado para aceptar parámetros, sino utiliza la acción "Trigger Job" simple.

Esta acción lanza un job Jenkins sin parámetros. Más simple que "Trigger with Parameters", conviene a los jobs que no esperan ningún valor de entrada.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Job"
• Operation: "Trigger"
• Job Name or ID: campo de texto para identificar el job a activar (requerido). Como para la acción anterior, un error "Error fetching options from Jenkins" indica un problema de conexión o de acceso.

Casos de uso: Lanzar un build nocturno programado en respuesta a un evento externo (fin de sincronización de datos, webhook de otro servicio...); activar un job de limpieza, backup o mantenimiento Jenkins después de una condición detectada en n8n; iniciar un pipeline simple (build + tests) tras un evento de negocio (validación de un pedido, cierre de un sprint Jira...).

Cuándo usarlo: para todos los jobs Jenkins que no necesitan parámetros de entrada. Si tu job espera parámetros, utiliza "Trigger with Parameters" en su lugar.

Esta acción crea un nuevo job Jenkins a partir de una configuración XML proporcionada. Muy útil para provisionar automáticamente pipelines Jenkins en entornos dinámicos.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Job"
• Operation: "Create"
• New Job Name: campo de texto para definir el nombre del nuevo job (requerido)
• XML: gran campo de texto para proporcionar la configuración completa del job en formato XML (requerido). Puedes obtener este XML añadiendo config.xml a la URL de un job existente en Jenkins (por ejemplo https://jenkins.domain.com/job/my-job/config.xml).

Casos de uso: Crear automáticamente un job Jenkins para cada nuevo proyecto detectado en Jira/Trello/GitHub; duplicar rápidamente pipelines adaptando el XML template con valores dinámicos (nombre de proyecto, ramas Git, credenciales...); provisionar entornos de test/staging al vuelo con sus pipelines CI/CD dedicados.

Cuándo usarlo: cuando gestionas un gran número de jobs similares y quieres automatizar su creación en lugar de configurarlos manualmente uno por uno. Requiere dominar bien el formato XML de configuración Jenkins.

Esta acción duplica un job Jenkins existente hacia un nuevo job. Más simple que "Create Job" porque no necesitas proporcionar el XML, Jenkins copia automáticamente la configuración del job fuente.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Job"
• Operation: "Copy"
• Job Name or ID: nombre o ID del job a copiar (requerido). Si ves "Error fetching options from Jenkins", introduce manualmente el nombre del job fuente.
• New Job Name: campo de texto para nombrar el nuevo job duplicado (requerido)

Casos de uso: Crear rápidamente un job de test basado en un job de producción existente cambiando solo algunos parámetros; duplicar un template de pipeline para cada nueva rama Git o nuevo microservicio detectado; estandarizar tus pipelines copiando un job "golden template" y adaptándolo ligeramente para cada proyecto.

Cuándo usarlo: cuando tienes un job Jenkins bien configurado que quieres reutilizar como base para crear otros jobs similares. Mucho más rápido que reconfigurar manualmente o manipular XML.

Esta acción detiene completamente tu servidor Jenkins. Atención: esta operación hace Jenkins totalmente inaccesible hasta un reinicio manual (en el servidor host).

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Instance" (la operación apunta al servidor Jenkins mismo)
• Operation: "Shutdown"

Casos de uso: Automatizar la parada de Jenkins en un entorno de test/staging según un planning (ahorro de recursos); activar un shutdown controlado antes de un mantenimiento servidor planificado; apagar Jenkins en respuesta a un evento crítico detectado (alerta de seguridad, problema de recursos...).

Cuándo usarlo: únicamente en entornos no-producción o para tareas de mantenimiento planificado. Nunca usar en producción sin plan de reinicio porque Jenkins se volverá totalmente inaccesible. La disponibilidad de este comando depende de la implementación de tu instancia Jenkins.

Esta acción detiene Jenkins de manera "safe": espera que todos los builds en curso se terminen antes de cortar el servidor. Más prudente que "Shutdown" simple.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Instance"
• Operation: "Safely Shutdown"

Casos de uso: Apagar Jenkins para mantenimiento asegurándose de que ningún build sea interrumpido brutalmente; automatizar una parada limpia de Jenkins al final de una jornada de trabajo (entorno de dev); activar un shutdown safe antes de una actualización del servidor Jenkins o de sus plugins.

Cuándo usarlo: cada vez que quieras detener Jenkins preservando la integridad de los builds en curso de ejecución. Prefiere siempre esta acción a "Shutdown" simple si no quieres arriesgarte a corromper builds.

Esta acción reinicia Jenkins de manera segura: espera el fin de los builds en curso, luego reinicia el servidor automáticamente.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Instance"
• Operation: "Safely Restart"

Casos de uso: Reiniciar automáticamente Jenkins después de la instalación de plugins o una actualización de configuración; automatizar el reinicio periódico de Jenkins para liberar memoria o aplicar cambios (entorno de dev/test); activar un restart safe tras un evento externo (fin de deployment de recursos, cambio de configuración detectado...).

Cuándo usarlo: para aplicar cambios que requieren un reinicio sin interrumpir los builds en curso. Es la acción recomendada para reiniciar Jenkins de manera controlada.

Esta acción reinicia Jenkins inmediatamente sin esperar el fin de los builds en curso. Más rápido pero más arriesgado que "Safely Restart".

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Instance"
• Operation: "Restart"

Casos de uso: Forzar un reinicio inmediato de Jenkins en caso de problema grave (instancia que no responde, necesidad de reinicio urgente); automatizar un restart rápido en un entorno desechable (contenedor, entorno de test efímero).

Cuándo usarlo: solo si necesitas un reinicio inmediato y aceptas el riesgo de interrumpir los builds en curso. En la mayoría de los casos, prefiere "Safely Restart".

Esta acción pone Jenkins en modo "Quiet Down": el servidor deja de aceptar nuevos builds pero continúa ejecutando los builds en curso hasta su fin.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Instance"
• Operation: "Quiet Down"
• Reason: campo de texto opcional para indicar la razón del quiet down (útil para logging/auditoría)

Casos de uso: Preparar Jenkins para un mantenimiento: bloquear los nuevos builds dejando que los builds en curso se terminen correctamente; automatizar el paso a quiet mode antes de un backup Jenkins o una actualización planificada; poner Jenkins en pausa temporal tras una alerta (carga servidor demasiado alta, problema de recursos detectado vía Grafana...).

Cuándo usarlo: cuando quieres detener temporalmente la actividad Jenkins sin parar brutalmente el servidor. Piensa en usar "Cancel Quiet Down" después para relanzar la aceptación de nuevos builds.

Esta acción anula el modo "Quiet Down" y permite a Jenkins volver a aceptar nuevos builds.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Instance"
• Operation: "Cancel Quiet Down"

Casos de uso: Relanzar la actividad Jenkins después de un mantenimiento planificado o un backup; anular automáticamente el quiet down si las condiciones que lo activaron están resueltas (carga servidor vuelta a la normalidad, problema resuelto...); volver a poner Jenkins en modo normal tras una ventana de mantenimiento cancelada.

Cuándo usarlo: inmediatamente después de haber resuelto la razón que te llevó a poner Jenkins en quiet down. Permite retomar una actividad normal sin reiniciar el servidor.

Esta acción recupera la lista de los builds de un job Jenkins dado. Muy útil para monitorear, analizar o reaccionar al estado de los builds.

Parámetros clave:

• Credential to connect with: credencial Jenkins (requerido)
• Resource: "Build"
• Operation: "Get Many"
• Job Name or ID: nombre o ID del job del cual quieres recuperar los builds (requerido). Si ves "Error fetching options from Jenkins", verifica tus credenciales y permisos.
• Return All: interruptor on/off. Activado = recuperar todos los builds sin límite. Desactivado = limitar el número de resultados (por defecto).
• Limit: campo numérico para definir el número máximo de builds a retornar (activo solo si "Return All" está desactivado). Aquí fijado a 50 por defecto.

Casos de uso: Recuperar los 10 últimos builds de un job para analizar su estado (SUCCESS, FAILURE, ABORTED...) y enviar una alerta si se detectan fallos; monitorear periódicamente (cada hora, cada mañana...) el estado de los builds críticos y generar informes o dashboards; integrar los datos de builds Jenkins en una herramienta de BI, una base de datos o un sistema de tickets (crear automáticamente un ticket Jira si un build falla).

Cuándo usarlo: cada vez que necesitas información sobre los builds pasados de un job Jenkins para tomar decisiones, alertar, o sincronizar datos con otras herramientas.