API de Jenkins: qué puedes hacer y cómo usarla con agentes de IA
Jenkins tiene una API remota que expone jobs, builds, cola y nodos en JSON o XML, y permite lanzar builds con parámetros. La usan equipos de ingeniería y DevOps con servidores de CI/CD propios. El acceso es con un usuario con token de API, en la URL del servidor de la empresa.
Qué ofrece la API de Jenkins
Jobs
Listado, configuración y estado de cada job y pipeline.
Builds
Historial, resultado, duración y artefactos.
Lanzamiento de builds
Ejecución de jobs, con o sin parámetros.
Logs de consola
Salida de cada build para el diagnóstico.
Cola
Builds a la espera de ejecución.
Nodos y agentes
Máquinas de ejecución y su disponibilidad.
Cómo acceder a la API de Jenkins
- Con las credenciales de tu empresaUsuario de Jenkins con un token de API generado en el perfil, enviado con autenticación básica. Los permisos siguen la estrategia de autorización configurada en el servidor.
- Los logs pueden contener secretos: el agente no debe reenviarlos.
- No expongas Jenkins a internet solo para la integración: usa un túnel o una red privada.
- Usa permisos por job en lugar de administrador.
Documentación oficial: www.jenkins.io/doc/book/using/remote-access-api
Qué hace un agente de iTeam con la API de Jenkins
Build roto explicado
El agente lee el log del build que falló, señala la etapa y el mensaje de error y avisa a quien hizo el cambio.
Test inestable
El agente identifica los tests que alternan entre pasar y fallar en las últimas ejecuciones y los lista para el equipo.
Despliegue a petición
El líder técnico pide en Teams el despliegue en preproducción y el agente lanza el job con los parámetros, tras la confirmación.
Cola atascada
El agente avisa cuando la cola crece y hay nodos sin conexión.
De la credencial al agente trabajando, con aprobación
Crea un usuario de servicio
En Jenkins, crea el usuario con permiso de lectura y de build solo en los jobs necesarios y genera el token.
Regístralo en la bóveda de iTeam
El token y la URL quedan en la bóveda, con acceso por red aprobado por TI.
Prueba con aprobación
La lectura de logs se ejecuta directamente; el lanzamiento de builds de producción pasa por aprobación humana.
Equipos de IA listos para este trabajo
Preguntas sobre la API de Jenkins
¿La API de Jenkins es gratuita?
Sí, Jenkins es software libre y la API remota viene incluida; el costo es el de la infraestructura.
¿Necesito programar para usar la API de Jenkins con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación y el equipo de implantación configura con tu equipo de DevOps.
¿Se pueden lanzar builds con parámetros?
Sí, la API remota acepta parámetros; en iTeam, esto queda bajo aprobación.
