Saltar a contenido

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

  1. New Item → Multibranch Pipeline.
  2. Branch Sources → Bitbucket: el repositorio, con descubrimiento de pull requests.
  3. 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