Solucionar problemas de conexión

Cuando la conexión se rompe, BuildCaptain muestra un aviso naranja en la barra lateral con el motivo, junto con botones de reintentar y de ajustes. Los errores del servidor abren un diálogo con un resumen en lenguaje claro — despliega "What the server sent" para ver la respuesta en bruto y usa Copy Details al informar de un problema.

"The Jenkins URL is invalid" / HTTP rechazado

BuildCaptain acepta URLs https://, y también — desde BuildCaptain 26.8.3 — http:// sin cifrar solo para direcciones de red privadas — IPs como 10.x.x.x, 172.16–31.x.x, 192.168.x.x y localhost. Esto cubre las instancias internas de Jenkins cuyo tráfico nunca sale de tu LAN o VPN. Un nombre de host con HTTP sin cifrar (p. ej. http://jenkins.example.com/) se rechaza a propósito, porque expondría tu token de API en tránsito — en ese caso, conéctate mediante la IP privada del servidor o, mejor, pon Jenkins detrás de un proxy inverso que termine TLS.

Un proxy o una página de inicio de sesión se interpone

Si el servidor responde con algo que no es Jenkins — Cloudflare Access, un portal de VPN, una página de SSO corporativa — BuildCaptain indica que un proxy o una página de inicio de sesión puede estar interceptando la solicitud y muestra la respuesta que recibió. Asegúrate de que las solicitudes a la API de tu host de Jenkins eviten el inicio de sesión interactivo (p. ej. cabeceras de token de servicio en el proxy, o conéctate primero a la VPN).

401 — token rechazado

El par usuario/token es incorrecto o el token fue revocado. Crea un token de API nuevo en Jenkins (tu nombre → Security → API Token) y vuelve a introducirlo en los ajustes. Nota: usa el token, no la contraseña de tu cuenta.

403 — sin permiso

A tu cuenta le falta un permiso para esa acción — leer requiere Job/Read; ejecutar/detener/relanzar requieren Job/Build y Job/Cancel. El mensaje del servidor está en los detalles del error.

404 en el grafo — falta el plugin

Si las pipelines se listan bien pero la vista de etapas indica que falta un endpoint, el plugin Pipeline Graph View no está instalado en Jenkins.

"Inicia sesión de nuevo" tras una actualización

Si BuildCaptain indica que no se pudo encontrar el token de API guardado, abre los ajustes y vuelve a introducirlo — el campo del token es lo único que tienes que rellenar; el servidor y el usuario se recuerdan.

¿Sigues atascado?

La página Logs registra cada solicitud con su código de estado (los tokens y los cuerpos de las respuestas nunca se registran). Cópialo y envíanoslo.