Conecta tu servidor Jenkins

BuildCaptain se conecta directamente con tu servidor Jenkins — sin intermediarios, sin cuenta en la nube. Necesitas tres cosas: la URL del servidor, tu nombre de usuario y un token de API.

1. Crea un token de API en Jenkins

En Jenkins, haz clic en tu nombre (arriba a la derecha) → Security (o Configure en versiones antiguas) → API Token → Add new token. Ponle un nombre como "BuildCaptain" y copia el valor generado — Jenkins solo lo muestra una vez.

Usa un token de API, no tu contraseña. Los tokens se pueden revocar individualmente y funcionan con configuraciones de single sign-on.

La versión larga — limitar los tokens a un usuario de servicio, rotarlos y revocar uno filtrado — está en nuestra guía Jenkins API tokens: create, scope, rotate, and revoke (en inglés).

2. Introduce los datos del servidor

Abre BuildCaptain → Settings e introduce:

• Server URL — p. ej. https://jenkins.example.com/. HTTPS es obligatorio para servidores accesibles por nombre de host; BuildCaptain rechaza nombres de host con HTTP sin cifrar para proteger tu token. La única excepción: las instancias internas de Jenkins en una dirección de red privada — p. ej. http://10.0.0.5:8080/, http://192.168.1.20/ o http://localhost:8080/ — pueden usar HTTP sin cifrar, porque ese tráfico nunca atraviesa la internet pública. Requiere BuildCaptain 26.8.3 o posterior.
• Username — tu nombre de inicio de sesión en Jenkins.
• API token — el token del paso 1. Se guarda en el Keychain de macOS.

Guarda, y BuildCaptain valida la conexión al instante.

3. Comprueba el plugin

El grafo de etapas, los logs de los steps y las funciones de detener y relanzar vienen del plugin Pipeline Graph View. Si falta, las pipelines se siguen listando y ejecutando, pero la página del grafo indicará que no se encontró el endpoint — pide a tu administrador de Jenkins que lo instale.

Permisos

Tu cuenta necesita Job/Read para explorar y observar pipelines. Iniciar, detener y relanzar builds requiere además Job/Build y Job/Cancel. Si una acción falla con un error de permisos, BuildCaptain muestra la respuesta del servidor en los detalles del error.

¿Problemas?

Si la conexión falla — una página de inicio de sesión de un proxy, un problema de certificado, un 401 — consulta Solucionar problemas de conexión.