Configurar Jenkins
Estado: ⚠️ Funciona en cada pull request de Bitbucket Cloud: lee el PR, ejecuta el plan y comenta el resultado. No se dispara por label (Bitbucket no tiene labels en los PRs) y no sube una rama con los resultados: quedan como artefactos del build. Todavía no se probó de punta a punta contra un repositorio real.
Valor en qa-stack.yaml |
stack.pipeline_provider: jenkins + stack.scm_provider: bitbucket |
| Archivo | .jenkins/neo-ci-jobs/Jenkinsfile (tu Jenkinsfile propio no se toca) |
| Cómo se engancha | Un job Multibranch Pipeline de Jenkins apuntado a ese archivo |
| Cómo se dispara | En cada pull request |
| Imagen | registry.gitlab.crowdaronline.com/lippia/products/neo/crowdar-engine-mvp:latest-playwright (registry privado) |
1. Por qué Jenkins es distinto
En GitLab, GitHub y Bitbucket Pipelines, el CI y el repositorio son el mismo producto. Con Jenkins no: Jenkins ejecuta el pipeline, pero el repositorio y los pull requests viven en otro lado (por ejemplo, Bitbucket). Por eso qa-stack.yaml necesita un dato más, stack.scm_provider, que le dice al engine dónde está el PR:
crowdar event --provider jenkins -> crowdar run <plan> -> crowdar report --provider jenkins
(lee el PR de Jenkins y trae la (el plan) (comenta el resultado
descripción desde la API del SCM) en el PR del SCM)
scm_provider |
Estado |
|---|---|
bitbucket (Cloud) |
✅ Soportado |
bitbucket (Data Center / Server) |
❌ Todavía no |
github, gitlab |
❌ Todavía no: el engine avisa en vez de adivinar |
2. Qué genera lippia-neo-bootstrap-ci
Escribe siempre .jenkins/neo-ci-jobs/Jenkinsfile, exista o no un Jenkinsfile en la raíz del repositorio. A diferencia de las otras plataformas, no hay nada que fusionar: Jenkins no lee archivos por convención de carpetas, sino el que le indica cada job.
El archivo no tiene datos del proyecto: lee test_framework, scm_provider y los directorios de paths.* desde qa-stack.yaml en cada ejecución.
3. Paso a paso
Paso 1 — Completar qa-stack.yaml
lippia-neo-bootstrap-stack detecta Jenkins si el repositorio tiene un Jenkinsfile, y deduce scm_provider del remote de git. Si no puede, pregunta. Tiene que quedar así:
stack:
pipeline_provider: jenkins
scm_provider: bitbucket
Paso 2 — Generar el archivo
Generá el CI del proyecto con lippia-neo-bootstrap-ci
Commiteá .jenkins/neo-ci-jobs/Jenkinsfile.
Paso 3 — Preparar Jenkins
| Requisito | Detalle |
|---|---|
| Plugins | Pipeline, Docker Pipeline, Credentials Binding y Bitbucket Branch Source |
| Agentes | Tienen que poder ejecutar contenedores Docker (el pipeline corre dentro de la imagen del engine) |
| Red | Los agentes tienen que llegar a la API del modelo de IA, a Bitbucket y al registry de la imagen |
Paso 4 — Cargar las credenciales
En Manage Jenkins → Credentials, con estos ids exactos:
| Id | Tipo | Para qué |
|---|---|---|
bitbucket-creds |
Username with password | Leer el PR y comentar el resultado. Usuario: el e-mail de la cuenta Atlassian. Contraseña: un API token con lectura de repositorios y PRs y escritura de PRs |
crowdar-gitlab |
Username with password | Clonar crowdar-qa-skills y descargar la imagen del engine (read_repository, read_registry) |
openai-api-key |
Secret text | Los modelos que usan los planes |
app-test-creds |
Username with password | Opcional: el usuario de prueba de la app, que se escribe en .env.tests |
Paso 5 — Crear el job
- New Item → Multibranch Pipeline.
- Branch Sources → Bitbucket: el repositorio, con descubrimiento de pull requests.
- Build Configuration → Script Path:
.jenkins/neo-ci-jobs/Jenkinsfile.
El job tiene tres parámetros con valor por defecto: NEO_QA_PLAN (plans/feature-new-end-to-end.yaml), SKILLS_REF (develop) y APP_BASE_URL.
Paso 6 — Probarlo
Abrí un pull request con la referencia a la historia en la descripción (por ejemplo user-stories/US-010.md, o la URL de Jira). Jenkins lo detecta, ejecuta el plan y comenta el resultado en el PR.
4. Qué ejecuta
| Stage | Qué hace |
|---|---|
Leer qa-stack.yaml |
Lee el framework, el SCM y los directorios. Se detiene si falta scm_provider |
Evento |
crowdar event --provider jenkins → input.json |
Setup |
Clona las skills, instala las dependencias del framework y escribe .env.tests |
Correr el plan |
crowdar run, guardando el código de salida en lugar de cortar |
| Al final, siempre | Comenta en el PR, archiva input.json, result.json y los directorios de paths.*, y recién ahí marca el build en rojo si el plan falló |
5. Problemas comunes (y qué hacer)
| Lo que ves | Por qué pasa | Qué hacer |
|---|---|---|
qa-stack.yaml no declara stack.scm_provider |
Falta el SCM en qa-stack.yaml |
Agregá scm_provider: bitbucket o volvé a ejecutar lippia-neo-bootstrap-stack |
cannot read Bitbucket PR #…: missing credentials |
La credencial bitbucket-creds no existe o tiene otro id |
Creala con ese id exacto |
| El plan dice que no encuentra la historia | La descripción del PR está vacía o no tiene una referencia válida | Poné la ruta o la URL de la historia en la descripción del PR |
| Falla al descargar la imagen | El agente no llega al registry de Crowdar o crowdar-gitlab no tiene read_registry |
Revisá la red y el token. En la red de un cliente, lo habitual es espejar la imagen en su propio registry |
reporting from Jenkins to 'github' is not supported yet |
El SCM no es Bitbucket | Hoy solo Bitbucket Cloud está soportado desde Jenkins |
| El job corre en cada PR, incluso en los que no hace falta | Bitbucket no tiene labels para filtrar | Agregá una condición por rama o por título al when de los stages |